Interface ResultSetHandler

o org.apache.commons.dbutils.ResultSetHandler interface é responsável por converter ResultSets em objetos.

Declaração de Classe

A seguir está a declaração para a classe org.apache.commons.dbutils.ResultSetHandler -

public interface ResultSetHandler<T>

Uso

  • Step 1 - Crie um objeto de conexão.

  • Step 2 - Criar implementação de ResultSetHandler.

  • Step 3 - Passe resultSetHandler para o objeto QueryRunner e faça operações de banco de dados.

Exemplo

O exemplo a seguir demonstrará como mapear um registro usando a classe ResultSetHandler. Leremos um dos registros disponíveis na Tabela de funcionários.

Sintaxe

Employee emp = queryRunner.query(conn, "SELECT * FROM employees WHERE first=?", resultHandler, "Sumit");

Onde,

  • resultHandler - Objeto ResultSetHandler para mapear o conjunto de resultados para o objeto Employee.

  • queryRunner - Objeto QueryRunner para ler objetos de funcionários do banco de dados.

Para entender os conceitos mencionados acima relacionados aos DBUtils, vamos escrever um exemplo que irá executar uma consulta de leitura. Para escrever nosso exemplo, vamos criar um aplicativo de amostra.

Degrau Descrição
1 Atualize o arquivo MainApp.java criado no capítulo DBUtils - Primeiro Aplicativo .
2 Compile e execute o aplicativo conforme explicado a seguir.

A seguir está o conteúdo do Employee.java.

public class Employee {
   private int id;
   private int age;
   private String first;
   private String last;
   public int getId() {
      return id;
   }
   public void setId(int id) {
      this.id = id;
   }
   public int getAge() {
      return age;
   }
   public void setAge(int age) {
      this.age = age;
   }
   public String getFirst() {
      return first;
   }
   public void setFirst(String first) {
      this.first = first;
   }
   public String getLast() {
      return last;
   }
   public void setLast(String last) {
      this.last = last;
   }
}

A seguir está o conteúdo do MainApp.java Arquivo.

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.sql.ResultSet;
import java.sql.ResultSetMetaData;
import java.util.Arrays;

import org.apache.commons.dbutils.DbUtils;
import org.apache.commons.dbutils.QueryRunner;
import org.apache.commons.dbutils.ResultSetHandler;

public class MainApp {
   // JDBC driver name and database URL
   static final String JDBC_DRIVER = "com.mysql.jdbc.Driver";  
   static final String DB_URL = "jdbc:mysql://localhost:3306/emp";

   //  Database credentials
   static final String USER = "root";
   static final String PASS = "admin";

   public static void main(String[] args) throws SQLException {
      Connection conn = null;
      QueryRunner queryRunner = new QueryRunner();
      
      //Step 1: Register JDBC driver
      DbUtils.loadDriver(JDBC_DRIVER);

      //Step 2: Open a connection
      System.out.println("Connecting to database...");
      conn = DriverManager.getConnection(DB_URL, USER, PASS);

      //Step 3: Create a ResultSet Handler to handle Employee Beans
      ResultSetHandler<Object[]> handler = new ResultSetHandler<Object[]>() {
         public Object[] handle(ResultSet rs) throws SQLException {
            if (!rs.next()) {
               return null;
            }
            ResultSetMetaData meta = rs.getMetaData();
            int cols = meta.getColumnCount();
            Object[] result = new Object[cols];

            for (int i = 0; i < cols; i++) {
               result[i] = rs.getObject(i + 1);
            }
            return result;
         }
      };

      try {
         Object[] result  = queryRunner.query(conn, "SELECT * FROM employees WHERE id=?",
            handler, 103);
         //Display values
         System.out.print("Result: " + Arrays.toString(result));            
      } finally {
         DbUtils.close(conn);
      }              
   }
}

Quando terminar de criar os arquivos de origem, vamos executar o aplicativo. Se tudo estiver bem com o seu aplicativo, ele imprimirá a seguinte mensagem.

Connecting to database...
Result: [103, 33, Sumit, Mittal]