JDBC ·
‹ Предыдущий Следующий ›
⏱ 5 минут чтения Обновлено: 2026-11-21

DAO и пул соединений HikariCP в JDBC

Первый DAO почти у всех выглядит одинаково: каждый метод вызывает DriverManager.getConnection(url, user, password), выполняет запрос и закрывает соединение. В учебной программе это работает. В веб-приложении каждый такой вызов — новое TCP-соединение с MySQL и проверка пароля, и на это уходит больше времени, чем на сам SELECT. Поэтому в реальных проектах DAO берёт соединения из пула.

В программном обеспечении data access object (DAO) — это объект, который предоставляет абстрактный интерфейс к какому-либо типу базы данных или механизму хранения. DAO может использоваться для разных видов доступа к БД (JDBC, JPA). Остальной код вызывает методы вроде findById или create и не знает, какой SQL выполняется внутри и через что: через JDBC или через Hibernate.

1. Зачем нужен DAO

Паттерн DAO отделяет код работы с базой данных от бизнес-логики: весь SQL для таблицы users лежит в одном классе UserDao, а сервисы и контроллеры вызывают его методы. Если поменяется схема таблицы или способ доступа к данным, правка затронет один класс, а не десятки мест по всему проекту.

Без DAO строки "SELECT ... FROM users" быстро расползаются по коду: одна в регистрации, другая в личном кабинете, третья в отчёте. Переименуете столбец — придётся искать их все. С DAO у вас есть ещё два преимущества:

  • реализацию можно подменить: сегодня UserDao работает через JDBC, завтра через JPA, а код, который его вызывает, не меняется, потому что зависит от интерфейса;
  • DAO легко тестировать отдельно: передайте ему DataSource базы H2 в памяти, и тест не будет зависеть от рабочего MySQL.

2. Интерфейс DAO

Общий интерфейс DAO описывает набор операций CRUD (create, read, update, delete), одинаковый для всех сущностей. Параметр K — тип первичного ключа, T — тип сущности. Для каждой таблицы пишется своя реализация: UserDao, PhoneDao, OrderDao.

Пример 1. Обобщённый интерфейс Dao

import java.util.List;
import java.util.Optional;

public interface Dao<K, T> {
    List<T> findAll();

    Optional<T> findById(K id);

    T create(T entity);

    boolean update(T entity);

    boolean delete(K id);
}

Метод findById возвращает Optional, а не null: вызывающий код сразу видит, что пользователя может не быть. Методы update и delete возвращают true, если в таблице изменилась ровно одна строка. Если интерфейсы с параметрами типа вам пока непривычны, повторите урок Дженерики в Java.

Сущность — обычный класс, поля которого повторяют столбцы таблицы users из урока Работа с БД с помощью JDBC:

public class User {
    private Integer id;
    private String username;

    public User(String username) {
        this(null, username);
    }

    public User(Integer id, String username) {
        this.id = id;
        this.username = username;
    }

    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }

    @Override
    public String toString() {
        return "User{id=" + id + ", username='" + username + "'}";
    }
}

У нового пользователя id равен null: его назначит база при вставке.

3. Реализация UserDao на JDBC

UserDao реализует интерфейс Dao<Integer, User>: каждый метод берёт соединение, выполняет один PreparedStatement и превращает строки ResultSet в объекты User. Соединения он получает из DataSource, переданного в конструктор, поэтому сам DAO не знает ни URL базы, ни пароля.

Пример 2. Класс UserDao

import javax.sql.DataSource;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;

public class UserDao implements Dao<Integer, User> {
    private static final String SELECT_ALL = "SELECT id, username FROM users ORDER BY id";
    private static final String SELECT_BY_ID = "SELECT id, username FROM users WHERE id = ?";
    private static final String INSERT = "INSERT INTO users (username) VALUES (?)";
    private static final String UPDATE = "UPDATE users SET username = ? WHERE id = ?";
    private static final String DELETE = "DELETE FROM users WHERE id = ?";

    private final DataSource dataSource;

    public UserDao(DataSource dataSource) {
        this.dataSource = dataSource;
    }

