Интерфейс 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
См. также:: CommonDataSource.setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out)
           throws SQLException

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

Определено в:: setLogWriter в интерфейсе CommonDataSource
Параметры:: out - новая запись логов; для отключения регистрации задайте значение null
Исключения:: SQLException - если произошла ошибка доступа к базе данных
С тех пор:: 1.4
См. также:: CommonDataSource.getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
              throws SQLException

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

Определено в:: setLoginTimeout в интерфейсе CommonDataSource
Параметры:: seconds - предел времени входа в систему источника данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных.
С тех пор:: 1.4
См. также:: CommonDataSource.getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
             throws SQLException

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

Определено в:: getLoginTimeout в интерфейсе CommonDataSource
Возвращает:: предел времени входа в систему источника данных
Исключения:: SQLException - если произошла ошибка доступа к базе данных.
С тех пор:: 1.4
См. также:: CommonDataSource.setLoginTimeout(int)

createPooledConnectionBuilder

default PooledConnectionBuilder createPooledConnectionBuilder()
                                                       throws SQLException

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

Требования реализации:: Реализация по умолчанию выбросит SQLFeatureNotSupportedException.
Возвращает:: Экземпляр ConnectionBuilder, который был создан
Исключения:: SQLException - если произошла ошибка при создании сборщика; SQLFeatureNotSupportedException - если драйвер не поддерживает фрагментацию
С тех пор:: 9
См. также:: PooledConnectionBuilder