JDBC. Francisco Javier Solans Benedí Software Developper

Transcripción

1 JDBC Francisco Javier Solans Benedí Software Developper

2 Definición Es la interfaz Java estándar para acceder a base de datos. Neodoo Microsystems S.L. 2

3 Configuración Para usar las librerías JDBC, es necesario realizar los siguientes pasos: Instalar el kit J2SDK (Java 2 Standard Development Kit). Por defecto, se incluye el controlodar JDBC-ODBC. Desplegar el Driver JDBC (específico para cada base de datos). Basta con copiar las librerías (.jar) en la máquina (en el directorio.\java\jre\lib\ext o indicarlo en el classpath). Instalar la base de datos. J2SDK Driver JDBC B.D. Neodoo Microsystems S.L. 3

4 Controladores JDBC (I) Tipos de drivers JDBC : Tipo 1: JDBC-ODBC bridge. Tipo 2: Native-API Driver. Tipo 3: Network-Protocol Driver. Tipo 4: Native-Protocol Driver. Neodoo Microsystems S.L. 4

5 Controladores JDBC (II) Tipo 1: 1 JDBC-ODBC bridge. El driver está implementado en la clase sun.jdbc.odbc.jdbcodbcdriver y viene adjunto en Java 2 SDK, Standard Edition. Aplicación Java JDBC Puente JDBC-ODBC Utiliza el estándar ODBC de la plataforma Microsoft. Ventajas: Gestor de controladores JDBC Controlador ODBC Nos garantiza el acceso a casi todas las bases de datos comerciales (solución provisional). Servidor base de datos Base de datos Desventajas: Lento. Neodoo Microsystems S.L. 5

6 Controladores JDBC (III) Tipo 2: 2 Native-API Driver. Implementación del driver que utiliza las librerías del lado cliente de la base de datos. Aplicación Java JDBC No está implementado totalmente con Java. Controlador API parcialmente nativa-java Desventajas: Dependiente del sistema operativo. Servidor base de datos Base de datos Neodoo Microsystems S.L. 6

7 Controladores JDBC (IV) Tipo 3: 3 Network-Protocol Driver. El controlador JDBC traduce las órdenes JDBC a un protocolo de red independiente del SGBD. Este protocolo es finalmente Aplicación Java vuelto a traducir al lenguaje específico del SGBD. JDBC Controlador JDBC-red 100% Java Ventajas: Nos garantiza en el cliente una aplicación 100% Java. Protocolo de red (middleware) Servidor base de datos Base de datos Desventajas: Necesita pasos intermedios ya que al contrario que el tipo 4, el driver no reside en el cliente sino en la capa intermedia. Neodoo Microsystems S.L. 7

8 Controladores JDBC (V) Tipo 4: 4 Native-Protocol Driver. Implementado 100% Java por lo que es independiente de la plataforma. Aplicación Java JDBC Controlador 100% Java Servidor base de datos Base de datos Controladores completamente escritos en Java, que traducen las órdenes JDBC directamente al protocolo de red que emplea el SGBD Ventajas: Solución ideal. Desventaja: No todas las bases de datos disponen de controladores del tipo 4. Neodoo Microsystems S.L. 8

9 El paquete java.sql La clase DriverManager La interfaz Driver Constituye la base para poder implementar controladores JDBC. La interfaz Conexión Interfaces de sentencias SQL: La interfaz Statement La interfaz PreparedStatement La interfaz CallableStatement Interfaces xxxmetadata Neodoo Microsystems S.L. 9

10 La clase DriverManager (I) Se encarga de gestionar los controladores JDBC. Registrar los controladores JDBC. Class.forName() Establecer una conexión con la base de datos. public static synchronized Connection getconnection(string url); public static synchronized Connection getconnection(string url, String usuario, String password); public static synchronized Connection getconnection(string url, Properties informacion); Neodoo Microsystems S.L. 10

11 La clase DriverManager (II) Controlar el tiempo de conexión. public static void setlogintimeout(int segundos); public static int getlogintimeout(); Presentar mensajes del estado de la conexión. public static PrintStream getlogstream(); public static void setlogstream(printstream salida); Neodoo Microsystems S.L. 11

12 La interfaz Connection Los objetos de esta interfaz son los que representan una conexión con una base de datos. Al ejecutar el método getconnection() de la clase DriverManager, se nos devuelve un objeto de la clase Connection. Cierre de la conexión: public abstract void close() throws SQLException. Estado de la conexión: public abstract boolean isclosed() throws SQLException. Neodoo Microsystems S.L. 12

13 Interfaces de sentencias SQL Envío de sentencias SQL : Interfaces Statement PreparedStatement CallableStatement Neodoo Microsystems S.L. 13

