Corso Java Lezione 5 JDBC API panoramica JDBC

Corso Java : Lezione 5 JDBC API : panoramica JDBC API : uso nel codice

JDBC API : che cosa è ? La JDBC API è una Java API che permette di accedere a qualsiasi tipo di dato in forma “tabellare”, con particolare attenzione ai dati registrati in un database relazionale. La JDBC API è utile per scrivere programmi java che gestiscono queste tre attività : Connessione ad una sorgente di dati ( ad esempio un database ) Far processare delle query e degli statements di update al database Recuperare e processare i risultati ottenuti dal database in risposta a delle query

Esempio Connection con = Driver. Manager. get. Connection ( "jdbc: my. Driver: wombat", "my. Login", "my. Password“ ); Statement stmt = con. create. Statement(); Result. Set rs = stmt. execute. Query("SELECT a, b, c FROM Table 1"); while (rs. next()) { int x = rs. get. Int("a"); String s = rs. get. String("b"); float f = rs. get. Float("c"); } Questa porzione di codice : Istanzia un oggetto Driver. Manager Realizza una connessione ad un database Fà un login Istanzia un oggetto Statement Manda uno statement SQL al database Istanzia un oggetto Result. Set Analizza la risposta del database

Componenti JDBC API La API JDBC™ permette l’accesso ai dati ( relazionali ) utilizzando il linguaggio Java™. Usando la API JDBC, le applicazioni possono eseguire statements SQL, recuperare i risultati e propagare le modifiche “indietro” alla sorgente dei dati. La API JDBC può interagire simultaneamente con sorgenti di dati multiple ed eterogenee. La API JDBC è parte della piattaforma Java platform( sia Java™ Standard Edition che Java™ Enterprise Edition). La API JDBC 4. 0 è divisa in due packages: java. sql and javax. sql. Entrambi i packages sono inclusi sia in Java SE che in Java EE. JDBC Driver. Manager JDBC Test Suit La classe Driver. Manager definisce gli oggetti che possono connettere una applcazione Java ad un driver JDBC. Driver. Manager è tradizionalmente la classe su cui si appoggia l’architettura JDBC. I pacchetti standard di estensione javax. naming e javax. sql permettono l’utilizzo di un oggetto Data. Source registrato all’interno di una Java Naming and Directory Interface™ (JNDI). Si possono usare sia i meccanismi di connessione diretta che indiretta, ma la connessione attraverso un oggetto Data. Source è da preferirsi ogni volta che sia possibile La JDBC driver test suite permette di determinare quali driver JDBC la nostra applicazione andrà ad usare. Questi test non sono esaustivi, tuttavia riescono a testare molte delle funzioni offerte dalla API JDBC-ODBC Bridge Il brigde software permetter un accesso di tipo JDBC attraverso i drivers ODBC. Notare che bisogna caricare i binari del driver ODBC su ogni macchina client della nostra applicazione : l’uso di questi bridge è consigliabile sono in ambiente corporate ( dove l’aggiornamento delle macchine non è normalmente un problema ) o in una applicazione che hanno una architettura “three tier”.

Architettura La api JDBC supporta sia l’architettura 2 -tier che la 3 -tier 2 -tier Nell’architettura 2 -tier l’applicazione parla direttamente con il datasource : questo richiede che ci sia un driver JDBC specializzato per il datasource che si accede. I comandi inviati dall’applicazione vengono instradati dal datasource così come le risposte. Il driver può trovarsi in un server diverso a cui il client accede attraverso dei protocolli di rete

Architettura La api JDBC supporta sia l’architettura 2 -tier che la 3 -tier Nell’architettura 3 -tier i comandi vengono inviati ad un “middle tier server” che si occupa di instradare i comandi al datasource che restituisce i risultati al middle tier che li restituisce al client. Questo tipo di architettura permette di semplificare lo sviluppo delle applicazioni lasciando che la parte di “sicurezza” e di gestione delle connessioni sia gestita dal middle tier

Stabilire una connessione Tipicamente, una applicazione che fà uso della JDB API usa Driver. Manager : l’applicazione carica direttamente il driver JDBC usando una URL scritta all’interno dell’applicazione, la classe Driver. Manager tenta di caricare i le classe dei driver che sono referenziate nella proprietò di sistema jdbc. drivers Data. Source : l’applicazione usa questa interfaccia per richiedere l’oggetto ad un name service provider. Questo permette all’applicazione di disinteressarsi dettagli della connessione ( driver, username, password, settaggi del driver … ) Per poter stabilire una connessione c’è bisogno di compiere due passi : Caricare il driver Stabilire la connessione

Stabilire una connessione Caricare il driver Il caricamento del driver è, fondamentalmente, un’operazione da una riga di codice; la classe che rappresenta il driver viene instanziata e questa viene registrata all’interno della lista dei drivers disponibili nella VM Class. for. Name("org. apache. derby. jdbc. Embedded. Driver"); Si richiede esplicitamente al class loader di caricare una classe passandogli il riferimento completo <package>. <class name>

Stabilire una connessione Uso di Driver. Manager La classe lavora in congiunzione con l’interfaccia Driver : legge l’url, riconosce il “subprotocol” e tenta di trovare un driver, disponibile tra i drivers caricati, adatto a gestire quel protocollo. Una volta caricato il driver, si usa il metodo get. Connection per recuperare la connessione al database Connection conn = Driver. Manager. get. Connection(<URL>); L’url è una stringa composta da : protocollo: sotto-protocollo: database-name[lista di proprietà] protocollo : nel nostro caso jdbc sotto-protocollo : è il “nome” con cui viene registrato il driver JDBC nome-database : nome del database a cui connettersi [lista di proprietà] : lista di proprietà della connessione Es : jdbc: derby: COFFEES jdbc: oracle: thin: LILLY_IT_USER/AEC 07 D@yosn 64. ema. lilly. com: 1521: DEV 165

Stabilire una connessione Uso di Driver. Manager Il metodo get. Connection supporta anche il passaggio di username e password. String url = "jdbc: derby: Fred"; Connection con = Driver. Manager. get. Connection(url, “utente", “password"); Se l’url viene riconosciuta, la classe Driver. Manager si occupa di gestire tutti i dettagli della connessione e restituisce una connessione aperta al database da cui è possibile creare statements, stored procedures recuperare dati etc.

Stabilire una connessione Uso di Data. Source : L’uso della classe Data. Source aumenta le capacità di portabilità di una applicazione rendendo possibile l’uso di un nome logico piuttosto che definire I dettagli della connessione Initial. Context ic = new Initial. Context() ; Data. Source ds = ic. lookup("java: comp/env/jdbc/my. DB"); Connection con = ds. get. Connection(); Oppure, per riflettere le stesse caratteristiche di Driver. Manager Initial. Context ic = new Initial. Context() ; Data. Source ds = (Data. Source) org. apache. derby. jdbc. Client. Data. Source(); ds. set. Port(1527); ds. set. Host("localhost"); ds. set. User("APP"); ds. set. Password("APP"); Connection con = ds. get. Connection();

Recuperare i valori Il risultato di una query SQL è, normalmente, una tabella. L’ API JDBC mette a disposizione una interfaccia , Result. Set, che serve a scorrere e a recuperare i valori ritornati dal database Esistono tre tipi di Result. Set : TYPE_FORWARD_ONLY : il Result. Set non è modificabile e lo si può scorrere solo in avanti, da “prima della prima riga” a “dopo l’ultima riga”. Il contenuto del Result. Set dipende dal modo in cui I dati vengono generati dal database : snapshot al momento della select o valore al momento della fetch TYPE_SCROLL_INSENSITIVE : il Result. Set è scrollabile in avanti e indietro di una posizione rispetto alla riga corrente ed è permesso il posizionamento ad una posizione assoluta TYPE_SCROLL_SENSITIVE : il Result. Set è scrollabile in avanti e indietro di una posizione rispetto alla riga corrente ed è permesso il posizionamento ad una posizione assoluta. In aggiunta, il Result. Set è sensibile al cambiamento dei dati fatti in un altra sessione … ma bisogna rileggere il record

Recuperare i valori Esempio Statement stmt = con. create. Statement( Result. Set. TYPE_SCROLL_SENSITIVE, Result. Set. CONCUR_READ_ONLY ); Result. Set srs = stmt. execute. Query( "SELECT COF_NAME, PRICE FROM COFFEES ");

Recuperare i valori I metodi di Result. Set per il posizionamento: next() – muove il cursore avanti di una riga. Ritorna true se si posiziona su una riga o false se si posiziona dopo l’ultima riga previous() - muove il cursore indietro di una riga. Ritorna true se si posiziona su una riga o false se si posiziona prima della prima riga. first() – posiziona il cursore sulla prima riga. Ritorna true se il cursore è sulla prima riga, false se il Result. Set non contiene righe last() – posiziona il cursore sull’ultima riga. Ritorna true se il cursore è posizionato sull’utlima riga, false se il Result. Set non contiene righe before. First() – posiziona il cursore all’inizio del Result. Set, prima della prima riga. Se il Result. Set è vuoto il metodo non ha effetto. after. Last() - posiziona il cursore alla fine del Result. Set, dopo l’ultima riga. Se il Result. Set è vuoto il metodo non ha effetto. relative(int rows) – muove il cursore di n righe, relativamente alla posizione corrente absolute(int row) – muove il cursore alla row-esima riga.

Recuperare i valori Esempi Sia srs un Result. Set con 500 righe srs. absolute(-4); // posiziona alla riga 497 srs. absolute(4); // posiziona alla riga 4 srs. relative(-3); // posiziona alla riga 1 srs. relative(2); // posiziona alla riga 3 srs. absolute(4); int row. Num = srs. get. Row(); // row. Num = 4 srs. relative(-3); int row. Num = srs. get. Row(); // row. Num = 1 srs. relative(2); int row. Num = srs. get. Row(); // row. Num = 3

Recuperare i valori Esistono altri quattro metodi per verificare le posizioni “chiave” di un cursore : is. First is. Last is. Before. First is. After. Last Normalmente vengono utilizzati all’interno di loop

Recuperare i valori I metodi di Result. Set per la lettura: L’interfaccia Result. Set dichiara i “getters” ( get. Int, get. Boolean, get. Object … ) Le colonne si leggono : Per nome Per posizione ( comincia da 1 ) Se due colonne o più colonne hanno lo stesso nome viene letto il valore della colonna “più a sinistra” Per una maggiore portabilità, non leggere mai la colonna due volte

Recuperare i valori Esempio : Statement stmt = con. create. Statement( Result. Set. TYPE_SCROLL_SENSITIVE, Result. Set. CONCUR_READ_ONLY ); Result. Set srs = stmt. execute. Query( "SELECT COF_NAME, PRICE FROM COFFEES“ ); while (srs. next()) { String name = srs. get. String("COF_NAME"); float price = srs. get. Float("PRICE"); System. out. println(name + " " + price); }

Recuperare i valori Esempio : Statement stmt = con. create. Statement( Result. Set. TYPE_SCROLL_INSENSITIVE, Result. Set. CONCUR_READ_ONLY ); Result. Set srs = stmt. execute. Query( "SELECT COF_NAME, PRICE FROM COFFEES“ ); srs. after. Last(); while (srs. previous()) { String name = srs. get. String("COF_NAME"); float price = srs. get. Float("PRICE"); System. out. println(name + " " + price); }

Recuperare i valori Esempio reale: try { Vector results = new Vector(); Connection con = Driver. Manager. get. Connection(url, "my. Login", "my. Password"); Statement stmt = con. create. Statement(); Result. Set rs = stmt. execute. Query(query); while (rs. next()) { String s = rs. get. String("COF_NAME"); float f = rs. get. Float("PRICE"); String text = s + " " + f; results. add. Element(text); } stmt. close(); con. close(); set. Results(results); } catch(SQLException ex) { set. Error("SQLException: " + ex); }

Aggiornare i valori Result. Set : Set + Update Statement stmt = conn. create. Statement( Result. Set. TYPE_FORWARD_ONLY, Result. Set. CONCUR_UPDATABLE ); Result. Set srs = stmt. execute. Query( "select COF_Name from COFFEES where price = 7. 99“ ); … srs. next(); srs. update. String("COF_NAME", "Foldgers"); srs. update. Row(); Aggiorna una riga alla volta Il metodo cancel. Updates() cancella tutte le update fatte a partire dall’ultimo update. Row();

Prepared. Statements Sono oggetti Statement (subclasses) che vengono precompilati dal database ( = + veloci ) Sono molto utili quando vengono parametrizzati ed usati all’interno di un loop Si creano allo stesso modo di Statement: Prepared. Statement update. Sales = con. prepare. Statement( "UPDATE COFFEES SET SALES = ? WHERE COF_NAME LIKE ? “ ); I valori vengono passati utilizzando I setter appropriati : set. XXX(posizione, valore) ; update. Sales. set. Int(1, 75); update. Sales. set. String(2, "Colombian"); update. Sales. execute. Update(); Lo statement, compilato, precedente è equivalente a stmt. execute. Update( "UPDATE COFFEES SET SALES = 75 WHERE COF_NAME LIKE 'Colombian'“ );

Prepared. Statements Ma in un loop l’uso di Prepared. Statement rende il compito + semplice : Prepared. Statement update. Sales; String update. String = "update COFFEES " + "set SALES = ? where COF_NAME like ? "; update. Sales = con. prepare. Statement(update. String); int [] sales. For. Week = {175, 150, 60, 155, 90}; String [] coffees = {"Colombian", "French_Roast", "Espresso", "Colombian_Decaf", "French_Roast_Decaf"}; int len = coffees. length; for(int i = 0; i < len; i++) { update. Sales. set. Int(1, sales. For. Week[i]); update. Sales. set. String(2, coffees[i]); update. Sales. execute. Update(); }

Transazioni L’API JDBC supporta le transazioni : Per default c’è l’autocommit : ad ogni update o delete viene fatta la commit Si abilita/disabilita l’autocommit con set. Auto. Commit(boolean valore) Esistono i metodi commit() e rollback() per chiudere o cancellare una transazione Dalla versione 3 della JDBC API esistono i “savepoints” : All’interno di una transazione posso avere delle “mini” transazioni Statement stmt = conn. create. Statement(); int rows = stmt. execute. Update("INSERT INTO TAB 1 (COL 1) VALUES (? FIRST? )"); // set savepoint Savepoint svpt 1 = conn. set. Savepoint("SAVEPOINT_1"); rows = stmt. execute. Update("INSERT INTO TAB 1 (COL 1) " + "VALUES (? SECOND? )"); . . . conn. rollback(svpt 1); . . . conn. commit(); Viene inserita una riga, settato un savepoint ( svp 1 ) e inserita una riga. La rollback arriva fino a svp 1 e la commit chiude la transazione inserendo la riga 1 Quando si rilascia un savepoint, il suo utilizzo lancia una SQLException

Stored Procedures L’API JDBC supporta le stored procedures Si può creare una stored procedure usando uno statement SQL. Le stored procedures si usano tramite gli oggetti “Callable. Statements” String create. Procedure = "create procedure SHOW_SUPPLIERS as " + "select SUPPLIERS. SUP_NAME, COFFEES. COF_NAME " + "from SUPPLIERS, COFFEES where SUPPLIERS. SUP_ID = COFFEES. SUP_ID " + "order by SUP_NAME"; Statement stmt = con. create. Statement(); stmt. execute. Update(create. Procedure); Callable. Statement cs = con. prepare. Call("{call SHOW_SUPPLIERS}"); Result. Set rs = cs. execute. Query();