torna all'elenco degli elementi della sezione finders

# Elemento di catalogo: CustomFinder

## Descrizione

Mediante questa operazione di ricerca è possibile effettuare query anche complesse che hanno come risultato uno o più record. A seconda dei casi è possibile ottenere risultati che coinvolgono anche altre tabelle oltre a quella principale definita nel DataAccessObject.

## Caratteristiche (features)

cod. | nome | descrizione
FNDCUST001 | select by custom code | La modalità base di utilizzo del CustomFinder prevede la possibilità di definire in java: la clausola where della query il popolamento dei segnaposto con i calori contenuti nel parametro di input Il parametro di input è unico e può assumere una delle seguenti forme: può essere la classe del dto associata al DataAccessObject può essere un array ([]) di oggetti che hanno come tipo la classe del dto associata al DataAccessObject può essere una classe java qualsiasi (il cui full qualified name deve essere fornito dall'utente)
FNDCUST002 | read main table columns | Il risultato della operazione contiene tutte le colonne della tabella principale associata al DataAccessObject, a meno che non venga utilizzata la funzione di LookupResolver (v.)
FNDCUST003 | read resolved lookup | A fronte della presenza nel DataAccessObject di un LookupResolver, il risultato della operazione contiene il DTO di lookup invece che le colonne corrispondenti alla ForeignKey. Il nome della property è derivato dall'attributo name del LookupResolver.
FNDCUST004 | select distinct | Permette di effettuare una selezione di record coerentemente con la sintassi select distinct del linguaggio SQL. E' possibile indicare una o più colonne. Il risultato della query sarà tale che: in ciascun DTO saranno valorizzati soltanto i campi corrispondenti alle colonne incluse nella clausola distinct nella lista dei risultati ogni distinta n-upla di valori distinti sarà contenuta una sola volta
FNDCUST005 | structured query definition | Tramite il costrutto QueryDef è possibile modellare la query relaizzata dal CustomFinder. QueryDef
FNDCUST006 | result order | E' possibile specificare un eventuale criterio di ordinamento dei risultati secondo le modalità del costrutto ORDER BY di SQL

## Grado di implementazione delle varie caratteristiche

Nella tabella seguente è riportato il grado di implementazione delle varie caratteristiche/funzioni dell'elemento CustomFinder nelle differenti implementazioni.

cod | feature | datagen
--- | --- | ---
2.0.0
standard
FNDCUST001 | select by custom code |
FNDCUST002 | read main table columns |
FNDCUST003 | read resolved lookup |
FNDCUST004 | select distinct |
FNDCUST005 | structured query definition |
FNDCUST006 | result order |