Чем является JDBC: реализацией или спецификацией?

JDBC: спецификация, API и реализация

JDBC (Java Database Connectivity) является спецификацией и API, а не конкретной реализацией. Это важное различие для понимания архитектуры.

Что такое JDBC

JDBC — это спецификация

• Определяет контракт (интерфейсы) для работы с базами данных
• Разработана Oracle (ранее Sun Microsystems)
• Входит в Java SE (Java 8, 11, 17 и т.д.)
• Описана в javax.sql пакете

Реализация приходит от производителей БД

Каждый производитель БД поставляет JDBC Driver, который реализует спецификацию:

JDBC Specification
    ↓
    ├─ PostgreSQL JDBC Driver (от PostgreSQL)
    ├─ MySQL Connector/J (от MySQL)
    ├─ Oracle JDBC Driver (от Oracle)
    ├─ SQL Server JDBC Driver (от Microsoft)
    └─ SQLite JDBC Driver (от сообщества)

Архитектура JDBC

Уровень 1: Ваше приложение

public class UserRepository {
  public List<User> findAll() {
    // Используете JDBC API (спецификация)
    Connection conn = DriverManager.getConnection(connectionString);
    Statement stmt = conn.createStatement();
    ResultSet rs = stmt.executeQuery("SELECT * FROM users");
    // ...
  }
}

Уровень 2: JDBC API (спецификация)

// java.sql пакет — это спецификация
public interface Connection { ... }
public interface Statement { ... }
public interface ResultSet { ... }
public interface Driver { ... }

Уровень 3: JDBC Driver (реализация)

PostgreSQL Driver
  ├─ implements Connection
  ├─ implements Statement
  ├─ implements ResultSet
  └─ реализует протокол общения с PostgreSQL

Уровень 4: База данных

PostgreSQL Server
MySQL Server
Oracle Database

Примеры JDBC Drivers

PostgreSQL JDBC Driver

<dependency>
  <groupId>org.postgresql</groupId>
  <artifactId>postgresql</artifactId>
  <version>42.7.1</version>
</dependency>

public class PostgresExample {
  public static void main(String[] args) throws SQLException {
    // JDBC API (спецификация)
    Connection conn = DriverManager.getConnection(
      "jdbc:postgresql://localhost:5432/mydb",
      "user",
      "password"
    );
    
    // Реализация от PostgreSQL
    PreparedStatement stmt = conn.prepareStatement(
      "SELECT * FROM users WHERE id = ?"
    );
    stmt.setInt(1, 1);
    ResultSet rs = stmt.executeQuery();
    
    while (rs.next()) {
      String name = rs.getString("name");
    }
  }
}

MySQL JDBC Driver

<dependency>
  <groupId>com.mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.33</version>
</dependency>

Connection conn = DriverManager.getConnection(
  "jdbc:mysql://localhost:3306/mydb",
  "user",
  "password"
);

Oracle JDBC Driver

Connection conn = DriverManager.getConnection(
  "jdbc:oracle:thin:@localhost:1521:XE",
  "user",
  "password"
);

Ключевое различие: спецификация vs реализация

JDBC — спецификация

// Этот код одинаков для всех БД
public List<User> findUsers() {
  try (Connection conn = getConnection();
       Statement stmt = conn.createStatement();
       ResultSet rs = stmt.executeQuery("SELECT * FROM users")) {
    
    List<User> users = new ArrayList<>();
    while (rs.next()) {
      users.add(new User(
        rs.getInt("id"),
        rs.getString("name")
      ));
    }
    return users;
  }
}

Driver — реализация (меняется для каждой БД)

// Одна строка меняется в зависимости от БД
// PostgreSQL
String url = "jdbc:postgresql://localhost:5432/mydb";

// MySQL
String url = "jdbc:mysql://localhost:3306/mydb";

// Oracle
String url = "jdbc:oracle:thin:@localhost:1521:XE";

// Остальной код одинаков!

JDBC в современной разработке

1. Raw JDBC (редко используется)

public class UserRepositoryJDBC {
  public User findById(Long id) throws SQLException {
    String sql = "SELECT * FROM users WHERE id = ?";
    try (Connection conn = getConnection();
         PreparedStatement stmt = conn.prepareStatement(sql)) {
      
      stmt.setLong(1, id);
      ResultSet rs = stmt.executeQuery();
      if (rs.next()) {
        return mapToUser(rs);
      }
    }
    return null;
  }
}

2. JdbcTemplate (Spring, рекомендуется)

@Repository
public class UserRepositorySpring {
  @Autowired
  private JdbcTemplate jdbcTemplate;
  
  public User findById(Long id) {
    String sql = "SELECT * FROM users WHERE id = ?";
    return jdbcTemplate.queryForObject(sql, 
      (rs, rowNum) -> mapToUser(rs),
      id
    );
  }
}

3. JPA/Hibernate (ORM, использует JDBC под капотом)

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
  User findById(Long id);
}

// Hibernate переводит это в JDBC запросы

Параметризованные запросы (важно!)

JDBC обеспечивает безопасность от SQL injection

// ❌ ОПАСНО: SQL injection
String sql = "SELECT * FROM users WHERE name = '" + name + "'";
stmt.executeQuery(sql);

// ✅ ПРАВИЛЬНО: JDBC спецификация защищает
String sql = "SELECT * FROM users WHERE name = ?";
stmt.setString(1, name);
stmt.executeQuery();

// JDBC Driver (реализация) правильно экранирует параметры

Регистрация драйвера

В современной Java (Java 6+) это делается автоматически

// Раньше (Java 5 и ниже) требовалось явно:
Class.forName("org.postgresql.Driver");
Connection conn = DriverManager.getConnection(url);

// Теперь (Java 6+) DriverManager автоматически ищет реализации
// через SPI (Service Provider Interface)
Connection conn = DriverManager.getConnection(url);
// Драйвер найдётся автоматически из CLASSPATH

Выводы

JDBC — это:

• Спецификация (контракт, интерфейсы в java.sql)
• API для работы с БД из Java
• Источник истины для всех реализаций

JDBC Driver — это:

• Конкретная реализация спецификации
• Предоставляется производителем БД
• Содержит логику протокола общения с конкретной БД

Аналогия: JDBC спецификация — это интерфейс, JDBC Driver — реализация этого интерфейса.

Опытный разработчик знает: благодаря спецификации JDBC можно менять БД почти без изменения кода приложения.