Primeiros passos no JDBC

O JDBC (Java Database Connectivity) que � uma biblioteca existente dentro da especificaç�o Java que cont�m um conjunto de interfaces e classes que est�o dentro do pacote java.sql que permitem a interaç�o e conectividade com banco de dados pela aplicaç�o, permitindo desenvolver queries espec�ficas para um determinado banco, por exemplo escrever uma estrutura de query com o dialeto do MySQL ou do Oracle.

Porque usar o JDBC

Quando utilizamos aplicaç�es, sejam elas empresariais ou comerciais, � importante armazenar ou recuperar as informaç�es geradas. Para isso o JDBC � eficaz para permitir a interaç�o e estabelecer conex�o com o banco de dados de forma eficiente. Al�m disso, com essa biblioteca poderemos executar operaç�es SQL como: Select (consultar), Update (atualizar), Delete (excluir) e Insert (incluir), al�m de permitir implementar objetos mais complexos como stored procedures, views, funç�es.

Componentes do JDBC

A biblioteca prov� muitos m�todos e interfaces para facilitar a comunicaç�o com os bancos de dados, divididos em dois pacotes, um espec�fico para plataforma Java SE e outro para a Java EE:

java.sql => Este pacote cont�m classes e m�todos para acesso a dados e processamento em um banco de dados relacional, este inclu�do em Java Standard Edition (Java SE);
javax.sql = > Este pacote amplia a funcionalidade do pacote java.sql implementando outras interfaces utilizadas em aplicaç�es do lado do servidor. Este segue especificaç�es da Java Enterprise Edition (Java EE).

Para que a aplicaç�o possa se conectar ao banco de dados � necess�rio adicionarmos o driver que far� essa implementaç�o, chamado de JDBC Driver manager (Gerenciador de driver JDBC). Com ele � poss�vel acessar um banco de dados espec�fico, isso significa que para acessar um banco Oracle, por exemplo, teremos que configurar um driver para esse banco, e assim para os demais.

Na Figura 1, temos uma representaç�o da estrutura de uma aplicaç�o utilizando JDBC.

Figura 1. Fluxo do JDBC em uma aplicaç�o Java

Podemos descrever esse fluxo da seguinte forma:

Na primeira camada temos a aplicaç�o Java, que pode ser desktop ou web, por exemplo;
Na segunda camada temos a API do JDBC, que cont�m classes e m�todos para permitir a escrita de queries ou chamar alguma stored procedure;
Na terceira camada temos o JDBC Driver Manager, que cont�m as classes e m�todos utilizados para configurar a aplicaç�o para conectar-se com o banco;
Na quarta camada e �ltima temos o driver espec�fico para cada banco de dados (SQL Server, Oracle, MySQL etc.) onde deveremos implementar um arquivo de biblioteca do tipo .jar.

Como implementar no projeto

Para implementarmos esse driver em nossos projetos existem v�rias formas. A mais comum atualmente � adicionar em um projeto Maven, no arquivo pom.xml, a depend�ncia para realizar o download da biblioteca.

No C�digo 1, temos um exemplo para incluir no arquivo de depend�ncia o driver para o banco MySQL.


<!--   https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.33</version>
</dependency>

C�digo 1. Depend�ncia que dever� ser adicionada no arquivo pom.xml utilizado em projetos Maven

Em seguida, teremos que realizar duas outras implementaç�es: fazer uma conex�o com o banco de dados e fazer uma consulta em uma tabela do projeto.


package br.com.exemplo.conexao;
   
 import java.sql.Connection;
 import java.sql.DriverManager;
 import java.sql.SQLException;
 import javax.naming.Context;
 import javax.naming.InitialContext;
 import javax.naming.NamingException;
 import javax.sql.DataSource;
   
 public class Conexao {
   private static Connection conexao = null;
   public static Connection getConnection()
   throws   InstantiationException, IllegalAccessException, ClassNotFoundException,   SQLException, NamingException {
   
     String url = "jdbc:mysql://localhost:3306/bancoExemplo";
     String user = "testeExemplo";
     String password = "exemplo";
     Class.forName("com.mysql.cj.jdbc.Driver").newInstance();
     conexao  = DriverManager.getConnection(url, user,   password);
     return conexao;
 }
 public static void close (){
   try {       
    conexao.close();
   } catch (SQLException e) {
      e.printStackTrace();
   }
  }
 }

C�digo 2. Exemplo de uma classe que faz a conex�o com o banco de dados

No C�digo 2, temos um exemplo de classe que faz a conex�o com o MySQL. Nele criamos um m�todo chamado getConnection, que cont�m a definiç�o de vari�veis que utilizamos para configurar o acesso a base de dados, al�m do pacote com.mysql.cj.jdbc.Driver, que � a biblioteca utilizada por esse banco. Detalharemos abaixo o que essas vari�veis e objetos significam:

