Интерфейс 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, 2023, 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/21/docs/api/java.sql/javax/sql/ConnectionPoolDataSource.html