JDBC - Guía rápida
¿Qué es JDBC?
JDBC son las siglas de Java DatabPlaza bursátil norteamericana Connectivity, que es una API estándar de Java para la conectividad independiente de la base de datos entre el lenguaje de programación Java y una amplia gama de bases de datos.
La biblioteca JDBC incluye API para cada una de las tareas comúnmente asociadas con el uso de la base de datos:
Hacer una conexión a una base de datos
Creando declaraciones SQL o MySQL
Ejecutando esas consultas SQL o MySQL en la base de datos
Ver y modificar los registros resultantes
Requisito previo:
Debe tener un buen conocimiento de los dos temas siguientes para aprender JDBC:
Programación Core JAVA
Base de datos SQL o MySQL
JDBC - Configuración del entorno:
Asegúrese de haber realizado la siguiente configuración:
Instalación de Core JAVA
Instalación de base de datos SQL o MySQL
Aparte de lo anterior, necesita configurar una base de datos que usaría para su proyecto. Suponiendo que esto es EMP y ha creado en la tabla Empleados dentro de la misma base de datos.
Creación de la aplicación JDBC:
Hay seis pasos involucrados en la construcción de una aplicación JDBC que voy a resumir en este tutorial:
Importar los paquetes:
Esto requiere que incluya los paquetes que contienen las clases JDBC necesarias para la programación de la base de datos. La mayoría de las veces, usar import java.sql. * Será suficiente de la siguiente manera:
//STEP 1. Import required packages
import java.sql.*;
Registre el controlador JDBC:
Esto requiere que inicialice un controlador para poder abrir un canal de comunicaciones con la base de datos. A continuación se muestra el fragmento de código para lograr esto:
//STEP 2: Register JDBC driver
Class.forName("com.mysql.jdbc.Driver");
Abra una conexión:
Esto requiere usar el método DriverManager.getConnection () para crear un objeto Connection, que representa una conexión física con la base de datos de la siguiente manera:
//STEP 3: Open a connection
// Database credentials
static final String USER = "username";
static final String PASS = "password";
System.out.println("Connecting to database...");
conn = DriverManager.getConnection(DB_URL,USER,PASS);
Ejecuta una consulta:
Esto requiere el uso de un objeto de tipo Statement o PreparedStatement para crear y enviar una sentencia SQL a la base de datos de la siguiente manera:
//STEP 4: Execute a query
System.out.println("Creating statement...");
stmt = conn.createStatement();
String sql;
sql = "SELECT id, first, last, age FROM Employees";
ResultSet rs = stmt.executeQuery(sql);
Si se requiere una declaración SQL UPDATE, INSERT o DELETE, se necesitará el siguiente fragmento de código:
//STEP 4: Execute a query
System.out.println("Creating statement...");
stmt = conn.createStatement();
String sql;
sql = "DELETE FROM Employees";
ResultSet rs = stmt.executeUpdate(sql);
Extraiga datos del conjunto de resultados:
Este paso es necesario en caso de que esté obteniendo datos de la base de datos. Puede utilizar el método ResultSet.getXXX () apropiado para recuperar los datos del conjunto de resultados de la siguiente manera:
//STEP 5: Extract data from result set
while(rs.next()){
//Retrieve by column name
int id = rs.getInt("id");
int age = rs.getInt("age");
String first = rs.getString("first");
String last = rs.getString("last");
//Display values
System.out.print("ID: " + id);
System.out.print(", Age: " + age);
System.out.print(", First: " + first);
System.out.println(", Last: " + last);
}
Limpiar el medio ambiente:
Debe cerrar explícitamente todos los recursos de la base de datos en lugar de confiar en la recolección de basura de la JVM de la siguiente manera:
//STEP 6: Clean-up environment
rs.close();
stmt.close();
conn.close();
Primer programa JDBC:
Según los pasos anteriores, podemos tener el siguiente código de muestra consolidado que podemos usar como plantilla mientras escribimos nuestro código JDBC:
Este código de muestra se ha escrito en función del entorno y la configuración de la base de datos realizada en el capítulo Medio ambiente.
//STEP 1. Import required packages
import java.sql.*;
public class FirstExample {
// JDBC driver name and database URL
static final String JDBC_DRIVER = "com.mysql.jdbc.Driver";
static final String DB_URL = "jdbc:mysql://localhost/EMP";
// Database credentials
static final String USER = "username";
static final String PASS = "password";
public static void main(String[] args) {
Connection conn = null;
Statement stmt = null;
try{
//STEP 2: Register JDBC driver
Class.forName("com.mysql.jdbc.Driver");
//STEP 3: Open a connection
System.out.println("Connecting to database...");
conn = DriverManager.getConnection(DB_URL,USER,PASS);
//STEP 4: Execute a query
System.out.println("Creating statement...");
stmt = conn.createStatement();
String sql;
sql = "SELECT id, first, last, age FROM Employees";
ResultSet rs = stmt.executeQuery(sql);
//STEP 5: Extract data from result set
while(rs.next()){
//Retrieve by column name
int id = rs.getInt("id");
int age = rs.getInt("age");
String first = rs.getString("first");
String last = rs.getString("last");
//Display values
System.out.print("ID: " + id);
System.out.print(", Age: " + age);
System.out.print(", First: " + first);
System.out.println(", Last: " + last);
}
//STEP 6: Clean-up environment
rs.close();
stmt.close();
conn.close();
}catch(SQLException se){
//Handle errors for JDBC
se.printStackTrace();
}catch(Exception e){
//Handle errors for Class.forName
e.printStackTrace();
}finally{
//finally block used to close resources
try{
if(stmt!=null)
stmt.close();
}catch(SQLException se2){
}// nothing we can do
try{
if(conn!=null)
conn.close();
}catch(SQLException se){
se.printStackTrace();
}//end finally try
}//end try
System.out.println("Goodbye!");
}//end main
}//end FirstExample
Ahora compilemos el ejemplo anterior de la siguiente manera:
C:\>javac FirstExample.java
C:\>
Cuando corres FirstExample, produce el siguiente resultado:
C:\>java FirstExample
Connecting to database...
Creating statement...
ID: 100, Age: 18, First: Zara, Last: Ali
ID: 101, Age: 25, First: Mahnaz, Last: Fatma
ID: 102, Age: 30, First: Zaid, Last: Khan
ID: 103, Age: 28, First: Sumit, Last: Mittal
C:\>
Métodos de SQLException:
Una SQLException puede ocurrir tanto en el controlador como en la base de datos. Cuando ocurre una excepción de este tipo, un objeto de tipo SQLException se pasará a la cláusula catch.
El objeto SQLException pasado tiene los siguientes métodos disponibles para recuperar información adicional sobre la excepción:
Método | Descripción |
---|---|
getErrorCode () | Obtiene el número de error asociado con la excepción. |
getMessage () | Obtiene el mensaje de error del controlador JDBC para un error manejado por el controlador u obtiene el número de error de Oracle y el mensaje para un error de base de datos. |
getSQLState () | Obtiene la cadena XOPEN SQLstate. En el caso de un error del controlador JDBC, este método no devuelve información útil. Para un error de base de datos, se devuelve el código XOPEN SQLstate de cinco dígitos. Este método puede devolver un valor nulo. |
getNextException () | Obtiene el siguiente objeto de excepción en la cadena de excepciones. |
printStackTrace () | Imprime la excepción actual, o arrojable, y su seguimiento en un flujo de error estándar. |
printStackTrace (PrintStream s) | Imprime este elemento desechable y su seguimiento en el flujo de impresión que especifique. |
printStackTrace (PrintWriter w) | Imprime este elemento desechable y su seguimiento en el escritor de impresión que especifique. |
Al utilizar la información disponible del objeto Exception, puede detectar una excepción y continuar con su programa de manera adecuada. Aquí está la forma general de un bloque try:
try {
// Your risky code goes between these curly braces!!!
}
catch(Exception ex) {
// Your exception handling code goes between these
// curly braces, similar to the exception clause
// in a PL/SQL block.
}
finally {
// Your must-always-be-executed code goes between these
// curly braces. Like closing database connection.
}
JDBC - Tipos de datos:
La siguiente tabla resume el tipo de datos JDBC predeterminado al que se convierte el tipo de datos Java cuando llama al método setXXX () del objeto PreparedStatement o CallableStatement o al método ResultSet.updateXXX ().
SQL | JDBC / Java | setXXX | updateXXX |
---|---|---|---|
VARCHAR | java.lang.String | setString | updateString |
CARBONIZARSE | java.lang.String | setString | updateString |
LONGVARCHAR | java.lang.String | setString | updateString |
POCO | booleano | setBoolean | updateBoolean |
NUMÉRICO | java.math.BigDecimal | setBigDecimal | updateBigDecimal |
TINYINT | byte | setByte | updateByte |
PEQUEÑO | corto | setShort | updateShort |
ENTERO | En t | setInt | updateInt |
EMPEZANDO | largo | setLong | updateLong |
REAL | flotador | setFloat | updateFloat |
FLOTADOR | flotador | setFloat | updateFloat |
DOBLE | doble | setDouble | updateDouble |
VARBINARIO | byte [] | setBytes | updateBytes |
BINARIO | byte [] | setBytes | updateBytes |
FECHA | java.sql.Date | define la fecha | fecha de actualización |
HORA | java.sql.Time | fijar tiempo | tiempo de actualizacion |
TIMESTAMP | java.sql.Timestamp | setTimestamp | updateTimestamp |
CLOB | java.sql.Clob | setClob | updateClob |
GOTA | java.sql.Blob | setBlob | updateBlob |
FORMACIÓN | java.sql.Array | setARRAY | updateARRAY |
ÁRBITRO | java.sql.Ref | SetRef | updateRef |
ESTRUCTURA | java.sql.Struct | SetStruct | updateStruct |
JDBC 3.0 tiene soporte mejorado para los tipos de datos BLOB, CLOB, ARRAY y REF. El objeto ResultSet ahora tiene métodos updateBLOB (), updateCLOB (), updateArray () y updateRef () que le permiten manipular directamente los datos respectivos en el servidor.
Los métodos setXXX () y updateXXX () le permiten convertir tipos específicos de Java en tipos de datos JDBC específicos. Los métodos setObject () y updateObject () le permiten mapear casi cualquier tipo de Java a un tipo de datos JDBC.
El objeto ResultSet proporciona el método getXXX () correspondiente para cada tipo de datos para recuperar el valor de la columna. Cada método se puede utilizar con el nombre de la columna o por su posición ordinal.
SQL | JDBC / Java | setXXX | getXXX |
---|---|---|---|
VARCHAR | java.lang.String | setString | getString |
CARBONIZARSE | java.lang.String | setString | getString |
LONGVARCHAR | java.lang.String | setString | getString |
POCO | booleano | setBoolean | getBoolean |
NUMÉRICO | java.math.BigDecimal | setBigDecimal | getBigDecimal |
TINYINT | byte | setByte | getByte |
PEQUEÑO | corto | setShort | getShort |
ENTERO | En t | setInt | getInt |
EMPEZANDO | largo | setLong | getLong |
REAL | flotador | setFloat | getFloat |
FLOTADOR | flotador | setFloat | getFloat |
DOBLE | doble | setDouble | getDouble |
VARBINARIO | byte [] | setBytes | getBytes |
BINARIO | byte [] | setBytes | getBytes |
FECHA | java.sql.Date | define la fecha | obtener la fecha |
HORA | java.sql.Time | fijar tiempo | consigue tiempo |
TIMESTAMP | java.sql.Timestamp | setTimestamp | getTimestamp |
CLOB | java.sql.Clob | setClob | getClob |
GOTA | java.sql.Blob | setBlob | getBlob |
FORMACIÓN | java.sql.Array | setARRAY | getARRAY |
ÁRBITRO | java.sql.Ref | SetRef | getRef |
ESTRUCTURA | java.sql.Struct | SetStruct | getStruct |
JDBC - Procesamiento por lotes:
El procesamiento por lotes le permite agrupar declaraciones SQL relacionadas en un lote y enviarlas con una llamada a la base de datos.
Cuando envía varias declaraciones SQL a la base de datos a la vez, reduce la cantidad de sobrecarga de comunicación, mejorando así el rendimiento.
Los controladores JDBC no son necesarios para admitir esta función. Debe utilizar el método DatabaseMetaData.supportsBatchUpdates () para determinar si la base de datos de destino admite el procesamiento de actualizaciones por lotes. El método devuelve verdadero si su controlador JDBC admite esta función.
los addBatch()El método Statement, PreparedStatement y CallableStatement se utiliza para agregar declaraciones individuales al lote. losexecuteBatch() se utiliza para iniciar la ejecución de todas las declaraciones agrupadas.
los executeBatch() devuelve una matriz de enteros, y cada elemento de la matriz representa el recuento de actualizaciones para la declaración de actualización respectiva.
Así como puede agregar declaraciones a un lote para su procesamiento, puede eliminarlas con el clearBatch()método. Este método elimina todas las declaraciones que agregó con el método addBatch (). Sin embargo, no puede elegir de forma selectiva qué declaración eliminar.
JDBC - Transmisión de datos:
Un objeto PreparedStatement tiene la capacidad de usar flujos de entrada y salida para suministrar datos de parámetros. Esto le permite colocar archivos completos en columnas de base de datos que pueden contener valores grandes, como tipos de datos CLOB y BLOB.
Existen los siguientes métodos que se pueden utilizar para transmitir datos:
setAsciiStream(): Este método se utiliza para proporcionar valores ASCII grandes.
setCharacterStream(): Este método se utiliza para proporcionar valores UNICODE grandes.
setBinaryStream(): Este método se utiliza para proporcionar valores binarios grandes.
El método setXXXStream () requiere un parámetro adicional, el tamaño del archivo, además del marcador de posición del parámetro. Este parámetro informa al conductor cuántos datos deben enviarse a la base de datos mediante el flujo.
Para obtener detalles sobre todos estos conceptos, debe seguir el tutorial completo.