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.
Практика по теме
Закрепите урок на задачах — у каждой есть уровень и оценка времени.
- Класс PhoneDao: CRUD для таблицы phones
- Утечка соединений в пуле HikariCP
- DAO магазина на пуле HikariCP и транзакция оформления заказа
Комментарии