Patterns
Il valore aggiunto della libreria jdbc-utils
stà nel fatto di
offrire allo sviluppatore la possibilità di costruire statement SQL parametrizzati e che nello stesso
momento siano human-readable, sia per una questione di chiarezza del codice, sia per un debugging più rapido.
Il processo di parametrizzazione avviene attraverso la definizione, all'interno dello statement, di alcune proprietà
che hanno una sintassi del tipo ${property}
.
Ogni proprietà deve matchare con un pattern della forma ${propertyname,sqlType,defaultValue}
, dove:
propertyname
rappresenta il valore della chiave dell'oggetto presente all'interno dell'oggetto che implementajava.util.Map
che verrà usato per formattare la query;sqlType
rappresenta il tipo sql di destinazione sul database;defaultValue
rappresenta il valore di default che la proprietà assume se il valore all'interno dell'oggetto che implementajava.util.Map
usato per formattare la query (o lajava.util.Map
stessa) dovesse esserenull
.
I valori che possono essere assunti da sqlType
sono prefissati ed equivalgono ai tipi SQL
definiti in java.sql.Types
, ovvero:
bit (oppure BIT)
tinyint (oppure TINYINT)
smallint (oppure SMALLINT)
integer (oppure INTEGER)
bigint (oppure BIGINT)
float (oppure FLOAT)
real (oppure REAL)
double (oppure DOUBLE)
numeric (oppure NUMERIC)
decimal (oppure DECIMAL)
char (oppure CHAR)
varchar (oppure VARCHAR)
longvarchar (oppure LONGVARCHAR)
date (oppure DATE)
time (oppure TIME)
timestamp (oppure TIMESTAMP)
binary (oppure BINARY)
varbinary (oppure VARBINARY)
longvarbinary (oppure LONGVARBINARY)
null (oppure NULL)
other (oppure OTHER)
java_object (oppure JAVA_OBJECT)
distinct (oppure DISTINCT)
struct (oppure STRUCT)
array (oppure ARRAY)
blob (oppure BLOB)
clob (oppure CLOB)
ref (oppure REF)
datalink (oppure DATALINK)
boolean (oppure BOOLEAN)