Visão Geral do JDBC

O JDBC (Java Database Connectivity) é a API padrão da plataforma Java projetada para comunicação independente de banco de dados com sistemas de gerenciamento de bancos de dados relacionais (SGBDR). Ele fornece os métodos necessários para consultar e atualizar dados, atuando como uma camada de abstração entre a aplicação Java e o SGBDR.

Ciclo de Vida da Conexão

O fluxo padrão para interagir com o banco de dados de forma estruturada envolve as seguintes etapas fundamentais:

• Carregamento e registro do driver JDBC específico do SGBDR.
• Estabelecimento da sessão de conexão com o banco de dados.
• Criação de um objeto para execução de instruções SQL (Statement ou PreparedStatement).
• Execução da query e processamento do conjunto de resultados (ResultSet), quando aplicável.
• Liberação e fechamento rigoroso de todos os recursos abertos para evitar vazamentos de memória e conexões órfãs.

Configuração do Ambiente

Para utilizar o JDBC com MySQL em um projeto gerenciado por Maven, é necessário incluir a dependência do driver oficial. Abaixo está a configuração atualizada para o conector MySQL 8:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.enterprise.data</groupId>
    <artifactId>jdbc-core-operations</artifactId>
    <version>2.0.0</version>
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <version>8.0.33</version>
        </dependency>
    </dependencies>
</project>

Operação de Leitura (SELECT)

Para recuperar dados, utilizamos o Statement ou PreparedStatement junto com o método executeQuery. A implementação moderna em Java utiliza o bloco try-with-resources para garantir o fechamento automático e seguro dos recursos.

package com.enterprise.data.jdbc;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.Statement;
import java.sql.SQLException;

public class JdbcSelectOperation {

    private static final String DB_URL = "jdbc:mysql://localhost:3306/enterprise_db?useSSL=false&serverTimezone=UTC";
    private static final String DB_USER = "admin";
    private static final String DB_PASSWORD = "secure_password";

    public static void main(String[] args) {
        String query = "SELECT account_id, login_name, access_level FROM system_users";

        try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASSWORD);
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery(query)) {

            while (rs.next()) {
                int id = rs.getInt("account_id");
                String login = rs.getString("login_name");
                int level = rs.getInt("access_level");
                System.out.printf("User[ID: %d, Login: %s, Level: %d]%n", id, login, level);
            }
        } catch (SQLException e) {
            System.err.println("Erro ao executar a consulta: " + e.getMessage());
        }
    }
}

Operação de Escrita (INSERT)

Para operações de manipulação de dados (DML) que envolvem parâmetros dinâmicos, o uso de PreparedStatement é altamente recomendado para prevenir injeção de SQL e otimizar a execução no lado do banco de dados.

package com.enterprise.data.jdbc;

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;

public class JdbcInsertOperation {

    private static final String DB_URL = "jdbc:mysql://localhost:3306/enterprise_db?useSSL=false&serverTimezone=UTC";
    private static final String DB_USER = "admin";
    private static final String DB_PASSWORD = "secure_password";

    public static void main(String[] args) {
        String insertSql = "INSERT INTO system_users (account_id, login_name, access_level) VALUES (?, ?, ?)";

        try (Connection conn = DriverManager.getConnection(DB_URL, DB_USER, DB_PASSWORD);
             PreparedStatement pstmt = conn.prepareStatement(insertSql)) {

            pstmt.setInt(1, 1001);
            pstmt.setString(2, "new_user_01");
            pstmt.setInt(3, 2);

            int affectedRows = pstmt.executeUpdate();
            if (affectedRows > 0) {
                System.out.println("Registro inserido com sucesso. Linhas afetadas: " + affectedRows);
            }
        } catch (SQLException e) {
            System.err.println("Falha na operação de inserção: " + e.getMessage());
        }
    }
}