Documente Academic
Documente Profesional
Documente Cultură
a
d
e
c
d
i
g
o
n
a
t
i
v
o
Base de
Datos
Aplicacin J ava
Consulta
Resultado
Cliente Servidor
Figura 2 Manejador de API nativo
El ABC de J DBC 10 de 36
Tutorial de javaHispano http://javahispano.org
Manejador de JDBC-Net (tipo3)
El manejador se comunica con un servidor intermedio que se encuentra entre el cliente y
la base de datos. El servidor intermediario se encarga de traducir las al API J DBC al
protocolo especfico de la base de datos.
No se requiere ningn tipo de cdigo nativo en el cliente, por lo que la portabilidad de
la aplicacin est garantizada: el manejador es tecnologa 100% J ava.. Adems si el
intermediario es capaz de traducir las llamadas J DBC a protocolos especficos de
diferentes sistemas de BD podremos emplear un mismo manejador para comunicarnos
con diferentes bases de datos. Esto lo convierte en el manejador ms flexible de todos.
No obstante se trata de un driver complejo, ya que requiere la presencia de un
midelware, una capa intermedia entre el cliente y la ase de datos, por lo que no es muy
comn emplearlo en arquitecturas simples, sino ms bien en arquitecturas sofisticadas
donde muchas veces entran en juego varias bases de datos distintas.
A
P
I
J
D
B
C
J
D
B
C
-
N
e
t
Base de
Datos
Aplicacin J ava
Consulta
Resultado
Cliente Servidor
S
e
r
v
i
d
o
r
i
n
t
e
r
m
e
d
i
o
Figura 3 Manejador JDBC-Net
El ABC de J DBC 11 de 36
Tutorial de javaHispano http://javahispano.org
Manejador de Protocolo Nativo (tipo4)
El manejador traduce directamente las llamadas al API J DBC al protocolo nativo de la
base de datos. Es el manejador que tiene mejor rendimiento, pero est ms ligado a la
base de datos que empleemos que el manejador tipo J DBC-Net, donde el uso del
servidor intermedio nos da una gran flexibilidad a la hora de cambiar de base de datos.
Este tipo de manejadores tambien emplea tecnologa 100% J ava.
A
P
I
J
D
B
C
M
a
n
e
j
a
d
o
r
Base de
Datos
Aplicacin J ava
Consulta
Resultado
Cliente Servidor
Figura 4 Manejador de Protocolo Nativo
El ABC de J DBC 12 de 36
Tutorial de javaHispano http://javahispano.org
4 El API del desarrollador de aplicaciones,
paquete java.sql
En esta seccin introduciremos las principales clases e interfaces, del paquete java.sql,
que un desarrollador de aplicaciones J ava debe emplear para interactuar con una base de
datos.
5.1 Clase DriverManager
Como su nombre indica esta clase es la gestora de los diversos drivers (manejadores)
que haya en nuestra aplicacin. Es posible que sea necesario en una misma aplicacin
tener varios manejadores para una misma base de datos, acceder a varias bases de datos
que emplean distintos manejadores, o bien ambas situaciones a la vez. De ah el inters
de contar con este gestor de manejadores.
Los mtodos que ms nos interesan de esta clase son static Connection
getConnection(String url) y static Connection getConnection(String url, String user,
String password). Estos mtodos intentan establecer conexin con la base de datos que
le indiquemos en el campo url empleando para ellos todos los manejadores que hemos
registrado. La diferencia entre un mtodo y el otro, obviamente, es que en uno slo se
especifica la base de datos a la que nos queremos conectar, mientras que en el otro se
indica tambin el nombre de usuario de la base de datos y su password. Ms adelante
explicaremos que es el objeto Connection que devuelven estos mtodos.
Lo que hace la clase DriverManager para intentar establecer conexin con la base de
datos es invocar al mtodo connect de la interface Driver, interface que como veremos
deben implementar todos los manejadores. Realiza esta operacin con todos los
manejadores que tiene registrados, si el manejador devuelve null significa que no se ha
podido conectar con la base de datos, y el gestor intenta de nuevo conectarse con otro
manejador. Si consigue conectarse con un manejador no sigue intentndolo con el resto
El ABC de J DBC 13 de 36
Tutorial de javaHispano http://javahispano.org
de los manejadores registrados, y si no consigue establecer la conexin con ningn
manejador lanza una excepcin tipo SQLException.
Sintaxis de los URL de JDBC
Los URL (Uniform Resource Locator) de J DBC identifican una base de datos, y un
protocolo de conexin a esta, de un modo unvoco. Toda URL de J DBC consta siempre
de tres partes:
protocolo:subprotocolo:subnombre.
Un ejemplo de URL de conexin podra ser: jdbc:odbc:usuarios. Veamos qu es cada
una de las partes del URL:
DriverManager
Manejador 1
Base de
Datos
Aplicacin J ava
getConnection(Stringurl)
Manejador 2 Manejador 3
connect(Stringurl)
null null Connection
fallo fallo
xito
Figura 5Proceso de conexin a la base de datos
El ABC de J DBC 14 de 36
Tutorial de javaHispano http://javahispano.org
1. Protocolo de la conexin. Siempre es jdbc.
2. Subprotocolo de la conexin. Identifica el tipo de mecanismo de conexin que
emplearemos para acceder a la base de datos. Es imprescindible especificarlo
para que el DriverManager pueda saber que tipo de manejador debe emplear
para crear la conexin. En el URL ejemplo el subprotocolo empleado para la
conexin a la base de datos ser ODBC, por lo que el DriverManager intentar
establecer la conexin con todos los manejadores registrados que sean de tipo 1,
puente J DBC-ODBC.
3. Subnombre, identifica la base de datos con la que queremos establecer una
conexin.
En el ejemplo el subnombre es clientes; ser el sistema ODBC quien proporcione, a
partir de ese nombre, el resto de la informacin necesaria para establecer la conexin
con la base de datos. Sin embargo si empleamos otro protocolo puede ser necesario
incluir la direccin de red del servidor como subnombre. As por ejemplo para conectar
con una base de datos remota la sintaxis de la URL es:
protocolo:subprotocolo://servidor:puerto/subnombre
As por ejemplo la URL: jdbc:bdnet://javahispano.org:4040/usuarios Empleara el
protocolo jdbc y un manejador de tipo J DBC-Net para conectarse a la hipottica base de
datos usuarios a travs del puerto 4040 de la mquina javahispano.org.
Registro de un manejador
Registrar un manejador no es ms que cargar en memoria una clase que implementa el
interfaz Driver, clase proporcionada por los desarrolladores de la base de datos. Existen
tres formas de registrar un Driver:
1. Empleando el cargador de clases. Para ello empleamos, al igual que para cargar
cualquier otra clase, el mtodo forName(String clase) de la clase Class.
Class.forName("com.mysql.Driver");
El ABC de J DBC 15 de 36
Tutorial de javaHispano http://javahispano.org
2. Instanciando la clase que implementa el interfaz Driver. De este modo
tendremos una referencia al Driver, pudiendo establecer la conexin
directamente con l sin necesidad de emplear la clase DriverManager. La
sintaxis es la misma que para instaciar cualquier otra clase:
Driver driverPraMySQL = new org.gjt.mm.mysql.Driver();
3. Definir la propiedad jdbc.drivers. Podemos hacerlo de dos modos diferentes:
a. Definiendo la propiedad jdbc.drivers en nuestra mquina virtual. La
sintaxis es jdbc.drivers=nombreManejador1: nombreManejador2:
jdbc.drivers=gjt.mm.mysql.Driver:oracle.jdbc.driver.OracleDriver;
b. Emplear la opcin D al invocar a la mquina virtual. Para ellos
debemos arrancar nuestra aplicacin con el comando java -
Djdbc.drivers=nombreManejador1: nombreManejador2:
java -Djdbc.drivers=gjt.mm.mysql.Driver:oracle.jdbc.driver.OracleDriver;
5.2 Interfaz Driver
Aunque es vital para establecer la conexin con la base de datos en la prctica el
desarrollador de aplicaciones puede olvidarse de esta interfaz. Es responsabilidad del
desarrollador del manejador proveer una clase que la implemente esta interfaz, y ser
responsabilidad del DriverManager llamar al mtodo connect de los drivers registrados
para intentar establecer la conexin con la base de datos.
El ABC de J DBC 16 de 36
Tutorial de javaHispano http://javahispano.org
No obstante es posible crear un objeto tipo Driver, instanciando la clase desarrollada
por el desarrollador del manejador, e invocar directamente a su mtodo connect,
obteniendo una conexin con la base de datos sin necesidad de emplear la clase
DriverManager. De este modo tenemos ms control sobre el Driver que estamos
empleando en la conexin, cuando hemos registrado ms de un driver, ya que no nos
arriesgamos a que se establezca conexin con la BD con un driver distinto al que
nosotros deseamos usar.
5.3 Interfaz Connection
Representa una conexin con la base de datos. Permite crear objetos que representan
consultas que se ejecutarn en la base de datos, y permite acceder a informacin sobre la
base de datos y las posibilidades del manejador J DBC.
En esta tabla recogemos los principales mtodos de la interfaz Connection. Sobre
muchos de ellos volveremos a hablar ms adelante.
Mtodos de la Interfaz Connection
voi d cl ose( )
Libera lo los recursos de esta conexin.
voi d commi t ( )
Hace permanentes los cambios que se realizaron desde el
ultimo commit o rollback.
St at ement
cr eat eSt at ement ( )
Crea un objeto de tipo Statement.
bol ean get Aut oCommi t ( )
Indica si est en modo auto-commit.
Dat abaseMet aDat a
get Met aDat a( )
Devuelve un objeto tipo Dat abaseMet aDat a con meta
informacin a cerca de la base de datos contra la cual se
ha abierto esta conexin..
Cal l abl eSt at ement
Crea un objeto Cal l abl eSt at ement para ejecutar
El ABC de J DBC 17 de 36
Tutorial de javaHispano http://javahispano.org
pr epar eCal l ( St r i ng sql )
procedimientos almacenados SQL en la BD.
Pr epar edSt at ement
pr epar eSt at ement
( St r i ng sql )
Crea un objeto Pr epar edSt at ement para ejecutar
consultas SQL parametrizadas en la BD.
voi d r ol l back( )
Deshace todos los cambios realizados desde la ltima vez
que se ejecut comit o rollback
voi d set Aut oCommi t
( bool ean aut oCommi t )
Indica el modo de commit en el cual se opera.
5.4 Ejecucin de instrucciones: Satment,
PreparedStatment y CallableStatment
Interface Statement
Esta interfaz permite enviar instrucciones SQL a la base de datos. Podemos obtener un
objeto que implemente esta interfaz a partir del mtodo Statement
createStatement() de l a i nt er f az Connection. Para enviar una consulta tipo
SELECT se emplea el mtodo execteQuery(String sql). Este mtodo devuelve un objeto
tipo Resulset. Para enviar una instruccin tipo DELETE, UPDATE, INSERT o una
instruccin DDL (Data Definition Language) se emplea executeUpdate(String sql).
Mediante el mtodo execute(String sql) podemos ejecutar cualquiera de los comandos
anteriores.
Interfaz PreparedStatment
Representa una instruccin SQL preparada, esto es, una instruccin SQL precompilada
cuya ejecucin es mucho ms eficiente que ejecutar repetidas veces una misma
instruccin SQL. Cuando vayamos a ejecutar varias veces las mismas instrucciones
debemos emplear esta interfaz.
El ABC de J DBC 18 de 36
Tutorial de javaHispano http://javahispano.org
Podemos obtener un objeto que implemente esta interfaz a partir del mtodo
PreparedStatement createPreparedStatement(String sql) de l a i nt er f az
Connection. La interfaz PreparedStatment extiende a Statment aadiendo una serie de
mtodos setXXX(int indice, XXX valor) que permiten, para cada ejecucin de la
instruccin, asignar un valor a los parmetros de la instruccin SQL precompilada. El
primer valor, siempre un entero, es el ndice del parmetro al cual le vamos a asignar un
valor, empezando a contar en 1, y valor es el valor que le asignamos a ese parmetro.
La interfaz CallableStatment
Permite ejecutar instrucciones no SQL en la base de datos, como por ejemplo
procedimientos almacenados. Extiende a la interfaz PreparedSatatmen. Podemos
obtener un objeto que implemente esta interfaz a partir del mtodo CallableStatement
prepareCall(String sql)de l a i nt er f az Connection.
5.5 Interfaz ResulSet
Esta interfaz representa un conjunto de datos que son el resultado de una consulta SQL.
La clase posee una serie de mtodos XXX getXXX(int columna) y XXX getXXX(String
columna) que permiten acceder a los resultados de la consulta (para la sintaxis concreta
de estos mtodos acudir al javadoc de la interfaz ResulSet). Para acceder a los distintos
registros empleamos un cursor, que inicialmente apunta justo antes de la primera fila.
Para desplazar el cursor empleamos el mtodo next().
Figura 6 Funcionamiento del Resulset
Cliente Saldo
J uan 129
Pedro 122
Ana 23
next()
getInt(Saldo)=129
tSt i (Cli t ) J
getInt(Saldo)=122
tSt i (Cli t ) P d
Resulset
next()
El ABC de J DBC 19 de 36
Tutorial de javaHispano http://javahispano.org
4 Una aplicacin JDBC bsica
Toda aplicacin que acceda a una base de datos empleando el API J DBC debe realizar
una serie de pasos:
1. Establecer una conexin con la base de datos.
2. Ejecutar una o varias instrucciones SQL
3. Si las intrusiones devuelven datos (SELECT) debemos procesarlos.
4. Liberar los recursos de la conexin.
En este apartado mostraremos cmo abordar cada uno de estos pasos mediante el
anlisis de fragmentos del cdigo HolaMundoJ DBC.java, que se distribuye junto con
este tutorial.
5.1 Conectndose a la base de datos
En un primer lugar debemos de registrar el o los manejadores que queramos emplear
para acceder a la base de datos. Para ello debemos asegurarnos que el archivo .jar que
contiene los drivers de nuestra base de datos est incluido en el CLASSPATH que
emplea nuestra mquina virtual. Tambin debemos sustituir en el cdigo
HolaMundoJ DBC.java el valor de la variable String driver por un String que referencia
al manejador de la base de datos que vas a usar.
Para registrar el manejador podemos emplear cualquiera de los procedimientos
recogidos en la seccin 0. En este cdigo se ha empleado el cargador de clases:
Class.forName(String driver).
Para establecer la conexin emplearemos el mtodo getConection de la clase
DriverManager. Debes de sustituir antes el valor de la variable String url por la URL de
tu base de datos. En la documentacin del driver debe haber informacin a cerca de que
El ABC de J DBC 20 de 36
Tutorial de javaHispano http://javahispano.org
URL debes usar. Tambin debes proporcionar, en caso de ser necesario, el nombre de
un usuario de la base de datos y su password.
Aqu tienes el fragmento de cdigo del ejemplo HolaMundoJ DBC.java que se encarga
de realizar estas tareas.
/ / Reempl aza est a var i abl e con el dr i ver de t u base de dat os
St r i ng dr i ver = " Tu Dr i ver " ;
/ / Rempl aza est a var i abl e con l a ur l de t u base de dat os
St r i ng ur l = " La URL de t u base de dat os" ;
Connect i on conexi on = nul l ;
t r y {
/ / Regi st r amos el manej ador
Cl ass. f or Name( dr i ver ) ;
/ / Est abl ecemos una conexi n con l a base de dat os
conexi on = Dr i ver Manager . get Connect i on( ur l , " user " ,
" " ) ;
5.2 Ejecutar las instrucciones SQL
Para ejecutar las instrucciones SQL debemos crear un objeto tipo Statment,
PreparedStatment o CallableStatment, dependiendo de si queremos ejecutar SQL, SQL
precompilado o instrucciones no-SQL. Para ello empleamos los mtodos definidos con
tal propsito en la interface Connection (ver seccin 5.3).
En nuestro caso ser un objeto tipo Statment: statment = conexion.createStatement(). A
continuacin ejecutamos las instrucciones SQL, empleando los mtodos
executeUpdate(String sql) para instrucciones tipo UPDATE, DELETE, INSERT o
instrucciones DDL. Para las intrusiones de tipo SELECT empleamos el mtodo Resulset
executeQuery(String sql).
El ABC de J DBC 21 de 36
Tutorial de javaHispano http://javahispano.org
En este caso primero se ejecuta una instruccin DDL, en la que se define una nueva
tabla en la base de datos, a continuacin creamos una serie de registros en la tabla, y
finalmente realizamos una consulta en la cual pedimos el campo NOMBRE de todos los
registros cuyo campo NIVEL_PARTICIPACION sea superior a 0.5.
/ / Cr eamos un obj et o St at ment que nos per mi t i r ej ecut ar
i nst r ucci ones SQL
st at ment = conexi on. cr eat eSt at ement ( ) ;
/ / Ej ecut amos una i nst r ucci n de DDL par a cr ear una t abl a
st at ment . execut eUpdat e( " cr eat e t abl e usuar i os" +
" ( NOMBRE var char ( 25) , " +
" LOGI N var char ( 15) , " +
" EDAD i nt , " +
" NI VEL_PARTI CI PACI ON f l oat ) " ) ;
/ / I nser t amos un gr upo de r egi st r os en l a t abl a
st at ment . execut eUpdat e(
" i nser t i nt o usuar i os val ues( ' Pepe' , ' pepe' , 23, 0. 64) " ) ;
El ABC de J DBC 22 de 36
Tutorial de javaHispano http://javahispano.org
En la Figura 7 mostramos la tabla que crean las sentencias SQL de este cdigo.
Figura 7 Tabla generada por el SQL del cdigo HolaMundoJDBC.java. A la Derecha
representamos el ResultSet obtenido por la sentencia SELECT de ese mismo cdigo.
5.3 Procesar los resultados
Tras realizar una consulta tipo SELECT obtenemos como resultado un conjunto de
registros, a los cuales podemos acceder mediante la interface Resulset. Esta provee una
serie de mtodos getXXX(columna) que permiten acceder a cada campo de cada
registro devuelto como respuesta a nuestra consulta.
Es importante conocer a qu tipo J ava se corresponde cada tipo SQL para saber
mediante qu mtodo debemos acceder al contenido de cada columna. En la Figura 8
mostramos la equivalencia entre los tipos de dato J ava y los tipos de datos SQL.
En nuestro cdigo la nica operacin que se realiza sobre los resultados es imprimirlos
por pantalla junto con un pequeo mensaje de agradecimiento. En un cdigo real
podran realizarse operaciones de todo tipo, inclusive operaciones que supongan
modificar registros en la base de datos, o ejecutar nuevamente consultas contra esta y
volver a procesar sus resultados.
El ABC de J DBC 23 de 36
Tutorial de javaHispano http://javahispano.org
Figura 8 Correspondencia entre tipos de dato Java y tipos de dato SQL
Debemos tener en cuenta siempre que cada objeto Resulset est ligado a su conexin,
por lo que si tenemos un objeto Resulset y ejecutamos una sentencia tipo SELECT los
resultados de la anterior consulta se perdern, si no hemos hecho una copia de ellos.
/ / Mi ent r as queden r esul t ados por pr ocesar
/ / Recuer da que next ( ) despl aza el cur sor del Resul set una
/ / posi ci n haci a del ant e cada vez que se i nvoca.
whi l e ( r esul set . next ( ) ) {
/ / Accedemos a l os r esgi st r os r esul t ado medi ant e l os mt odos
/ / get XXXX I ndi cando el nombr e de l a col umna
Syst em. out . pr i nt l n( r esul set . get St r i ng( " NOMBRE" ) +
" gr aci as por ser un usuar i o t an act i vo" ) ;
}
El ABC de J DBC 24 de 36
Tutorial de javaHispano http://javahispano.org
5.4 Liberar los recursos de la conexin
Una vez que hayamos terminado las operaciones que queramos realizar en la base de
datos debemos liberar todos los recursos que estaba consumiendo la conexin. Aunque
estos recursos son automticamente liberados por el GarbageCollector cundo sus
correspondientes objetos son eliminados, es buena practica liberarlos manualmente,
para que esta liberacin se produzca en cuanto dejan de ser tiles.
Los recursos que debemos liberar son el Resultset, el Statment y la propia conexin.
Para liberarlos debemos invocar al mtodo close() de sus correspondieres objetos.
Invocar al mtodo close() de Statment automticamente libera los recursos de su
ResultSet. Aqu tenemos el cdigo de HolaMundoJ DBC que libera los recursos.
/ / No nos ol vi demos de l i ber ar t odos l os r ecur sos que
hemos empl eado una vez
/ / que no necesi t emos l a conexi n: debemos l i ber ar t ant o
l os r ecur sos
/ / consumi dos por el Resul set , por l os St at ment empl eados
y l as pr opi as
/ / Conexi ones
t r y {
r esul set . cl ose( ) ;
st at ment . cl ose( ) ;
conexi on. cl ose( ) ;
}
El ABC de J DBC 25 de 36
Tutorial de javaHispano http://javahispano.org
5 Gestin de excepciones JDBC
En el ejemplo HolaMundoJ DBC.java tanto el cdigo para establecer la conexin, como
el cdigo que accede a la base de datos estn dentro de bloques try-catch. Todos los
mtodos definidos en las interfaces Connection, Statment y ResultSet, as como el
mtodo getConnection() de la clase DriverManager lanzan excepciones de tipo
java.sql.SQLException, por lo que todo el cdigo que de un u otro modo acceda a la
base de datos o procese los resultados de un acceso ha de estar dentro de una clausula
try/chatch, o bien ha de estar dentro de un mtodo que lance excepciones de tipo
SQLException.
5.1 La Clase SQLException
La excepcin SQLException tiene algunas caractersticas que la diferencian del resto de
las excepciones. Ms que una excepcin propiamente dicha, es una lista de excepciones
encadenadas. Muchos y muy distintos problemas pueden suceder en el servidor, y no
sera fcil almacenar toda la informacin correspondiente a todos los problemas en una
nica excepcin. Por ello la clase SQLException ha sido diseada como una cadena de
Excepciones, permitiendo almacenar informacin de todos los errores surgidos en la
operacin. Esta clase tiene un mtodo, getNextException(), que nos devuelve la
siguiente excepcin de la cadena , o null si no hay ms excepciones encadenadas.
El cdigo que mostramos a continuacin permite imprimir un cdigo de error del
fabricante de la base de datos, el mensaje de error, y la traza de todas las excepciones
encadenadas en una SQLException
cat ch ( SQLExcept i on e) {
do{
Syst em. out . pr i nt l n( e. get Er r or Code( ) ) ;
Syst em. out . pr i nt l n( e) ;
El ABC de J DBC 26 de 36
Tutorial de javaHispano http://javahispano.org
e. pr i nt St ackTr ace( ) ;
e = e. get Next Except i on( ) ;
}whi l e ( e ! = nul l ) ;
}
Las principales causas de que se produzcan excepciones SQL son:
1. Se pierde la conexin con la base de datos. Muchas cosas pueden ir mal cuando
la base de datos es remota y se accede a ella a travs de la red.
2. Se enva un comando SQL no vlido; por ejemplo, tecleamos wehere en vez
de where. En este sentido resulta muy til probar el SQL empleando alguna
interfaz grfica de nuestra base de datos antes de empotrarlo en el cdigo J ava.
3. Se hace referencia a una columna o tabla que no existen
4. Se emplea una funcin que no est soportada por la base de datos.
5.2 La clase SQLWarning
Es una subclase de SQLException. Un SQLWarning se genera cuando se produce un
error no fatal en la base de datos. Se encadenan igual que las excepciones SQL,
pudiendo acceder al siguiente SQLWarning de la cadena mediante el mtodo
getNextWarning().
A diferencia que las excepciones los warning no se lanzan, cuando queramos acceder a
ellos deberemos emplear el mtodo getWarnings(), que se haya definido en las
interfaces Connection, Statment y Resultset.
El ABC de J DBC 27 de 36
Tutorial de javaHispano http://javahispano.org
6 Metainformacin
El API J DBC nos permite acceder a metainformacin sobre la base de datos y sobre el
ResultSet generado por una consulta, es decir, a informacin a cerca de las
caractersticas (no del contenido) de la base de datos y del Resultset, informacin como
el nombre de la base de datos, la versin, el nmero y nombre de las columnas del
Resultset
La metainformacin de la base de datos est representada por un objeto que implementa
la interfaz java.sql.DatabaseMetaData, objeto al cual nos da acceso el mtodo
getMetaData() de la interface Connection. En DatabaseMetaData hay, por ejemplo
mtodos como getDriverName(), que nos devuelve el nombre del driver que estamos
empleando, getDriverVersion(), que nos devuelve la versin del driver,
getDatabaseProductName(), el nombre de la base de datos, getURL(), la URL de esta
base de datos
La metainformacin del ResultSet est representada por un objeto que implementa la
interfaz ResultSetMetaData, accesible mediante el mtodo getMataData() de la interfaz
ResultSet. En esta interfaz tenemos mtodos para, por ejemplo, averiguar el nmero de
columnas del ResultSet getColumnCount(), el nombre de cada columna,
getColumnName(int columna), saber si podemos escribir en una columna,
isWritable(int columna), clase J ava correspondiente a una columna,
getColumnClassName(int columna)
J unto con este tutorial se proporciona un cdigo llamado HolaMundoMetaData.java, en
el que se accede a una tabla llamada usuarios (supondremos que es la tabla que cre en
la base de datos el cdigo HolaMundoJ DBC), y se recupera toda la informacin de esa
tabla y le pasa el ResultSet semejante al mtodo imprimeConsulta(ResultSet), cuyo
cdigo se puede ver bajo estas lneas (en el se han omitido algunas lneas que nada
tienen que ver con el procesamiento del ResultSet, sino con la presentacin en pantalla).
En este cdigo se accede a la metainformacin del ResultSet para averiguar el nmero y
nombre de las columnas, y se imprime una tabla en la consola con el resultado.
El ABC de J DBC 28 de 36
Tutorial de javaHispano http://javahispano.org
publ i c st at i c voi d i mpr i meConsul t a( Resul t Set r esul t Set ) {
t r y {
/ / Obt enemos l a Met ai nf or maci n de Resul Set
Resul t Set Met aDat a r esul t Set Met aDat a =
r esul t Set . get Met aDat a( ) ;
/ / A par t i r de l a met ai nf or maci n obt enemos el nmer o de
col umnas
i nt numer oDeCol umnas =
r esul t Set Met aDat a. get Col umnCount ( ) ;
/ / Par a t odas l as col umnas
f or ( i nt i = 1; i <= numer oDeCol umnas; i ++) {
/ / Aver guamos cual es el nombr e de cada col umna
St r i ng nombr eDeLaCol umna =
r esul t Set Met aDat a. get Col umnName( i ) ;
st r i ngBuf f er . append( nombr eDeLaCol umna + " \ t " ) ;
}
/ / Ahor a r ecor r emos el r esul set i gual que en el pr i mer
ej empl o
whi l e ( r esul t Set . next ( ) ) {
/ / Accedesmoa a t odas l as col umnas del r egi st r o
f or ( i nt i = 1; i <= numer oDeCol umnas; i ++) {
/ / Acedesmos a t odas como St r i ng, aunque empl enado l a
met ai nf or maci n
/ / ser a posi bl e aver i guar que t i po de dat o es
st r i ngBuf f er . append( r esul t Set . get St r i ng( i ) + " \ t " ) ;
}
}
El ABC de J DBC 29 de 36
Tutorial de javaHispano http://javahispano.org
Syst em. out . pr i nt l n( st r i ngBuf f er . t oSt r i ng( ) ) ;
}
En la Figura 9 presentamos una captura de pantalla de la consola cuando se ejecuta este
cdigo y se le pasa como argumento el ResulSet generado por la instruccin "select *
from usuarios", siendo la tabla usuarios la tabla que se muestra en la Figura 7. En el
cdigo original hay ms sentencias que generan la parte de la presentacin que se
muestra en la imagen. En
http://www.javahispano.org/codesnippets.item.action?id=366233401 podis encontrar
un cdigo semejante al mtodo que imprime el resultado de la consulta en consola, pero
que en vez de imprimir en consola rellana un J Table, con la informacin del ResultSet.
Figura 9 Salida de pantalla del mtodo imprimeConsulta
El ABC de J DBC 30 de 36
Tutorial de javaHispano http://javahispano.org
7 Transacciones
Una transaccin es un conjunto de operaciones que deben de realizarse de un modo
atmico sobre la base de datos, esto es, o bien se realizan todas ellas correctamente, o
bien no se realiza ninguna. Las transacciones son importantes para mantener la
consistencia de la informacin en la base de datos. Imaginemos que tenemos un registro
en la tabla usuario, la clave primaria de este registro es referenciada por un registro en
una tabla llamada pedidos. Borrar a ese usuario implica borrar los pedidos que haya
hecho ese usuario; en este caso podemos hacerlo con dos instrucciones DELETE, una
sobre el registro del usuario y la otra sobre el pedido. Si la primera instruccin tiene
xito, y la segunda no, en la base de datos tendremos un pedido que referencia a un
usuario que no existe. Para evitar este problema podemos agrupar las dos operaciones
de borrado en una misma transaccin; de ese modo o eliminamos ambos registros o no
eliminados ninguno. En cualquier caso la informacin de la base de datos ser
consistente.
Para emplear transacciones con el API J DBC debemos invocar el mtodo
setAutocommit(false) de la interfaz Connection. Por defecto la interfaz Connection
ejecuta un commit, es decir, una confirmacin de los cambios realizados en la base de
datos, cada vez que ejecutamos una sentencia. Este mtodo nos permite activar y
desactivar este comportamiento.
A continuacin ejecutamos las operaciones que deseemos agrupar en una nica
transaccin, y finalmente, si queremos confirmar los cambios, invocamos el mtodo
commit(), del interfaz Statment. En ese momento los cambios realizados se harn
permanentes en la base de datos y se liberar cualquier tipo de bloqueo que haya
realizado esta conexin.
Si queremos cancelar los cambios invocamos al mtodo rollback(), tambin de la
interfaz Statment. Este mtodo deshace todos los cambios hechos en la base de datos
desde el ltimo commit o rollback y libera cualquier tipo de bloqueo que haya realizado
esta conexin. Cuando se gestionan las excepciones del cdigo transaccional, siempre
se suele poner un rollback en el catch, de ese modo si hay un error en la ejecucin de
alguna de las operaciones de la transaccin deshacemos los cambios de las que se
ejecutaron con xito.
El ABC de J DBC 31 de 36
Tutorial de javaHispano http://javahispano.org
J unto con el tutorial se distribuye un cdigo con nombre
HolaMundoTransacciones.java, en el cual se ejecutan varias operaciones sobre la tabla
de la Figura 7, operaciones que se muestra en la figura Figura 10. Primero se ejecuta un
mtodo llamado cancelaOperaciones(), que ejecuta una insercin, un borrado y una
actualizacin sobre la tabla. Finalmente se llama a rollback(), y se imprime la tabla por
consola. No ha cambios en ella, ya que los cancelamos al invocar a rollback().
Figura 10 Ejemplo de transacciones. Muestra las operaciones que se hacen en el cdigo
HolaMunodoTransacciones.java y sus efectos sobre la base de datos.
insert into usuarios values('Marta','mar',17, 0.33)
update usuarios set LOGIN ='pepepito' where nombre ='Pepe'
delete from usuarios where NOMBRE ='J uan'
insert into usuarios values('Marta','mar',17, 0.33)
update usuarios set LOGIN ='pepepito' where nombre ='Pepe'
delete from usuarios where NOMBRE ='J uan'
El ABC de J DBC 32 de 36
Tutorial de javaHispano http://javahispano.org
A continuacin se llama al mtodo ejecutaOperaciones(), que realiza las mismas
operaciones sobre la tabla, pero esta vez llama a commit(), con lo que s se hacen
permanentes los cambios en la base de datos. La tabla se vuelve a imprimir por consola
y vemos como efectivamente se han realizado los cambios.
Observad que en el cdigo, antes de ejecutar ninguna operacin, se ha desactivado el
modo autocommit de la conexin mediante el mtodo setAutocommit(false). Si no
hubisemos hecho esto aunque llamsemos a rollback() los cambios efectuados por el
mtodo cancelaOperaciones() se habran hecho permanentes.
A continuacin mostramos los fragmentos del cdigo de HolaMundoTransacciones.java
relacionados con el control de las transacciones.
publ i c st at i c voi d cancel aOper aci ones( St at ement st at ment ) {
t r y {
/ / Ej ecut amos var i as oper aci ones sobr e l a base de dat os.
st at ment . execut eUpdat e(
" i nser t i nt o usuar i os val ues( ' Mar t a' , ' mar ' , 17,
0. 33) " ) ;
st at ment . execut eUpdat e(
" updat e usuar i os SET LOGI N =' pepepi t o' wher e nombr e
= ' Pepe' " ) ;
st at ment . execut eUpdat e(
" del et e f r omusuar i os wher e NOMBRE =' J uan' " ) ;
/ / Obt enemos el Obj et o Conect i on de est e St at ment y
cancel amos l os cambi os
st at ment . get Connect i on( ) . r ol l back( ) ;
}
publ i c st at i c voi d ej ecut aOper aci ones( St at ement st at ment ) {
t r y {
El ABC de J DBC 33 de 36
Tutorial de javaHispano http://javahispano.org
/ / Ej ecut amos var i as oper aci ones sobr e l a base de dat os.
st at ment . execut eUpdat e(
" i nser t i nt o usuar i os val ues( ' Mar t a' , ' mar ' , 17,
0. 33) " ) ;
st at ment . execut eUpdat e(
" updat e usuar i os SET LOGI N =' pepepi t o' wher e nombr e
= ' Pepe' " ) ;
st at ment . execut eUpdat e(
" del et e f r omusuar i os wher e NOMBRE =' J uan' " ) ;
/ / Obt enemos el Obj et o Conect i on de est e St at ment y
cancel amos l os cambi os
st at ment . get Connect i on( ) . commi t ( ) ;
}
publ i c st at i c voi d mai n( St r i ng ar gs[ ] ) {