Интерфейс CommonDataSource

Все известные подинтерфейсы:: ConnectionPoolDataSource, DataSource, XADataSource

public interface CommonDataSource

Интерфейс, определяющий методы, которые общие для DataSource, XADataSource и ConnectionPoolDataSource.

С:: 1.6

Краткое описание методов

Модификатор и тип	Метод	Описание
`default ShardingKeyBuilder`	`createShardingKeyBuilder()`	Создаёт новый экземпляр `ShardingKeyBuilder`.
`int`	`getLoginTimeout()`	Получает максимальное время в секундах, которое этот источник данных может ждать при попытке подключения к базе данных.
`PrintWriter`	`getLogWriter()`	Возвращает объект записи журнала для этого объекта `DataSource`.
`Logger`	`getParentLogger()`	Возвращает родительский логгер всех логгеров, используемых этим источником данных.
`void`	`setLoginTimeout(int seconds)`	Устанавливает максимальное время в секундах, которое этот источник данных будет ждать при попытке подключения к базе данных.
`void`	`setLogWriter(PrintWriter out)`	Устанавливает объект записи журнала для этого объекта `DataSource` на заданный объект `java.io.PrintWriter`.

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

getLogWriter

PrintWriter getLogWriter() throws SQLException

Возвращает объект записи журнала для этого объекта DataSource.

Объект записи журнала — это поток символьного вывода, в который будут выводиться все сообщения логирования и отслеживания для этого источника данных. Это включает сообщения, выводимые методами этого объекта, сообщения, выводимые методами других объектов, созданных этим объектом, и т. д. Сообщения, выводимые в источник данных, не выводятся в журнал, связанный с классом java.sql.DriverManager. Когда создается объект DataSource, объект записи журнала изначально равен null; другими словами, по умолчанию логирование отключено.

Возвращает:

объект записи журнала для этого источника данных или null, если логирование отключено

Исключения:

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

См. также:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

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

Параметры:

out - новый объект записи журнала; для отключения логирования, установите значение null

Исключения:

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

См. также:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

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

Параметры:

seconds - лимит времени входа в систему источника данных

Исключения:

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

См. также:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout() throws SQLException

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

Возвращает:

лимит времени входа в систему источника данных

Исключения:

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

См. также:

setLoginTimeout(int)

getParentLogger

Logger getParentLogger() throws SQLFeatureNotSupportedException

Возвращает родительский логгер всех логгеров, используемых этим источником данных. Это должен быть логгер, наиболее удалённый от корневого логгера, который всё ещё является предком всех логгеров, используемых этим источником данных. Настройка этого логгера повлияет на все сообщения журнала, генерируемые источником данных. В худшем случае, это может быть корневой логгер.

Возвращает:: родительский логгер для этого источника данных
Исключения:: SQLFeatureNotSupportedException - если источник данных не использует java.util.logging
С:: 1.7

createShardingKeyBuilder

default ShardingKeyBuilder createShardingKeyBuilder() throws SQLException

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

Требования к реализации:

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException.

Возвращает:

Экземпляр ShardingKeyBuilder, который был создан

Исключения:

SQLException - если произошла ошибка при создании билдера

SQLFeatureNotSupportedException - если драйвер не поддерживает этот метод

С:

См. также:

ShardingKeyBuilder

© 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/CommonDataSource.html