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.