14 La interfaz Statement (I) Los objetos de esta interfaz se usan para enviar sentencias simples SQL a bases de datos. Creación de objetos Método createstatement() de la interfaz Connection Peticiones a la base de datos Cierre de las peticiones public abstract void close() throws SQLException Neodoo Microsystems S.L. 14

15 La interfaz Statement (II) Peticiones simples : De tipo consulta (query), ej: SELECT public abstract ResultSet executequery(string sql) throws SQLException De modificación (update), ej: UPDATE, INSERT, CREATE TABLE public abstract int executeupdate(string sql) throws SQLException Peticiones más complejas : public abstract boolean execute (String sql) throws SQLException true: Petición query ResultSet getresultset () throws SQLException false: Petición update public abstract int getupdatecount() throws SQLException Neodoo Microsystems S.L. 15

16 La interfaz Statement (III) Ejemplo : // Preparar la sentencia Statement stmt = conn.createstatement() ; // Poner el primer parámetro ps.setstring( 1, id ) ; // Ejecutar la consulta ResultSet rs = ps.executequery("select * FROM equipamientos WHERE id =?") ; // Iterar por el resultado while( rs.next() ) System.out.println( rs.getstring("nombre : ") + rs.getstring("nombre") ) ; Neodoo Microsystems S.L. 16

17 La interfaz PreparedStatement (I) Es una interfaz heredada de Statement. Sus instancias son sentencias SQL ya compiladas en las que podemos introducir uno o más parámetros de entrada. Creación de objetos PreparedStatement public abstract PreparedStatement preparestatement(string peticion) throws SQLException Paso de parámetros de entrada con setxxx() setxxx (posicionparametro valor); Ejecución de la petición Métodos análogos a los da la interfaz Statement: execute(), executequery() y executeupdate(). Neodoo Microsystems S.L. 17

18 La interfaz PreparedStatement (II) Ejemplo : // Preparar la sentencia PreparedStatement ps = conn.preparestatement( "SELECT * FROM equipamientos WHERE id =?" ) ; // Poner el primer parámetro ps.setstring( 1, id ) ; // Ejecutar la consulta ResultSet rs = ps.executequery() ; // Iterar por el resultado while( rs.next() ) System.out.println( rs.getstring("nombre : ") + rs.getstring("nombre") ) ; Neodoo Microsystems S.L. 18

19 Procedimientos almacenados (I) Programa escrito en el dialecto SQL del sistema gestor de la base de datos que se compila y funciona en el servidor. Ventajas: Rapidez de ejecución. Seguridad de conjunto. Desventajas: No implementado por todos los sistemas gestores de bases de datos. Se destruye la multiplataforma: se particulariza para una única base de datos. Neodoo Microsystems S.L. 19

20 Procedimientos almacenados (II) Los procedimientos almacenados estan formados por parámetros de entrada (IN), de salida (OUT) y de entrada-salida (INOUT). Existen dos esquemas posibles: Función: Con parámetro resultado, un tipo particular de parámetro OUT : {? = call nombre_proc([?,?,...])} Procedimiento : Sin parámetro resultado: {call nombre_proc ([?,?,...])} Puede haber un número variable de parámetros IN, OUT o INOUT. Neodoo Microsystems S.L. 20

21 Procedimientos almacenados (III) Ejemplo de procedimiento : Ejemplo de función : CREATE PROCEDURE INSERTAR_SECUENCIA (p_numero VARCHAR2) IS BEGIN INSERT INTO secuencia (p_numero) VALUES (p_numero); END; CREATE FUNCTION SIGUIENTE (p_numero NUMBER) RETURN NUMBER IS BEGIN return p_number 1; END; / Neodoo Microsystems S.L. 21

22 La interfaz CallableStatement (I) Los objetos de esta interfaz contienen llamadas a procedimientos almacenados en el sistema gestor de bases de datos. Creación de objetos : public abstract CallableStatement preparecall(string llamada) throws SQLException Paso de parámetros : Registrar los parámetros de salida (OUT) : public abstract void registeroutparameter(int posicionparametro, int tipojdbc) throws SQLException Inicializar los parámetros de entrada (IN) : Familia de métodos setxxx() heredados de la interfaz padre PreparedStatement. Neodoo Microsystems S.L. 22

23 La interfaz CallableStatement (II) Ejecutar el procedimiento : Métodos executeupdate(), executequery(), execute() heredados de la interfaz padre PreparedStatement. Recoger los valores de los parámetros OUT : Familia de métodos getxxx() heredados de la interfaz padre PreparedStatement. Neodoo Microsystems S.L. 23

