Интерфейс 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 - если драйвер не поддерживает фрагментацию

С:

См. также:

PooledConnectionBuilder

© 1993, 2021, 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/17/docs/api/java.sql/javax/sql/ConnectionPoolDataSource.html