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.nomedescrizione
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:

  1. può essere la classe del dto associata al DataAccessObject
  2. può essere un array ([]) di oggetti che hanno come tipo la classe del dto associata al DataAccessObject
  3. 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.

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.

codfeature datagen
2.0.0
standard
FNDCUST001select by custom code
FNDCUST002read main table columns
FNDCUST003read resolved lookup
FNDCUST004select distinct
FNDCUST005structured query definition
FNDCUST006result order