Интерфейс ConnectionPoolDataSource

Все суперинтерфейсы:: CommonDataSource

public interface ConnectionPoolDataSource extends CommonDataSource

Фабрика объектов PooledConnection. Объект, реализующий этот интерфейс, обычно регистрируется в службе именования, основанной на Java Naming and Directory Interface (JNDI).

С:: 1.4

Краткое описание методов

Модификатор и тип	Метод	Описание
`default PooledConnectionBuilder`	`createPooledConnectionBuilder()`	Создаёт новый объект `PooledConnectionBuilder`
`int`	`getLoginTimeout()`	Возвращает максимальное время в секундах, которое этот источник данных может ожидать при попытке подключения к базе данных.
`PrintWriter`	`getLogWriter()`	Получает объект записывателя журнала для этого объекта `DataSource`.
`PooledConnection`	`getPooledConnection()`	Попытка установить физическое подключение к базе данных, которое может быть использовано в качестве подключений пула.
`PooledConnection`	`getPooledConnection(String user, String password)`	Попытка установить физическое подключение к базе данных, которое может быть использовано в качестве подключений пула.
`void`	`setLoginTimeout(int seconds)`	Устанавливает максимальное время в секундах, которое этот источник данных будет ожидать при попытке подключения к базе данных.
`void`	`setLogWriter(PrintWriter out)`	Устанавливает объект записывателя журнала для этого объекта `DataSource` на заданный объект `java.io.PrintWriter`.

Методы, объявленные в интерфейсе javax.sql.CommonDataSource

createShardingKeyBuilder, getParentLogger

Подробное описание методов

getPooledConnection

PooledConnection getPooledConnection() throws SQLException

Попытка установить физическое подключение к базе данных, которое может использоваться в качестве подключение пула.

Возвращает:: объект PooledConnection, представляющий физическое подключение к базе данных, которое представляет этот объект ConnectionPoolDataSource
Выбрасывает:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.4

getPooledConnection

PooledConnection getPooledConnection(String user, String password) throws SQLException

Параметры:: user - пользователь базы данных от имени которого создается подключение; password - пароль пользователя
Возвращает:: объект PooledConnection, представляющий физическое подключение к базе данных, которое представляет этот объект ConnectionPoolDataSource
Выбрасывает:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:: 1.4

getLogWriter

PrintWriter getLogWriter() throws SQLException

Возвращает объект записи журнала для этого объекта DataSource.

Запись журнала — это поток символьного вывода, в который будут выводиться все сообщения логирования и отладки для этого источника данных. Это включает сообщения, напечатанные методами этого объекта, сообщения, напечатанные методами других объектов, созданных этим объектом, и так далее. Сообщения, выводимые в журнал, специфичный для источника данных, не выводятся в журнал, связанный с классом java.sql.DriverManager. При создании объекта DataSource запись журнала первоначально равна null; другими словами, по умолчанию ведение журнала отключено.

Определено в:

getLogWriter в интерфейсе CommonDataSource

Возвращает:

запись журнала для этого источника данных или null, если ведение журнала отключено

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных

С момента:

1.4

См. также:

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

Устанавливает запись журнала для этого объекта DataSource на заданный объект java.io.PrintWriter.

Определено в:

setLogWriter в интерфейсе CommonDataSource

Параметры:

out - новая запись журнала; для отключения ведения журнала установите значение null

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных

С момента:

1.4

См. также:

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

Устанавливает максимальное время в секундах, которое этот источник данных будет ждать при попытке подключения к базе данных. Значение 0 указывает, что таймаут — это значение таймаута по умолчанию для системы, если таковой имеется; в противном случае — указывает, что таймаута нет. При создании объекта DataSource таймаут входа в систему первоначально равен 0.

Определено в:

setLoginTimeout в интерфейсе CommonDataSource

Параметры:

seconds - предел времени входа в систему источника данных

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных.

С момента:

1.4

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

Получает максимальное время в секундах, которое этот источник данных может ожидать при попытке подключения к базе данных. Значение 0 означает, что таймаут равен системному таймауту по умолчанию, если он существует; в противном случае это означает, что таймаут отсутствует. При создании объекта DataSource таймаут входа в систему изначально равен 0.

Определено в:

getLoginTimeout в интерфейсе CommonDataSource

Возвращает:

предельный срок действия входа в систему источника данных

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных.

С:

1.4

См. также:

createPooledConnectionBuilder

default PooledConnectionBuilder createPooledConnectionBuilder() throws SQLException

Создает новый экземпляр PooledConnectionBuilder

Требования к реализации:

Реализация по умолчанию выбросит исключение SQLFeatureNotSupportedException.

Возвращает:

Экземпляр ConnectionBuilder, который был создан

Выбрасывает:

SQLException - если произошла ошибка при создании билдера

SQLFeatureNotSupportedException - если драйвер не поддерживает фрагментацию

С:

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/ConnectionPoolDataSource.html