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

Модификатор и тип	Метод	Описание
`default ShardingKeyBuilder`	`createShardingKeyBuilder()`	Создает новый экземпляр `ShardingKeyBuilder`
`Logger`	`getParentLogger()`	Возвращает родительский Logger всех Logger, используемых этим источником данных.

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

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.