    @Override
    public List<User> findAll() {
        List<User> users = new ArrayList<>();
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement = connection.prepareStatement(SELECT_ALL);
             ResultSet rs = statement.executeQuery()) {
            while (rs.next()) {
                users.add(mapRow(rs));
            }
        } catch (SQLException e) {
            throw new DaoException("Не удалось получить список пользователей", e);
        }
        return users;
    }

    @Override
    public Optional<User> findById(Integer id) {
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement = connection.prepareStatement(SELECT_BY_ID)) {
            statement.setInt(1, id);
            try (ResultSet rs = statement.executeQuery()) {
                return rs.next() ? Optional.of(mapRow(rs)) : Optional.empty();
            }
        } catch (SQLException e) {
            throw new DaoException("Не удалось найти пользователя с id=" + id, e);
        }
    }

    @Override
    public User create(User user) {
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement =
                     connection.prepareStatement(INSERT, Statement.RETURN_GENERATED_KEYS)) {
            statement.setString(1, user.getUsername());
            statement.executeUpdate();
            try (ResultSet keys = statement.getGeneratedKeys()) {
                if (keys.next()) {
                    user.setId(keys.getInt(1));
                }
            }
            return user;
        } catch (SQLException e) {
            throw new DaoException("Не удалось сохранить пользователя " + user.getUsername(), e);
        }
    }

    @Override
    public boolean update(User user) {
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement = connection.prepareStatement(UPDATE)) {
            statement.setString(1, user.getUsername());
            statement.setInt(2, user.getId());
            return statement.executeUpdate() == 1;
        } catch (SQLException e) {
            throw new DaoException("Не удалось обновить пользователя с id=" + user.getId(), e);
        }
    }

    @Override
    public boolean delete(Integer id) {
        try (Connection connection = dataSource.getConnection();
             PreparedStatement statement = connection.prepareStatement(DELETE)) {
            statement.setInt(1, id);
            return statement.executeUpdate() == 1;
        } catch (SQLException e) {
            throw new DaoException("Не удалось удалить пользователя с id=" + id, e);
        }
    }

    private User mapRow(ResultSet rs) throws SQLException {
        return new User(rs.getInt("id"), rs.getString("username"));
    }
}

Несколько решений в этом коде стоит разобрать отдельно.

Метод create и getGeneratedKeys(). Столбец id объявлен как AUTO_INCREMENT, значение ему назначает MySQL. Флаг Statement.RETURN_GENERATED_KEYS просит драйвер вернуть сгенерированный ключ, а getGeneratedKeys() отдаёт его в виде ResultSet из одной строки. Запрос SELECT MAX(id) FROM users после вставки для этого не годится: если два пользователя регистрируются одновременно, оба получат один и тот же, последний id.

Исключение DaoException. SQLException — проверяемое исключение, и его соблазнительно «погасить» через System.out.println(e.getMessage()). Тогда при упавшей базе findAll() молча вернёт пустой список, и пользователь увидит «у вас нет заказов» вместо сообщения об ошибке. Правильнее обернуть его в собственное непроверяемое исключение и сохранить причину (cause):

public class DaoException extends RuntimeException {
    public DaoException(String message, Throwable cause) {
        super(message, cause);
    }
}

Подробнее о таких классах — в уроке Создание собственного класса исключения.

Метод mapRow. Преобразование строки в объект вынесено в одно место и читает столбцы по имени: rs.getInt("id") не сломается, если кто-то поменяет порядок столбцов в SELECT, а rs.getInt(1) сломается.

Все ресурсы закрываются в try-with-resources, включая ResultSet. Как устроены PreparedStatement и ResultSet и почему параметры передаются через ?, а не склейкой строк, разобрано в уроке Работа с БД с помощью JDBC.

4. Настройки подключения в database.properties

URL базы, логин и пароль не пишут в коде DAO: их выносят в файл database.properties и читают при запуске. Тогда для тестовой и рабочей базы не нужно перекомпилировать программу, а сам DAO вообще не видит этих настроек, он получает готовый DataSource.

Пример 3. Содержимое database.properties файла

db.url = jdbc:mysql://localhost:3306/catalog
db.user = root
db.password = admin

