Интерфейс 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`.

Методы, объявленные в интерфейсе 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

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

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

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

Параметры:

seconds — ограничение времени входа для источника данных

Вызывает исключение:

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

Начиная с:

1.4

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

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

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

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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/javax/sql/ConnectionPoolDataSource.html