Liberamente adattato da Java dai fondamenti alla programmazione avanzata JS2E versione 1.5 di Karsten Samaschke, Apogeo editrice

Transcript

1 Liberamente adattato da Java dai fondamenti alla programmazione avanzata JS2E versione 1.5 di Karsten Samaschke, Apogeo editrice Vogliamo realizzare un'applicazione di tipo CRUD (Create, Read, Update, Delete). Queste sono infatti le funzioni più frequentemente richieste quando si lavora con tabelle di dati. Prepariamo quindi un database di prova, guestbook_db, e una tabella di prova, chiamiamola guestbook, la cui struttura è la seguente: Seguono alcuni dati di esempio: Ecco come si presenta l'interfaccia web per la gestione dei record della tabella guestbook. Pag. 1/26

2 Se vogliamo aggiungere un record usiamo il link Nuovo; inseriamo dei dati (solo due campi per semplicità, non c'è inoltre nessun tipo di controllo di validità dei dati) e premiamo sul pulsante Inserisci: Se tutto è andato a buon fine, appare un messaggio di conferma: Pag. 2/26

3 Clicchiamo su uno dei link Modifica in corrispondenza della voce che vogliamo modificare: Se tutto è Ok, appare un messaggio di conferma: Pag. 3/26

4 In maniera analoga, possiamo cancellare un record, cliccando sul link Cancella; per semplicità abbiamo omesso qualsiasi richiesta di conferma (ma che possiamo inserire mediante del codice javascript); questo significa che la cancellazione è permanente: Nello scrivere il codice di accesso al database, usiamo il cosiddetto approccio DAO, un design pattern che si rivela molto utile nella pratica corrente. Esso consiste nella: definizione delle classi che devono rappresentare i dati messa a disposizione di un'interfaccia che offre metodi per accedere ai dati implementazione dell'interfaccia nelle classi concrete messa a disposizione di una classe Factory (Factory è il nome di un altro design pattern di cui parleremo in un prossimo articolo), mediante la quale creare un'istanza della classe concreta per la selezione dei dati Questo approccio offre diversi vantaggi: nell'applicazione lavorate soltanto con l'interfaccia DAO: l'implementazione concreta rimane nascosta. Ciò significa una manutenzione più facile poiché la classe di accesso ai dati concreti può essere modificata senza che il codice applicativo debba essere rivisto gli eventuali accessi al database sono mediati da una classe centrale. Se il modello dei dati cambia (database, file di testo, file XML ecc), l'adattamento riguarderà soltanto questa classe; le chiamate ai metodi non richiederanno modifiche Il codice proposto fa uso di 4 classi di supporto e di 7 pagine jsp. Le classi di supporto sono: 1. GuestbookEntry, che rappresenta una voce nella tabella guestbook di esempio 2. GuestbookDAO, l' interfaccia che definisce i metodi per l'accesso al database 3. MySQLGuestbookDAO, una implementazione concreta di GuestbookDAO 4. GuestbookDAOFactory, la classe Factory per la creazione di istanze di GuestbookDAO Tutto ciò che occorre per connettersi al database è concentrato in una sola istruzione: GuestbookDAO gb = GuestbookDAOFactory.getInstance(); mentre i metodi per la manipolazione dei dati sono forniti dai metodi add, update, delete e Pag. 4/26

5 retrieve come evidenziato nel frammento di codice seguente: // inserimento; supponiamo l'id del record sia 192 GuestbookDAO gb = GuestbookDAOFactory.getInstance(); GuestbookEntry entry = new GuestbookEntry(); entry.setmessage("ciao ciao"); entry.setsender("maurizio"); gb.add(entry); out.println("record aggiunto "); //modifica gb = GuestbookDAOFactory.getInstance(); entry.setid(195); entry.setmessage("ancora tu"); entry.setsender("ancora tu"); gb.update(entry); out.println("record modificato "); //cancellazione gb = GuestbookDAOFactory.getInstance(); entry.setid(195); gb.delete(entry); out.println("record cancellato "); Nell'applicativo di cui presentiamo di seguito i codici sorgenti, facciamo in modo, nel momento in cui l'utente richiede una pagina, di stabilire una connessione col database, di effettuare le elaborazioni e di chiudere la connessione. Purtroppo questo approccio può andar bene fino a un certo punto perchè le operazioni di apertura e di mantenimento della connessione sono, da un punto di vista computazionale, particolarmente gravose e richiedono un certo tempo che, per siti con traffico molto sostenuto come possono essere i siti di e-commerce, può essere molto prezioso. Si potrebbe pensare di ricorrere a variabili di sessione per il mantenimento della connessione; tuttavia anche questo approccio non è quello giusto in quanto l'utente poi si ritrova a consultare magari per lungo tempo i dati forniti dal server per cui le risorse allocate per il mantenimento della sessione in questo caso sono inutili. Una soluzione di compromesso consiste nell'usare un pool di connessioni che come dice il termine consiste nel raggruppare e trattare come una singola unità un insieme di connessioni le quali vengono allocate e poi rilasciate via via come descritto meglio in seguito. La cosa interessante è che occorre fare solo qualche leggera modifica all'applicativo perchè tutto continui a funzionare egregiamente. L'unico vincolo è che l'application server supporti JNDI, un servizio ormai ampiamente diffuso in tutti i moderni application server e servlet container, come Tomcat o Application Server 9 della Sun. Ecco il codice (parzialmente commentato) delle classi: GuestbookEntry.java package mypackage; import java.util.date; Pag. 5/26

6 * Rappresenta una voce nel guestbook public class GuestbookEntry { private private private private int id = 0; String message = ""; String sender; Date created = new Date(); public int getid() { return id; public void setid(int id) { this.id = id; public String getmessage() { return message; public void setmessage(string message) { this.message = message; public String getsender() { return sender; public void setsender(string sender) { this.sender = sender; public Date getcreated() { return created; public void setcreated(date created) { this.created = created; // fine classe GuestbookEntry GuestbookDAO.java package mypackage; import java.sql.sqlexception; * Definisce i metodi per l'accesso * al database guestbook public interface GuestbookDAO { * Recupera un array di record Pag. 6/26

7 public GuestbookEntry[] retrieve() throws SQLException; * Aggiunge un record al guestbook public int add(guestbookentry entry) throws SQLException; * Aggiorna un record al guestbook public int update(guestbookentry entry) throws SQLException; * Cancella un record dal guestbook public int delete(guestbookentry entry) throws SQLException; * Recupera un record con l'id specificato public GuestbookEntry getentry(int id) throws SQLException; // fine interfaccia GuestbookDAO MySQLGuestbookDAO.java package mypackage; import java.sql.*; import java.util.arraylist; import java.util.properties; import java.io.fileinputstream; import java.io.file; import java.io.filenotfoundexception; import java.io.ioexception; import javax.naming.namingexception; * Implementazione reale di GuestbookDAO public class MySQLGuestbookDAO implements GuestbookDAO { private Connection conn; public MySQLGuestbookDAO() throws ClassNotFoundException, SQLException, NamingException { try { String classname = "com.mysql.jdbc.driver"; String connstr = "jdbc:mysql://localhost:3306/guestbook_db?user=root&password="; Class.forName(className); conn = DriverManager.getConnection(connStr); catch (ClassNotFoundException e) { throw new ClassNotFoundException("Driver non trovati"); catch (SQLException e) { throw new SQLException("Errore! Impossibile stabilire una connessione col db"); // fine costruttore Pag. 7/26

8 * Recupera un elenco di record dal guestbook public GuestbookEntry[] retrieve() throws SQLException { ArrayList<GuestbookEntry> list = new ArrayList<GuestbookEntry>(); if(conn!= null) { try { PreparedStatement stmt = conn.preparestatement( "SELECT id, message, sender, messagedate FROM guestbook ORDER BY id"); ResultSet rs = stmt.executequery(); while(rs.next()) { int id = rs.getint(1); String message = rs.getstring(2); String sender = rs.getstring(3); java.util.date d = (java.util.date)rs.getobject(4); /* if(sender == null sender.length() == 0) { sender = "mittente ignoto"; GuestbookEntry entry = new GuestbookEntry(); entry.setcreated(d); entry.setid(id); entry.setmessage(message); entry.setsender(sender); list.add(entry); conn.close(); catch (SQLException e) { throw new SQLException("Errore: "+e.getmessage()); return list.toarray(new GuestbookEntry[0]); // fine metodo retrieve * Aggiunge un record al guestbook public int add(guestbookentry entry) throws SQLException { int result = 0; if(conn!= null) { try { PreparedStatement stmt = conn.preparestatement( "INSERT INTO guestbook (message, sender, messagedate) " + "VALUES (?,?,?)"); Pag. 8/26

9 stmt.setstring(1, entry.getmessage()); stmt.setstring(2, entry.getsender()); stmt.setobject(3, entry.getcreated()); result = stmt.executeupdate(); conn.close(); catch (SQLException e) { throw new SQLException("Errore: "+e.getmessage()); return result; //fine metodo add * Aggiorna un record del guestbook public int update(guestbookentry entry) throws SQLException { int result = 0; if(conn!= null) { try { PreparedStatement stmt = conn.preparestatement( "UPDATE guestbook SET message =?, sender =?, messagedate =? " + "WHERE id =?"); stmt.setstring(1, entry.getmessage()); stmt.setstring(2, entry.getsender()); stmt.setobject(3, entry.getcreated()); stmt.setint(4, entry.getid()); result = stmt.executeupdate(); conn.close(); catch (SQLException e) { throw new SQLException("Errore: "+e.getmessage()); return result; // fine metodo update * Cancella un record dal guestbook public int delete(guestbookentry entry) throws SQLException { int result = 0; if(conn!= null) { try { PreparedStatement stmt = conn.preparestatement( "DELETE FROM guestbook WHERE id =?"); stmt.setint(1, entry.getid()); Pag. 9/26

10 result = stmt.executeupdate(); conn.close(); catch (SQLException e) { throw new SQLException("Errore: "+e.getmessage()); return result; // fine metodo delete * Ottiene un record dal guestbook con l'id specificato public GuestbookEntry getentry(int id) throws SQLException { GuestbookEntry entry = null; if(conn!= null) { try { PreparedStatement stmt = conn.preparestatement( "SELECT * FROM guestbook WHERE id=?"); stmt.setint(1, id); ResultSet rs = stmt.executequery(); if (rs.next()) { entry = new GuestbookEntry(); int i = rs.getint(1); String message = rs.getstring(2); String sender = rs.getstring(3); java.util.date d = (java.util.date)rs.getobject(4); entry.setcreated(d); entry.setid(i); entry.setmessage(message); entry.setsender(sender); // non chiudiamo subito la connessione // potrebbe tornarci utile return entry; catch (SQLException e) { throw new SQLException("Errore: "+e.getmessage()); // fine if return entry; / fine metodo getentry // fine classe MySQLGuestbookDAO GuestbookDAOFactory.java package mypackage; import java.sql.sqlexception; Pag. 10/26

11 import javax.naming.namingexception; * Factory per la creazione di istanze di GuestbookDAO public class GuestbookDAOFactory { public static GuestbookDAO getinstance() throws ClassNotFoundException, SQLException, NamingException { return new MySQLGuestbookDAO(); Segue il codice delle pagine web: guestbookadd.jsp <%@page contenttype="text/html"%> <%@page pageencoding="utf-8"%> <%@page import="mypackage.*" %> <%@page errorpage="errore.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> <link href="css.css" rel="stylesheet" type="text/css" /> </head> <body> <h3>aggiungi</h3> <form name="frminserisci" method="post" action="<%=request.getrequesturi()%>"> Sender: <input type="text" name="txtsender" value="" /><br/> Message: <textarea name="txtmessage" cols="35" rows="5"></textarea><br/> <input type="submit" value="inserisci" name="btninserisci" /> </form> <% if (request.getparameter("btninserisci")!=null) { int result = 0; String message=request.getparameter("txtmessage"); String sender=request.getparameter("txtsender"); GuestbookDAO gb = GuestbookDAOFactory.getInstance(); // se uso una variabile di sessione potrei recuperare la connessione al database // direttamente dalla sessione //GuestbookDAO gb = (GuestbookDAO) session.getattribute("gb"); if (gb!=null) { GuestbookEntry entry = new GuestbookEntry(); entry.setmessage(message); Pag. 11/26

12 entry.setsender(sender); result = gb.add(entry); if (result!= 0) response.sendredirect("guestbookretrieve.jsp?message=record registrato correttamente"); else response.sendredirect("guestbookretrieve.jsp?message=impossibile registrare il record"); %> </body> </html> guestbookdelete.jsp <%@page contenttype="text/html"%> <%@page pageencoding="utf-8"%> <%@page import="mypackage.*" %> <%@page errorpage="errore.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> <link href="css.css" rel="stylesheet" type="text/css" /> </head> <body> <h3>modifica</h3> <% if (request.getparameter("id")!=null) { int result = 0; int id = Integer.parseInt(request.getParameter("id")); GuestbookDAO gb = GuestbookDAOFactory.getInstance(); //GuestbookDAO gb = (GuestbookDAO) session.getattribute("gb"); if (gb!=null) { GuestbookEntry entry = gb.getentry(id); if (entry!= null) { out.println("cancellazione record id="+entry.getid()+"<br/>"); result = gb.delete(entry); if (result!= 0) Pag. 12/26

13 response.sendredirect("guestbookretrieve.jsp?message=record cancellato correttamente"); else response.sendredirect("guestbookretrieve.jsp?message=impossibile cancellare il record"); else response.sendredirect("guestbookretrieve.jsp?message=record non trovato"); else response.sendredirect("guestbookretrieve.jsp"); %> </body> </html> guestbookretrieve.jsp contenttype="text/html"%> pageencoding="utf-8"%> import="mypackage.*" %> errorpage="errore.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> <link rel="stylesheet" type="text/css" href="css.css"> </head> <body> <h3></h3> <% /* * codice valido nel caso di una sessione if (session.getattribute("gb")==null) { gb = GuestbookDAOFactory.getInstance(); session.setattribute("gb",gb); session.setmaxinactiveinterval(-1); else { gb = (GuestbookDAO) session.getattribute("gb"); GuestbookDAO gb = GuestbookDAOFactory.getInstance(); GuestbookEntry[] entries = gb.retrieve(); if (request.getparameter("message")!=null) { String message=request.getparameter("message"); out.println("<span class='red'>"+message+"</span>"); Pag. 13/26

14 out.println("<table>"); out.println("<tr>"); out.println("<td>"); out.println("id"); out.println("</td>"); out.println("<td>"); out.println("sender"); out.println("</td>"); out.println("<td>"); out.println("message"); out.println("</td>"); out.println("<td>"); out.println("date"); out.println("</td>"); out.println("<td>"); out.println("modifica"); out.println("</td>"); out.println("<td>"); out.println("cancella"); out.println("</td>"); out.println("</tr>"); for(guestbookentry entry : entries) { out.println("<tr>"); out.println("<td>"); int id=entry.getid(); //out.println(id); out.println(entry.getid()); out.println("</td>"); out.println("<td>"); out.println(entry.getsender()); out.println("</td>"); out.println("<td>"); out.println(entry.getmessage()); out.println("</td>"); out.println("<td>"); out.println(entry.getcreated()); out.println("</td>"); out.println("<td>"); out.println("<a href=guestbookentry.jsp?id="+id+">modifica</a>"); out.println("</td>"); out.println("<td>"); out.println("<a href=guestbookdelete.jsp?id="+id+">cancella</a>"); Pag. 14/26

15 out.println("</td>"); out.println("</tr>"); out.println("</table><br/>"); out.println("<a href=guestbookadd.jsp>nuovo</a>"); %> </body> </html> guestbookupdate.jsp contenttype="text/html"%> pageencoding="utf-8"%> import="mypackage.*" %> errorpage="errore.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> <link href="css.css" rel="stylesheet" type="text/css" /> </head> <body> <h3>aggiornamento</h3> <% if (request.getparameter("btnaggiorna")!=null) { int result = 0; String message = request.getparameter("txtmessage"); String sender = request.getparameter("txtsender"); int id = Integer.parseInt(request.getParameter("id")); GuestbookDAO gb = GuestbookDAOFactory.getInstance(); //GuestbookDAO gb = (GuestbookDAO) session.getattribute("gb"); if (gb!=null) { GuestbookEntry entry = new GuestbookEntry(); entry.setid(id); entry.setmessage(message); entry.setsender(sender); result = gb.update(entry); Pag. 15/26

16 if (result!= 0) response.sendredirect("guestbookretrieve.jsp?message=record aggiornato correttamente"); else response.sendredirect("guestbookretrieve.jsp?message=impossibile aggiornare il record"); else response.sendredirect("guestbookretrieve.jsp"); %> </body> </html> guestbookentry.jsp contenttype="text/html"%> pageencoding="utf-8"%> import="mypackage.*" %> errorpage="errore.jsp" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>jsp Page</title> <link href="css.css" rel="stylesheet" type="text/css" /> </head> <body> <h3>modifica</h3> <% if (request.getparameter("id")!=null) { int id=integer.parseint(request.getparameter("id")); GuestbookDAO gb = GuestbookDAOFactory.getInstance(); //GuestbookDAO gb = (GuestbookDAO) session.getattribute("gb"); if (gb!=null) { GuestbookEntry entry = gb.getentry(id); if (entry!= null) { out.println("modifica record id="+entry.getid()+"<br/>"); %> /><br/> <form name="frmaggiorna" method="post" action="guestbookupdate.jsp"> Sender: <input type="text" name="txtsender" value="<%=entry.getsender() %>" Message: <textarea name="txtmessage" cols="35" rows="5"><%=entry.getmessage() %></textarea><br/> <input type="hidden" name="id" value="<%=entry.getid() %>" /> <input type="submit" value="aggiorna" name="btnaggiorna" /> Pag. 16/26

17 </form> <% else response.sendredirect("guestbookretrieve.jsp?message=record non esistente"); else response.sendredirect("guestbookretrieve.jsp"); %> </body> </html> errore.jsp contenttype="text/html"%> pageencoding="utf-8"%> iserrorpage="true" %> import="java.io.printwriter" %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" " <% PrintWriter writer=new PrintWriter(out); %> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>pagina di errore</title> <style type="text/css"> <!-body,td,th { font-family: Trebuchet MS; font-size: 10pt; --> </style> </head> <body> <h2>gestione degli errori</h2> <p>si è verificato il seguente errore: <%=exception.getmessage()%></p> </body> </html> Pool di connessioni Con un pool di connessioni, vengono ottimizzate le operazioni di apertura e mantenimento delle connessioni perchè, ad esempio, una connessione chiusa non viene definitivamente eliminata dalla memoria del sistema ma restituita al pool e nel momento in cui è necessaria una nuova connessione, essa viene recuperata direttamente dal pool senza doverne allocare una nuova. Per poter usare i pool di connessioni, è necessario innanzitutto utilizzare JNDI. Per prima cosa, logghiamoci nella console amministrativa del nostro application server (per noi Sun Application Server 9). Pag. 17/26

18 Username di default admin e password adminadmin Pag. 18/26

19 Cerchiamo Resources nell'albero di navigazione di sinistra, quindi scegliamo JDBC > Connection Pools e costruiamo il pool di connessioni MySQLGuestBookPool con i seguenti dati Pag. 19/26

20 Pag. 20/26

21 Pag. 21/26

22 Stabiliamo i parametri fondamnetali di accesso al database e lasciamo tutti gli altri impostati per default (come il numero massimo di connessioni, il tempo di attesa massimo ecc). Facciamo il ping per assicurarci che il pool funzioni correttamente. Pag. 22/26

23 Successivamente, costruiamo un data source JDBC, assegnandogli un nome (JNDI name: nel nostro caso jdbc/guestbook) e associandolo al pool di connessioni MSQLGuestBookPool. Pag. 23/26

24 Occorre poi modificare il deployment descriptor (il file web.xml) in modo tale che contenga un riferimento alla nostra risorsa appena creata (in Netbeans conviene farlo tramite interfaccia grafica). Pag. 24/26

25 Il contenuto del file web.xml è quindi il seguente: <?xml version="1.0" encoding="utf-8"?> <web-app version="2.4" xmlns=" xmlns:xsi=" xsi:schemalocation=" <session-config> <session-timeout> 30 </session-timeout> </session-config> <welcome-file-list> <welcome-file> index.jsp </welcome-file> </welcome-file-list> <resource-ref> <res-ref-name>jdbc/guestbook</res-ref-name> <res-type>javax.sql.datasource</res-type> <res-auth>container</res-auth> <res-sharing-scope>shareable</res-sharing-scope> </resource-ref> </web-app> Pag. 25/26

26 L'ultimo passo è modificare il codice relativo alla creazione della connessione (riportiamo solo il frammento utile), senza modificare in alcun modo il codice già scritto [costruttore MySQLGuestbookDAO()]: try { javax.naming.initialcontext ctx = new javax.naming.initialcontext(); javax.sql.datasource ds = (javax.sql.datasource) ctx.lookup("java:comp/env/jdbc/guestbook"); conn = ds.getconnection(); catch (NamingException e) { throw new NamingException(e.getMessage()); catch(sqlexception e) { throw new SQLException("Errore! Impossibile stabilire una connessione col db"); // fine try-catch al posto di: try { String classname = "com.mysql.jdbc.driver"; String connstr = "jdbc:mysql://localhost:3306/guestbook_db?user=root&password="; Class.forName(className); conn = DriverManager.getConnection(connStr); catch (ClassNotFoundException e) { throw new ClassNotFoundException("Driver non trovati"); catch (SQLException e) { throw new SQLException("Errore! Impossibile stabilire una connessione col db"); // fine try-catch Pag. 26/26