В Maven-проекте файл кладут в src/main/resources: при сборке он попадает в корень classpath (структура каталогов описана в уроке Создание Maven-проекта). Строку db.driver из старых примеров можно не писать: с JDBC 4.0 драйвер регистрируется сам, подробности — в уроке Схема подключения к базе данных и драйвера.

Пример 4. Использование ResourceBundle для чтения данных для аутентификации

В старых проектах настройки часто читают через ResourceBundle. Здесь в файле отдельно хранятся URL сервера (db.url = jdbc:mysql://localhost:3306/) и имя базы (db.name = catalog):

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.util.ResourceBundle;

public class ConnectorDB {
    public static Connection getConnection() throws SQLException {
        ResourceBundle resource = ResourceBundle.getBundle("database");
        String url = resource.getString("db.url");
        String user = resource.getString("db.user");
        String pass = resource.getString("db.password");
        String dbName = resource.getString("db.name");

        return DriverManager.getConnection(url + dbName, user, pass);
    }
}

Пример 5. Чтение настроек через Properties

Для настроек подключения чаще используют java.util.Properties:

import java.io.IOException;
import java.io.InputStream;
import java.io.UncheckedIOException;
import java.util.Properties;

public final class DbProperties {
    private DbProperties() {
    }

    public static Properties load() {
        Properties props = new Properties();
        try (InputStream in = DbProperties.class.getClassLoader()
                .getResourceAsStream("database.properties")) {
            if (in == null) {
                throw new IllegalStateException("database.properties не найден в classpath");
            }
            props.load(in);
        } catch (IOException e) {
            throw new UncheckedIOException(e);
        }
        return props;
    }
}
Признак ResourceBundle Properties
Для чего создан Локализация: тексты на разных языках Произвольные настройки «ключ = значение»
Если ключа нет MissingResourceException null или значение по умолчанию из getProperty(key, default)
Откуда читает Только из classpath, ищет файлы по локали (database_ru.properties и т.д.) Из любого InputStream: classpath, файл на диске
Кеширование Кеширует загруженный файл, правка без перезапуска не видна Читает файл заново при каждом load

Пароль не для Git

Файл с настоящим паролем от рабочей базы не коммитят в репозиторий. В Git кладут database.properties.example с пустыми значениями, а пароль на сервере передают через переменную окружения: System.getenv("DB_PASSWORD").

5. Пул соединений

Пул соединений (connection pool) — это набор заранее открытых соединений с базой данных, которые программа берёт на время одной операции и возвращает обратно. Открытие соединения стоит дорого (TCP, авторизация, настройка сессии), а пул платит эту цену один раз при старте и потом раздаёт готовые соединения потокам.

Пул реализует интерфейс javax.sql.DataSource, поэтому код DAO не меняется: он так же вызывает dataSource.getConnection() и закрывает соединение в try-with-resources. Разница внутри: close() у соединения из пула не разрывает связь с MySQL, а возвращает соединение в пул. Чем DataSource отличается от DriverManager, показано в таблице урока Схема подключения к базе данных и драйвера.

Пул решает и вторую задачу — ограничивает нагрузку на базу. Если одновременно пришло 500 запросов, а в пуле 10 соединений, к MySQL пойдут только 10 запросов, остальные подождут в очереди. Без пула все 500 потоков попытаются открыть свои соединения, и MySQL ответит ошибкой Too many connections, как только превысит свой лимит max_connections.

6. Пул соединений HikariCP

HikariCP — самый распространённый пул соединений JDBC в Java: Spring Boot использует его по умолчанию. Чтобы подключить HikariCP, достаточно добавить одну Maven-зависимость, создать HikariConfig с URL, логином и паролем и передать его в конструктор HikariDataSource.

Пример 6. Maven-зависимость HikariCP

<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>6.3.0</version>
</dependency>

HikariCP 5.x и 6.x требуют Java 11 или новее, для Java 8 есть ветка 4.0.x. Драйвер MySQL (mysql-connector-j) нужен по-прежнему: пул не заменяет драйвер, а управляет соединениями, которые драйвер открывает. Как подключать зависимости, описано в уроке Зависимости в Maven.

Пример 7. Настройка HikariDataSource в коде

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

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/catalog");
config.setUsername("root");
config.setPassword("admin");
config.setMaximumPoolSize(10);
config.setPoolName("catalog-pool");

HikariDataSource dataSource = new HikariDataSource(config);

Те же настройки можно держать в файле. Конструктор HikariConfig(String propertyFileName) читает файл из classpath, имена ключей совпадают с именами сеттеров без set:

jdbcUrl=jdbc:mysql://localhost:3306/catalog
username=root
password=admin
maximumPoolSize=10
poolName=catalog-pool
HikariDataSource dataSource = new HikariDataSource(new HikariConfig("/hikari.properties"));

Основные настройки HikariCP

Настройка Что задаёт По умолчанию
maximumPoolSize Сколько соединений пул может держать одновременно: и свободных, и выданных 10
minimumIdle Сколько свободных соединений пул старается держать наготове Равно maximumPoolSize
connectionTimeout Сколько миллисекунд getConnection() ждёт свободного соединения, прежде чем бросить SQLTransientConnectionException 30 000 (30 секунд)
idleTimeout Через сколько миллисекунд простоя лишнее соединение закрывается (работает, только если minimumIdle меньше maximumPoolSize) 600 000 (10 минут)
maxLifetime Максимальный срок жизни соединения. Должен быть на несколько секунд меньше таймаута, после которого соединение закрывает сама база 1 800 000 (30 минут)
leakDetectionThreshold Через сколько миллисекунд пул пишет в лог предупреждение о соединении, которое взяли и не вернули 0 (выключено)

Пул держит открытые соединения и фоновые потоки, поэтому при остановке программы его закрывают: dataSource.close(). HikariDataSource реализует Closeable, так что в небольшой программе его можно создать прямо в try-with-resources.

Предупреждение SLF4J при запуске

HikariCP пишет логи через SLF4J. Если в проекте нет реализации логгера, при старте появится предупреждение SLF4J о том, что провайдер не найден, и сообщения пула (в том числе об утечках соединений) пропадут. Добавьте зависимость org.slf4j:slf4j-simple или Logback.

7. DAO и HikariCP вместе

Чтобы подключить пул к DAO, создайте один HikariDataSource при старте приложения и передайте его в конструктор каждого DAO. Пул должен быть один на всё приложение: если создавать его внутри DAO или в каждом методе, программа откроет десятки лишних соединений и потеряет весь смысл пула.

Пример 8. Класс ConnectionPool

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

import java.util.Properties;

public final class ConnectionPool {
    private ConnectionPool() {
    }

    public static HikariDataSource create() {
        Properties props = DbProperties.load();

        HikariConfig config = new HikariConfig();
        config.setJdbcUrl(props.getProperty("db.url"));
        config.setUsername(props.getProperty("db.user"));
        config.setPassword(props.getProperty("db.password"));
        config.setMaximumPoolSize(10);
        config.setPoolName("catalog-pool");
        return new HikariDataSource(config);
    }
}

Пример 9. Использование UserDao

import com.zaxxer.hikari.HikariDataSource;

public class UserDaoDemo {
    public static void main(String[] args) {
        try (HikariDataSource dataSource = ConnectionPool.create()) {
            UserDao userDao = new UserDao(dataSource);

            User misha = userDao.create(new User("misha"));
            userDao.create(new User("grisha"));
            System.out.println(misha);
            System.out.println(userDao.findAll());

            misha.setUsername("mikhail");
            System.out.println(userDao.update(misha));
            System.out.println(userDao.delete(100));
            System.out.println(userDao.findById(1));
            System.out.println(userDao.findById(100));
        }
    }
}

Вывод, если перед запуском таблица users только что создана и пуста:

User{id=1, username='misha'}
[User{id=1, username='misha'}, User{id=2, username='grisha'}]
true
false
Optional[User{id=1, username='mikhail'}]
Optional.empty

После create у объекта misha уже есть id=1, полученный через getGeneratedKeys(). delete(100) вернул false: строки с таким id нет, executeUpdate вернул 0. Для теста этот же UserDao можно создать с DataSource базы H2 в памяти, не меняя в нём ни строки.

8. Утечка соединений и другие частые ошибки

Утечка соединений (connection leak) — это соединение, которое взяли из пула и не закрыли. Пул не знает, что оно больше не нужно, и считает его занятым. Когда «потерянных» соединений становится столько же, сколько maximumPoolSize, следующий getConnection() ждёт connectionTimeout и падает, причём падает в совсем другом месте программы.

Что выведет программа?

HikariConfig config = new HikariConfig();
config.setJdbcUrl("jdbc:mysql://localhost:3306/catalog");
config.setUsername("root");
config.setPassword("admin");
config.setMaximumPoolSize(2);
config.setConnectionTimeout(1000);

try (HikariDataSource dataSource = new HikariDataSource(config)) {
    for (int i = 1; i <= 3; i++) {
        Connection connection = dataSource.getConnection(); // не закрываем
        System.out.println("Получено соединение " + i);
    }
}

Два соединения пул выдаст сразу, третьего свободного нет. Через секунду (connectionTimeout = 1000) getConnection() бросит исключение:

Получено соединение 1
Получено соединение 2
Exception in thread "main" java.sql.SQLTransientConnectionException: HikariPool-1 - Connection is not available, request timed out after 1004ms (total=2, active=2, idle=0, waiting=0)

Число миллисекунд у вас будет немного другим, но active=2 при total=2 всегда означает одно: все соединения выданы и никто их не вернул. Исправление — брать соединение в try-with-resources: try (Connection connection = dataSource.getConnection()) { ... }. Чтобы найти место утечки в большом проекте, включите config.setLeakDetectionThreshold(2000): если соединение не вернули за 2 секунды, HikariCP запишет в лог предупреждение со стек-трейсом того места, где его взяли.

Ошибка Что произойдёт Как исправить
Connection хранится в поле DAO Все потоки делят одно соединение, транзакции перемешиваются, а после таймаута MySQL (wait_timeout, по умолчанию 8 часов) любой запрос падает Хранить в поле DataSource, а Connection брать на одну операцию
Новый HikariDataSource в каждом DAO или методе Каждый пул открывает свои 10 соединений, MySQL быстро упирается в Too many connections Один пул на приложение, передавать его в конструкторы DAO
catch (SQLException e) { System.out.println(...); } Ошибка базы превращается в пустой список или null, причину приходится искать по логам Бросать DaoException с cause
Пул не закрыт при остановке Соединения висят на стороне MySQL до таймаута, в веб-приложении при передеплое копятся пулы Вызывать dataSource.close() при завершении работы

Часто задаваемые вопросы

Чем DAO отличается от Repository?

DAO описывает доступ к хранилищу и обычно повторяет таблицу: UserDao с методами CRUD для users. Repository из DDD описывает коллекцию объектов предметной области и может собирать объект из нескольких таблиц. В небольших проектах разницы почти нет, а в Spring Data интерфейсы называются Repository, хотя по сути часто остаются DAO.

Нужно ли самому настраивать HikariCP в Spring Boot?

Нет. Если в проекте есть spring-boot-starter-jdbc или spring-boot-starter-data-jpa, Spring Boot создаёт HikariDataSource сам по свойствам spring.datasource.url, username и password. Параметры пула задаются с префиксом spring.datasource.hikari, например spring.datasource.hikari.maximum-pool-size=20.

Какой размер пула соединений выбрать?

Начните со значения по умолчанию, 10, и меняйте его по замерам. Больше не значит быстрее: база выполняет параллельно столько запросов, сколько у неё ядер и дисков, а лишние соединения только конкурируют за них. Авторы HikariCP предлагают ориентир «число ядер сервера БД × 2 + число дисков». Пул на сотни соединений обычно говорит о медленных запросах, а не о маленьком пуле.

Нужен ли DAO, если в проекте Hibernate или JPA?

Слой доступа к данным нужен всё равно, меняется только реализация: внутри DAO вместо JDBC работает EntityManager. В проектах на Spring его роль выполняют интерфейсы Spring Data, которые генерируют реализацию сами. Пул соединений при этом остаётся: Hibernate тоже берёт соединения из DataSource.

Практика по теме

Закрепите урок на задачах — у каждой есть уровень и оценка времени.

Все задачи модуля →

Комментарии

Зарегистрируйтесь или войдите, чтобы иметь возможность оставить комментарий.