JDBCProgramando interfaces para bases de datos con java

Java

Java: Definiendo las clasesEn Java, cualquier pedazo de cdigo que se desee ejecutar debe formar parte de una clase. Cada clase se describe en un fichero que debe nombrarse con el nombre de la clase y la extensin javaAs, si existe una clase que se llama MiClaseDeJava debe definirse en un fichero llamado MiClaseDeJava.java

Java: Importando Clases

Las primeras lneas de cdigo tienen que importar las clases (o paquetes) que se usarn en la nueva clase. Entre otras nos harn falta las clases definidas en el paquete java.sql (el API de JDBC).

Para ello necesitas incluir la lnea: import java.sql.*;.

La estrella indica que se desea importar todas las clases contenidas en el paquete java.sql. (Alternativamente se pueden especificar las clases necesarias).

Java: Mtodo main

Si la clase ha de ser ejecutable, debe contener un mtodo pblico llamado mainEl mtodo debe ir tras la declaracin de la clase

import java.sql.*;

public class TestDriver { public static void main(String[] Args) { . . . }//fin de main. . .}//fin de clase TestDriver

Java: Excepciones-I

Como veris todas las aplicaciones incluyen "bloques" try y catch. Esta es la forma que tiene Java de manejar los errores/excepciones. Java requiere que cuando alguna rutina lanza una excepcin esta sea recogida.

Java: Excepciones-II Los arboles no dejan ver el bosque

try {// Code that could generate an exception goes here.// If an exception is generated, the catch block below// will print out information about it.} catch(SQLException ex) {System.err.println("SQLException: " + ex.getMessage()); ex.printStackTrace(); System.exit(1);}

JDBC

IntroduccinJDBC provee una librera para acceder a distintas bases relacionales y normaliza la mayor parte de las operaciones (las hace independientes de la base de datos utilizada y por tanto portables). Es parte de las distribuciones standard de JavaJDBC no comprueba que las sentencias SQL son correctas, sencillamente las pasa a la base de datos

JDBC driversJDBC consta de unAPI genrico (escrito en java)Drivers especficos de cada base de datos que se encargan de las interacciones con la base de datos especificas de cada sistema que "habla" a la base con la base de datos.Tanto el API como los drivers se ejecutan en el cliente.

Ms informacion en:Sun JDBC web http://java.sun.com/products/jdbcJDBC tutorialhttp://java.sun.com/docs/book/tutorial/jdbcLista de drivershttp://industry.java.sun.com/products/jdbc/driversjava.sql API http://java.sun.com/j2se/1.4/docs/api/java/sql/package-summary.html

Siete pasos bsicos para programar en JDBCCargar el driver de la base de datos a accederDefinir el URL usado paraEstablecer la conexin Crear una orden SQLEjecutarlaProcesar los resultadosCerrar la conexin

Cargar el driver// cargar las clases relacionadas con sql. . . // carga el driver usando el metodo Class.forName()

try { Class.forName("org.postgresql.Driver");} catch (ClassNotFoundException cnfe) { System.out.println("Couldn't find the driver!"); System.out.println("Let's print a stack trace, and exit."); cnfe.printStackTrace(); System.exit(1); } // Si el driver no esta disponible, el mtodo forName() //emitira una excepcion del tipo //ClassNotFoundException.

Cargar el driver IIComo veis cargar el driver requiere una nica lnea de cdigo. La forma de cargar el driver mostrada en la transparencia anterior es la ms comn pero hace que el codigo no sea portable, si cambiamos de base de datos y la nueva eleccin no es postgreSQL.Otra posibilidad es especificar el driver necesario cuando se ejecuta el programa pasandolo mediante -Dargumento. Por ejemplo:

java -Djdbc.drivers=org.mysql.Driver myaplicacion

Definir el URL usado paraEstablecer la conexinUna vez cargado el driver hay que solicitar una conexin a la base de datos, para ello se usa la clase DriverManager y un URL como el siguiente.

jdbc:postgresql:peliculas

jdbc:nombre_driver_base://host:puerto/nombre_de_la_base

Establecer la conexin Connection connection = null;connection = DriverManager.getConnection("jdbc:postgresql:peliculas", "username","password");_____________________________

Ver Ejemplo1 -> programa trivialVer Ejemplo 1_5 (NO) -> usando java -Djdbc...

Opcionalmente conseguir informacin sobre la baseimport java.sql.DatabaseMetaData//cargar driver//conectarse a la base. . . DatabaseMetaData dbMetaData = connection.getMetaData();String productName =dbMetaData.getDatabaseProductName();System.out.println("Database: " + productName);String productVersion =dbMetaData.getDatabaseProductVersion();System.out.println("Version: " + productVersion); // check if "actor" table is there ResultSet tables = dbMetaData.getTables(null, null, "actor", null); if (tables.next()) { System.out.println("Table exists"); }------Ejemplo1_6http://java.sun.com/j2se/1.3/docs/api/java/sql/DatabaseMetaData.html

Crear una Sentencia SQL y ejecutarlaEl siguiente paso requiere la creacin de un objeto de la clase Statement. El se encargar de enviar la consulta en SQL a la base.Statement statement = connection.createStatement();//statement necesita una conexin abiertaEs necesaria una instancia activa de una conexin para crear el objeto Statement JDBC devuelve los resultados en un objeto de la clase ResultSet Finalmente, ejecutamos la consultaString query = "SELECT * FROM cia";ResultSet resultSet = statement.executeQuery(query);//el resultado de la consulta se almacena //en resulset// NO SE PONE ; AL FINAL DE LA CONSULTAExample2_0

Si se desea modificar la BaseEntonces se ejecuta:executeUpdate(string); en lugar de executeQuery(string) (donde string contiene UPDATE, INSERT o DELETE);SetQueryTimeout se puede usar para especificar cuanto se espera antes de abortar la transaccin

Statement se puede reutilizarNo hace falta crear un objeto estatement para cada consulta

statement.executeUpdate("INSERT INTO cia " + "VALUES('Algeria','Africa'," + "2381740.0,28539321.0,97100000000.0)");

statement.executeUpdate("INSERT INTO cia " + "VALUES(American Samoa'," + "'Oceania',199.0,57366.0,128000000.0)");Prestar atencin a la forma de romper las lineas:espacio tras ciadobles comillas para cada lnea+ uniendo la orden SQL

Procesando los resultadosEl objeto resultSet, contiene 265 tuplas describiendo los distintos pases. Para acceder a los distintos valores se leern las tuplas una a una y accederemos a los atributos usando distintos mtodos segn el tipo de variable. El mtodo next mueve el cursor a la siguiente tupla (la cual sobre la que se opera) Cada invocacin al mtodo next mueve el cursor una fila hacia delante

Procesar los resultados//Los metodos usados no son los correctos para ciawhile(resultSet.next()) { System.out.println(resultSet.getString(1) + " " + resultSet.getDouble(2) + " " + resultSet.getInt(3) + " " + resultSet.getTimeStamp(4));La primera columna tiene ndice 1 (no 0)ResultSet define varios mtodos getXxxx que dado el nmero de columna devuelve el valor all almacenadoA partir de JDBC 2.0, es posible mover el cursor hacia atrs yo incrementarlo en ms de una unidadsrs.absolute(4); srs.relative(-3);

Procesar los DatosTambin se puede indexar usando atributos.while(resultSet.next()) { System.out.println(resultSet.getString(1) + " " + resultSet.getString(2) + " " + resultSet.getInt(3) + " " + resultSet.getInt(4));while(resultSet.next()) { System.out.println(resultSet.getString("nombre") + " " + resultSet.getString("region") + " " + resultSet.getInt ("area") + " " + resultSet.getInt("poblacion"));

Cerrar la conexinconnection.close();Abrir una conexin es caro as que debe posponerse el cierre de la conexin si se van a ejecutar ms consultas a la misma base de datos

Ejemplo Completo-Iimport java.sql.*;

public class TestDriver { public static void main(String[] Args) { try { //Constructor Class.forName("org.postgresql.Driver");} Connection connection = DriverManager.getConnection ("jdbc:postgresql:cia","roberto","pepino"); Statement statement = connection.createStatement(); String consultaSQL = "SELECT 1+1";

Ejemplo Completo-IIResulSet results = statement.executeQuery(consultaSQL);//Mostrar datosint outp;while (results.next()){ outp = results.getInt(); System.out.println("1+1 es: " + outp + "\n");}connection.close();} catching excepcioncath(java.lang.Exception ex){ System.out.println("Error: " + ex);}}}

ResultSetMetaData:

ResulSetMetaDataYa lo vimos al principio de la charlaPermite responder a preguntas como:Cuntas columnas hay en un ResultSet?Cul es el nombre de una columna en particular?Qu tipo de datos contiene una columna en particular?Cul es el tamao mximo de una columna?

ResulSetMetaData: Mtodos

getColumnCountnmero de columnas de la relacingetColumnDisplaySizemximo ancho de la columna especificadagetColumnNamenombre de la columnagetColumnTypetipo de datos (SQL ) de la columna

ResulSetMetaData: MtodosisNullableEsta columna puede contener NULLs?Las posibles respuestas son columnNoNulls, columnNullable, columnNullableUnknown

Ejemplo usando "Meta Data"//Este cdigo no compila, driver ya cargadoConnection connection= DriverManager.getConnection(url,username,password);

//Info sobre la base de datosDatabaseMetaData dbMetaData = connection.getMetaData();String productName = dbMetaData.getDatabaseProductName();System.out.println("Database: " + ProductName);String productVersion = dbMetaData.getDatabaseProductVersion();. . .

Ejemplo usando "Meta Data" IIStatement statement = connection.createStatement();String query = "SELECT * FROM cia";ResultSet resultset = statement.executeQuery(query);//Info sobre la tablaResultSetMetaData resultsMetaData = resultSet.getMetaData();int columnCount = resultsMetaData.getColumnCount();// El ndice de las columnas empieza en 1for (int i=1; i< columnCount ;i++) System.out.print( resultsMetaDAta.getColumnName(i) + " ");//etc, etc, etc

Statement

StatementA travs de la clase Statement, se envan las consultas en SQL a la baseExisten varios tipos de objetos "statement". Nos concentraremos en dos:Statement: ejecccin de consultas sencillas.PreparedStatement: ejecucin de consultas precompiladas (parametrizadas).

PreparedStatementSi se van a ejecutar varias consultas similares el uso de consultas "parametrizadas" puede ser ms eficienteSe crea la consulta, este se enva a la base de datos donde se optimiza antes de ser usada.Cuando se desee usar basta con remplazar los parmetros usando los mtodos setXxxxEjemplo6

Transacciones

TransaccionesPor defecto JDBC abre las conexiones en modo autocommit, esto es, cada comando se trata como una transaccinPara controlar las transacciones se debe:anular el modo autocommitconnection.setAutoCommit(false);llamar commit para registrar permanentemente los cambiosllamar a rollback en caso de error

Transacciones: ejemploConnection connection = DriverManager.getConnection(url,username,passwd);connectio.setAutoCommit(false);//setTransactionIsolation//NO commit explicitotry{ statement.executeUpdate(); statement.executeUpdate();} catch (SQLExcepcione e){ try{ connection.rollback(); } catch(SQLExcepcion sqle) { //report problem } }

Transacciones: ejemplo II try { connection.commit(); connection.close(); } catch (SQLException sqle) {}}

UtilidadesDatabaseUtilities y DBResults

Idea:La tarea ms "repetitiva" en JDBC es la realizacin de consultas y el formateo de las respuestas. DatabaseUtilities y DBResults facilitan estas tareas.Mtodos:

getQueryResultsconecta la baserealiza la consultatrae las tuplas resultado (como strings)las coloca en un objeto DBResults

createTable. Dado:El nombre de una tablauna cadena describiendo el tipo de los atributosun array de strings con una instancia de la tablaEste metodo crea la tabla (CREATE TABLE) y la puebla (INSERT)

printTableDado el nombre de una tabla este mtodo se conecta a la base e imprime el contenido de la tabla por pantallaprintTableDataDado un objeto DBResults obtenido con anterioridad. printTableData imprime el resultado por pantalla

EjemploDBResults results = DatabaseUtilities.getQueryResults(driver, url, username, password,query,true);

out.println(results.toHTMLTable("CYAN"));

DBUtilities/jesus/cwp/CiaTest.javacompile all/run from above Example3 (command line)/Example4 (input)

Curiosidad: Qu es lo que se manda de verdad?El comado SQL puede ser transformado de acuerdo a las peculiaridades de la baseString Nat = connection.nativeSQL("SELECT * FROM cia WHERE name='rrr'");System.out.println("native: " +nat + "\n");Aunque normalmente no lo es para estos casos tan sencillos Example2_1.java

*