JDBC - Tratamento de exceções

O tratamento de exceções permite lidar com condições excepcionais, como erros definidos pelo programa, de maneira controlada.

Quando ocorre uma condição de exceção, uma exceção é lançada. O termo lançado significa que a execução do programa atual é interrompida e o controle é redirecionado para a cláusula catch aplicável mais próxima. Se nenhuma cláusula catch aplicável existir, a execução do programa será encerrada.

O tratamento de exceções JDBC é muito semelhante ao tratamento de exceções Java, mas para JDBC, a exceção mais comum com a qual você lidará é java.sql.SQLException.

Métodos SQLException

Uma SQLException pode ocorrer no driver e no banco de dados. Quando tal exceção ocorrer, um objeto do tipo SQLException será passado para a cláusula catch.

O objeto SQLException passado tem os seguintes métodos disponíveis para recuperar informações adicionais sobre a exceção -

Método Descrição
getErrorCode () Obtém o número do erro associado à exceção.
getMessage () Obtém a mensagem de erro do driver JDBC para um erro, tratada pelo driver ou obtém o número do erro Oracle e a mensagem para um erro de banco de dados.
getSQLState () Obtém a string XOPEN SQLstate. Para um erro do driver JDBC, nenhuma informação útil é retornada deste método. Para um erro de banco de dados, o código XOPEN SQLstate de cinco dígitos é retornado. Este método pode retornar nulo.
getNextException () Obtém o próximo objeto Exception na cadeia de exceções.
printStackTrace () Imprime a exceção atual, ou lançável, e faz o backtrace para um fluxo de erro padrão.
printStackTrace (PrintStream s) Imprime este lançável e seu backtrace para o fluxo de impressão que você especificar.
printStackTrace (PrintWriter w) Imprime isso e é rastreado até o escritor de impressão que você especificar.

Utilizando as informações disponíveis no objeto Exception, você pode capturar uma exceção e continuar seu programa de maneira apropriada. Aqui está a forma geral de um bloco 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.
}

Exemplo

Estude o seguinte código de exemplo para entender o uso de try....catch...finally blocos.

//STEP 1. Import required packages
import java.sql.*;

public class JDBCExample {
   // 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;
   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...");
      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(conn!=null)
            conn.close();
      }catch(SQLException se){
         se.printStackTrace();
      }//end finally try
   }//end try
   System.out.println("Goodbye!");
}//end main
}//end JDBCExample

Agora, vamos compilar o exemplo acima da seguinte maneira -

C:\>javac JDBCExample.java
C:\>

Quando você corre JDBCExample, ele produz o seguinte resultado se não houver problema, caso contrário, o erro correspondente seria detectado e a mensagem de erro seria exibida -

C:\>java JDBCExample
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:\>

Tente o exemplo acima passando o nome do banco de dados ou nome de usuário ou senha incorretos e verifique o resultado.