1. Что это и зачем нужна

HikariCP (произносится как "хи-ка-ри-си-пи") — это высокопроизводительный пул соединений с базами данных для Java. Название происходит от японского слова "光" (hikari), что означает "свет". Библиотека разработана с фокусом на минимальную задержку и максимальную пропускную способность. В мире Java существует несколько пулов соединений (например, Apache DBCP, C3P0, Tomcat JDBC), но HikariCP считается самым быстрым и лёгким.

Зачем нужен пул соединений? Установка соединения с базой данных — это дорогостоящая операция (TCP-рукопожатие, аутентификация, установка сессии). Если для каждого SQL-запроса открывать новое соединение, производительность приложения резко упадёт. Пул соединений решает эту проблему: он поддерживает заранее созданные соединения в "резервуаре". Когда приложению нужно выполнить запрос, оно берёт готовое соединение из пула, использует его и возвращает обратно. Это значительно ускоряет работу и снижает нагрузку на базу данных.

HikariCP используется в таких крупных проектах, как Spring Boot (по умолчанию начиная с версии 2.0), Play Framework, Dropwizard и многих других. Библиотека поддерживает все основные СУБД: PostgreSQL, MySQL, MariaDB, Oracle, H2, HSQLDB, SQL Server и другие. Благодаря своей эффективности и простоте, HikariCP стал стандартом де-факто для пулов соединений в Java-экосистеме.

2. Установка

HikariCP распространяется через центральный репозиторий Maven. Для установки добавьте зависимость в ваш файл pom.xml (для Maven) или build.gradle (для Gradle). Также вам понадобится JDBC-драйвер для вашей базы данных.

Maven (pom.xml)

<!-- HikariCP -->
<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>5.1.0</version>
</dependency>

<!-- JDBC драйвер для PostgreSQL (пример) -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.7.1</version>
</dependency>

Gradle (build.gradle)

implementation 'com.zaxxer:HikariCP:5.1.0'
implementation 'org.postgresql:postgresql:42.7.1'

Важно: Версии могут меняться. Рекомендуется проверять актуальную версию на официальном сайте Maven Central. Для других СУБД замените драйвер на соответствующий (например, mysql-connector-j для MySQL).

3. Быстрый старт — минимальный рабочий пример

Ниже приведён минимальный пример использования HikariCP для выполнения простого запроса к базе данных PostgreSQL. Предполагается, что у вас запущен PostgreSQL с базой данных testdb и таблицей users.

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;

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

public class QuickStart {
    public static void main(String[] args) {
        // 1. Настройка конфигурации
        HikariConfig config = new HikariConfig();
        config.setJdbcUrl("jdbc:postgresql://localhost:5432/testdb");
        config.setUsername("postgres");
        config.setPassword("password");
        config.setMaximumPoolSize(10);

        // 2. Создание DataSource
        try (HikariDataSource dataSource = new HikariDataSource(config)) {

            // 3. Получение соединения из пула
            try (Connection connection = dataSource.getConnection();
                 Statement statement = connection.createStatement();
                 ResultSet resultSet = statement.executeQuery("SELECT * FROM users")) {

                // 4. Обработка результатов
                while (resultSet.next()) {
                    System.out.println("User: " + resultSet.getString("username"));
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Этот пример демонстрирует базовый жизненный цикл: создание конфигурации, инициализация пула, получение соединения, выполнение запроса и автоматическое закрытие ресурсов (благодаря try-with-resources).

4. Основные классы и методы

Рассмотрим ключевые классы и методы HikariCP, которые вам понадобятся в повседневной работе.

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:postgresql://localhost:5432/mydb");
config.setUsername("user");
config.setPassword("pass");
config.setMaximumPoolSize(15);
config.setConnectionTimeout(30000); // 30 секунд
config.setIdleTimeout(600000);      // 10 минут
config.setMaxLifetime(1800000);     // 30 минут

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:postgresql://localhost:5432/mydb");
config.setUsername("user");
config.setPassword("pass");

try (HikariDataSource dataSource = new HikariDataSource(config)) {
    // Используем dataSource
} // dataSource автоматически закроется

try (Connection conn = dataSource.getConnection()) {
    // Работаем с соединением
} // Автоматически возвращается в пул

config.setMaximumPoolSize(20); // Максимум 20 соединений

config.setConnectionTimeout(5000); // 5 секунд ожидания

config.setIdleTimeout(300000); // 5 минут простоя

config.setMaxLifetime(1800000); // 30 минут

config.setMinimumIdle(5); // Минимум 5 простаивающих соединений

config.setConnectionTestQuery("SELECT 1");

config.addDataSourceProperty("cachePrepStmts", "true");
config.addDataSourceProperty("prepStmtCacheSize", "250");
config.addDataSourceProperty("prepStmtCacheSqlLimit", "2048");

5. Реальный практический пример

Рассмотрим полноценный пример приложения для управления пользователями. Оно будет использовать HikariCP для подключения к PostgreSQL, выполнять CRUD-операции и корректно обрабатывать ошибки.

import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;

import java.sql.*;
import java.util.ArrayList;
import java.util.List;

public class UserRepository {
    private final HikariDataSource dataSource;

    public UserRepository(String jdbcUrl, String username, String password) {
        HikariConfig config = new HikariConfig();
        config.setJdbcUrl(jdbcUrl);
        config.setUsername(username);
        config.setPassword(password);
        config.setMaximumPoolSize(10);
        config.setMinimumIdle(2);
        config.setConnectionTimeout(30000);
        config.setIdleTimeout(600000);
        config.setMaxLifetime(1800000);
        config.setConnectionTestQuery("SELECT 1");
        
        // Оптимизация для PostgreSQL
        config.addDataSourceProperty("cachePrepStmts", "true");
        config.addDataSourceProperty("prepStmtCacheSize", "250");
        config.addDataSourceProperty("prepStmtCacheSqlLimit", "2048");
        config.addDataSourceProperty("useServerPrepStmts", "true");

        this.dataSource = new HikariDataSource(config);
    }

    // Создание пользователя
    public User createUser(String name, String email) throws SQLException {
        String sql = "INSERT INTO users (name, email) VALUES (?, ?) RETURNING id, created_at";
        
        try (Connection conn = dataSource.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {
            
            stmt.setString(1, name);
            stmt.setString(2, email);
            
            try (ResultSet rs = stmt.executeQuery()) {
                if (rs.next()) {
                    return new User(
                        rs.getLong("id"),
                        name,
                        email,
                        rs.getTimestamp("created_at").toLocalDateTime()
                    );
                }
            }
        }
        return null;
    }

    // Получение пользователя по ID
    public User getUserById(long id) throws SQLException {
        String sql = "SELECT * FROM users WHERE id = ?";
        
        try (Connection conn = dataSource.getConnection();
             PreparedStatement stmt = conn.prepareStatement(sql)) {
            
            stmt.setLong(1, id);
            
            try (ResultSet rs = stmt.executeQuery()) {
                if (rs.next()) {
                    return mapUser(rs);
                }
            }
        }
        return null;
    }

    // Получение всех пользователей
    public List getAllUsers() throws SQLException {
        List users = new ArrayList<>();
        String sql = "SELECT * FROM users ORDER BY id";
        
        try (Connection conn = dataSource.getConnection();
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery(sql)) {
            
            while (rs.next()) {
                users.add(mapUser(rs));
            }
        }
        return users;
    }

    // Обновление email пользователя