JDBC Tópicos avançados de acesso a base de dados relacional

Transcrição

1 JDBC Tópicos avançados de acesso a base de dados relacional A gestão de instruções SQL em JDBC 1 : proposta de uma arquitectura para evitar a manipulação de código SQL embutido em código JAVA. A arquitectura tem como objectivos proporcionar: a modificação da string de uma query no momento da compilação, mas sem recorrer à concatenação de strings; a modificação de uma query sem modificar o código java; a separação da camada de execução de instruções SQL do código Java da aplicação. As instruções SQL devem ser definidas num ficheiro de propriedades 2. A cada uma é dado um nome adequado. O nome é a chave e a string (query) é o valor de uma propriedade. A query pode conter variáveis where, como varnome no exemplo seguinte: # Sample ResourceBundle properties file query1= SELECT * from pessoa query2= SELECT * from pessoa where nome='maria' query3= SELECT * from pessoa where nome='varnome' varnome será substituída em run-time. Do lado da aplicação Java, a estrutura de dados que guarda a atribuição de valores a estas variáveis é uma Hashtable. 1 Baseado em [Chitaguppi,2005], disponível em 2 Ver em

2 A arquitectura é exemplificada através de 3 classes: 1. Teste_Acesso_BD.java - Classe para testar o acesso a uma BD relacional com recurso a um ficheiro de texto do tipo '.properties' que guarda todos os comandos SQL, o que permite separar realmente o código JAVA do código SQL. Esta classe funciona com duas outras auxiliares, SQLCache.java e QueryResult.java. 2. SQLCache.java - Classe que obtêm instruções SQL guardadas num ficheiro de propriedades e que as manipula, por exemplo para verificar a correcção de uma query. 3. QueryResult.java - Classe auxiliar para tratar os resultados de uma query. Guarda o resultado de um ResultSet numa tabela, representada por um Vector que integra matrizes do tipo DataElement. Teste_Acesso_BD.java import java.sql.*; import java.util.*; * Classe para testar o acesso a uma BD relacional * com recurso a um ficheiro de texto do tipo '.properties' * que guarda todos os comandos SQL, o que permite separar * realmente o código JAVA do código SQL public class Teste_Acesso_BD { Connection connect; Statement stmt; // instância de SQLCache guardará as strings que representam comandos SQL SQLCache cache; * Construtor que carrega as intruções SQL do ficheiro de properties * para o atributo 'cache' (instância de SQLCache) public Teste_Acesso_BD() { cache = new SQLCache(); cache.loadsqlstatements(); * Carrega o driver MySQL e abre a Connection em localhost, sem utilizar password. public void carregadrivereabreconnection(){ Class.forName("com.mysql.jdbc.Driver").newInstance(); catch (Exception ex) {

3 ex.printstacktrace(); connect = DriverManager.getConnection( "jdbc:mysql://localhost:3306/test?"+ "user=root&password=password"); catch (SQLException ex) { System.out.println("SQLException: " + ex.getmessage()); System.out.println("SQLState: " + ex.getsqlstate()); System.out.println("VendorError: " + ex.geterrorcode()); ex.printstacktrace(); ** Abre um Statement. public void abrestatement(){ stmt = connect.createstatement(); catch(exception e){ e.printstacktrace(); * Fecha um Statement. public void fechastatement(){ stmt.close(); catch(exception e){ e.printstacktrace(); * Fecha uma Connection. public void fechaconnection(){ connect.close(); catch(exception e){ e.printstacktrace(); * Método que executa uma query com recurso às classes * auxiliares SQLCache e QueryResult. public QueryResult executeselect( String qryname, Hashtable params) throws Exception { // instância de QueryResult guardará o resultado da query QueryResult result = null; String query = cache.compilequery(qryname,params); ResultSet rs = stmt.executequery(query); result = new QueryResult(); result.populatedata(rs); catch(exception e){ e.printstacktrace(); return result; * O método main testa a execução de uma query com parâmetros. public static void main(string args[]){

4 Teste_Acesso_BD testebd = new Teste_Acesso_BD(); testebd.carregadrivereabreconnection(); testebd.abrestatement(); Hashtable params = new Hashtable(); params.put("varnome", "Antonio"); String qryname = new String("query3"); QueryResult qr; qr = testebd.executeselect(qryname, params); System.out.println(qr.tabela()); catch(exception ex){ ex.printstacktrace(); testebd.fechastatement(); testebd.fechaconnection(); * O ficheiro sql.properties tem o seguinte conteúdo para teste: * * * # Sample ResourceBundle properties file * query1= SELECT * from pessoa * query2= SELECT * from pessoa where nome='maria' * query3= SELECT * from pessoa where nome='varnome' * * ( Para conhecer os ficheiros de propriedades ver em * ) * SQLCache.java import java.util.*; import java.io.*; * Classe que obtêm instruções SQL guardadas num ficheiro de propriedades * e que as manipula, por exemplo para verificar a correcção de uma query. public class SQLCache { * As instruções SQL obtidas a partir do ficheiro ficarão guardadas * num objecto do tipo Properties * (ver * e ) private Properties props = new Properties(); * Nome do ficheiro de propriedades private static final String SQL_FILE = "..\\..\\..\\..\\sql.properties";

5 // várias hipóteses de acesso ao ficheiro sql.properties: // quando se usa uma classe normal: //private static final String SQL_FILE = "..\\..\\..\\..\ \sql.properties"; // quando se acede à base a partir de um servlet: // 1ª hipótese: //private static final String SQL_FILE = "..\\..\\sql.properties"; // e copiar à mão o ficheiro sql.properties para "C:\Program Files\netbeans-5.5\enterprise3\apache-tomcat " // 2ª hipótese: // posicionar na raiz de C: desde "C:\Program Files\netbeans-5.5\enterprise3\apache-tomcat \webapps" // e depois percorrer o Path até ao ficheiro de propriedades // private static final String SQL_FILE = "..\\..\\..\\..\\..\\..\\Users\\Jorge\\Desktop\\ISCTE\\PRede\ \PRede_ \\Testes\\TesteMySQL\\sql.properties"; * Carrega instruções SQL a partir do ficheiro de propriedades e guarda-as num objecto Properties public void loadsqlstatements() { // carrega as instruções SQL a partir de um ficheiro de propriedades InputStream in = getclass().getclassloader().getresourceasstream(sql_file); System.out.println("in: " + in); props.load(in); System.out.println("props" + props); in.close(); catch(exception e) { e.printstacktrace(); * Método chamado antes de executar uma query, para substituir * as variáveis na query pelos parâmetros devidos. * Os parâmetros estão guardados numa Hastable * (ver public String compilequery(string qryname, Hashtable params) throws Exception { String qry = getsqlstatement(qryname); for(enumeration enu = params.keys(); enu.hasmoreelements();) { String key = (String) enu.nextelement(); String value = (String) params.get(key); System.out.println(key); qry = qry.replaceall(key,value); return qry;

6 * Método que verifica se uma instrução SQL existe public String getsqlstatement(string sqlname) throws Exception { String sqlstm = (String) props.get(sqlname); if(sqlstm == null) { throw new Exception("A instrução SQL não foi encontrada."); else { return sqlstm; QueryResult.java import java.util.*; import java.sql.*; * Classe auxiliar para tratar os resultados de uma query. * Guarda o resultado de um ResultSet numa tabela, * representada por um Vector que integra matrizes do tipo DataElement. public class QueryResult { private Vector tabela = new Vector(); * Classe que guarda o resultado de um ResultSet numa tabela, * representada por um Vector que integra matrizes do tipo DataElement public void populatedata(resultset rs) throws SQLException { ResultSetMetaData metadata = rs.getmetadata(); int colcnt = metadata.getcolumncount(); while(rs.next()) { DataElement[] obj = new DataElement[colCnt]; for(int i=0;i<colcnt;i++) { DataElement element = new DataElement(); element.datatype = metadata.getcolumntype(i+1); element.datatypename = metadata.getcolumntypename(i+1); element.colname = metadata.getcolumnname(i+1); element.value = rs.getobject(i+1); System.out.println(element.value); obj[i] = element; tabela.addelement(obj); * Inspector para a tabela dos dados retirados do ResultSet Vector tabela(){

7 return tabela; * Classe embutida que representa cada elemento que é retirado do ResulSet, * qualquer que seja o seu tipo private class DataElement { int datatype; String datatypename; Object value; String colname;