private static Connection conexao = null => Instanciando objeto;
url => � a string de conex�o que cont�m o servidor do banco, porta que esse banco utiliza e nome da base de dados pelo se conectar�. Sempre � iniciada com jdbc:<<nome do driver>>. No caso do nosso exemplo seria mysql;
user => � o usu�rio que faz o acesso ao banco de dados;
password => � a senha utilizada para acessar o banco;
Class.forName => � a inst�ncia que ser� criada a partir do driver do MySQL;
conexao => receber� do m�todo getConnection da classe DriverManager as informaç�es para acesso ao banco que nos permitir� executar as queries.

Al�m disso, temos outro m�todo chamado close que deveremos executar ao final de uma execuç�o de query para encerrar uma conex�o de banco aberta sempre que chamamos o m�todo getConnection. � importante sempre finalizar as conex�es de banco, pois geralmente problemas de lentid�o s�o devido ao excesso de conex�es que foram abertas e esquecidas.


package br.com.exemplo.BD;
   
 import java.sql.Connection;
 import java.sql.PreparedStatement;
 import java.sql.ResultSet;
 import java.sql.SQLException;
 import javax.naming.NamingException;
 import br.com.exemplo.conexao.Conexao;
 import br.com.exemplo.modelo.Grupo;
 
  public class GrupoBD {
    public Grupo   obterGrupo(Integer idGrupo)  {
      Grupo grupo = new Grupo();
         
      try {
        Connection conn =   Conexao.getConnection();
        PreparedStatement st_grupo =   conn.prepareStatement("SELECT   id_grupo, nmGrupo FROM grupo WHERE id_grupo = ? ");
        st_grupo.setInt(1, idGrupo);
        ResultSet rsGrupo =   st_grupo.executeQuery();
   
        if (rsGrupo.first()) {
   
          grupo.setIdGrupo(rsGrupo.getInt("id_grupo"));
          grupo.setNmGrupo(rsGrupo.getString("nmGrupo"));
        }
                     
   
      } catch (SQLException |   InstantiationException | IllegalAccessException | ClassNotFoundException |   NamingException e) {
         e.printStackTrace();
      } finally {
         try {
           if(rsGrupo   != null) rsGrupo.close();
           if(st_grupo != null)   st_grupo.close();
           if(conn   != null) conn.close();       
        } catch   (SQLException e) {
           throw new SystemException(e.getMessage());
        }
      }  
      return   grupo;        
   }
 }

C�digo 3. Exemplo de uma classe que faz uma consulta em uma tabela

No C�digo 3, exemplificamos a classe grupoDB com o m�todo em que executamos um select para obter os dados da tabela grupo.

Neste caso escrevemos essa estrutura para obter essas informaç�es atrav�s de um resultset, que ser� atribu�do ao objeto grupo que retornar� para a aplicaç�o. Detalharemos a seguir as linhas do c�digo para melhor entendimento:

Grupo grupo = new Grupo() => Instanciando objeto;
Connection conn = Conexao.getConnection() => estamos abrindo a conex�o criada no C�digo 2;
PreparedStatement st_grupo = conn.prepareStatement("SELECT id_grupo, nmGrupo FROM grupo WHERE id_grupo = ? ") => permite utilizarmos a query que ser� executada. Quando queremos utilizar um par�metro colocamos ? para informar que o valor da condiç�o vir� de uma vari�vel;
st_grupo.setInt(1, idGrupo) => informaremos ao PreparedStatement o par�metro que ser� substitu�do no "?" ao executar a query;
ResultSet rsGrupo = st_grupo.executeQuery() => ser� executada a query que ser� retornada para um tipo ResultSet para obter o resultado da consulta;
No bloco abaixo obtemos o retorno da nossa consulta utilizando rsGrupo.first(), pois queremos obter a primeira linha encontrada. Como podemos observar, temos duas colunas (id_grupo e nmGrupo) para cada linha correspondente a um atributo do objeto grupo:
if (rsGrupo.first()) { grupo.setIdGrupo(rsGrupo.getInt("id_grupo")); grupo.setNmGrupo(rsGrupo.getString("nmGrupo")); }
Temos o bloco importante no C�digo 3 do finally, onde finalizamos todos os objetos abertos durante a execuç�o da query, evitando manter esses objetos abertos que com o tempo degradar�o a performance da aplicaç�o, principalmente a conex�o ao banco de dados:
} finally { try { if(rsGrupo != null) rsGrupo.close(); if(st_grupo != null) st_grupo.close(); if(conn != null) conn.close(); } catch (SQLException e) { throw new SystemException(e.getMessage()); } }

Conclus�o

O JDBC � uma implementaç�o muito importante para utilizarmos em um projeto Java, pois permite conectar com diversos bancos de dados existentes no mercado, al�m de possuir um conjunto de interfaces e m�todos para executarmos queries utilizando o dialeto SQL que cada banco entende, al�m de outros objetos de banco como stored procedures, views ou funç�es. Neste artigo fizemos uma pequena introduç�o do que essa biblioteca tem a oferecer.

Introdu��o ao JDBC

Neste artigo, iniciaremos os estudos de uma biblioteca muito utilizada em diversas aplicações escritas em Java, que é a JDBC. Entenderemos o seu conceito, por que utilizar, como é estruturado e um pequeno exemplo de como implementar.

Porque usar o JDBC

Componentes do JDBC

Como implementar no projeto

Conclus�o

Artigos relacionados