24 La interfaz CallableStatement (III) Ejemplo de parámetros IN, OUT : // Llama al procedimiento ejemplo CallableStatement cstmt = con.preparecall( {call ejemplo(?,?) ); // Registro de los parámetros OUT cstmt.registeroutparameter(1, java.sql.types.tinyint) // Registro de los parámetros IN cstmt.setboolean(2, true); // Ejecuta el procedimiento cstmt.executequery(); // reenvia los valores // getbyte reenvía un Byte Java a partir del primer parámetro OUT x = cstmt.getbyte(1); Neodoo Microsystems S.L. 24

25 La interfaz CallableStatement (IV) Ejemplo de parámetros INOUT : CallableStatement cstmt = con.preparecall( {call revisatotal (?) ); // se pone 25 en el parámetro que el controlador enviará a la base de datos como un TINYINT de SQL cstmt.setbyte(1,25); // se registra el parámetro como un TINYINT de SQL cstmt.registeroutparameter(1, java.sql.types.tinyint); // se ejecuta el procedimiento cstmt.executeupdate(); // Se recoge el valor obtenido (TINYINT) como un byte de Java byte x = cstmt.getbyte(1); Neodoo Microsystems S.L. 25

26 Transacciones Se emplean para conservar la integridad de la información. Con ello, se asegura de que ciertas operaciones, que se deben realizar de forma conjunta, o se realizan completamente (commit), o no se realiza ninguna, deshaciéndose los cambios parciales (rollback). Por defecto, se abre en auto-commit, es decir que tras cada comando, los cambios se escriben el disco duro del SGBD. Para implementar las transacciones en JDBC, la interfaz Connection viene con una serie de métodos: public abstract setautocommit(boolean autocommit) throws SQLException public boolean getautocommit() throws SQLException public abstract void commit() throws SQLException public abstract void rollback() throws SQLException Neodoo Microsystems S.L. 26

27 Las interfaces xxmetadata La interfaz DatabaseMetaData La interfaz ResultSetMetaData Da información acerca del SGBD, desde la forma en la que se estructura hasta las funciones que soporta. Se consigue la información acerca del resultado de una consulta (ResultSet). Ejemplo : DatabaseMetaData dma = con.getmetadata (); System.out.println("\nConnected to: " + dma.geturl()); System.out.println("Driver: " + dma.getdrivername()); System.out.println("Version: " + dma.getdriverversion()); Ejemplo : ResultSetMetaData rsmd = rs.getmetadata (); int numcols = rsmd.getcolumncount (); for (int i=1; i<=numcols; i++) { if (i > 1) System.out.print(","); System.out.print(rsmd.getColumnLabel(i)); } Neodoo Microsystems S.L. 27

28 Obtención de resultados La clase Types : Se definen los tipos de datos para los SGBD. Los tipos de datos del SGBD no coinciden con los de Java por lo que se realizan los conversiones de JDBC a Java y de Java a JDBC. La interfaz ResultSet. Neodoo Microsystems S.L. 28

29 La clase Types Es una clase del paquete java.sql que deriva de la clase Object. Los tipos de datos del SGBD no coinciden con los de Java; además cada SGBD posee sus propios tipos de datos. Tipos de datos definidos por la clase Types: BIGINT, BINARY, BIT, CHAR, DATE, DECIMAL... Conversión de tipos JDBC a Java : BIGINT = long, BINARY = byte[], VARBINARY = byte[],... Conversión de tipos Java a JDBC : Boolean = BIT, byte = TINYINT, short = SMALLINT,... Neodoo Microsystems S.L. 29

30 La interfaz ResultSet (I) Los objetos de esta interfaz son el resultado de una sentencia de tipo query (consulta). El objeto de la interfaz ResultSet se obtiene al realizar una consulta a una base de datos mediante el método executequery() de la interfaz Statement. Moverse por las filas: public abstract boolean next() throws SQLException Desplazamiento por columnas: la serie de métodos getxxx() public abstract boolean getstring(int numerocolumna) throws SQLException public abstract boolean getstring(string nombrecolumna) throws SQLException getbyte(), getshort(), getint(), getlong(), getfloat(),... Neodoo Microsystems S.L. 30

31 La interfaz ResultSet (II) Ejemplo : String nombre = null, apellido = null; Statement orden = conexión.createstatement(); ResultSet r = peticion.executequery( SELECT nombre, apellido FROM clientes ); while (r.next()) { // Imprime los valores de cada fila nombre = r.getstring( nombre ) ; apellido = r.getstring(2); // Cojo la segunda columna: apellido System.out.println( Nombre: + nombre + Apellido: + apellido); } Neodoo Microsystems S.L. 31