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

void setLogWriter(PrintWriter out) throws SQLException

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

Параметры:

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

Использует:

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

См. также:

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

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

Параметры:

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

Использует:

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

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

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

Возвращает:

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

Использует:

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

См. также:

getParentLogger

Logger getParentLogger() throws SQLFeatureNotSupportedException

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

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

createShardingKeyBuilder

default ShardingKeyBuilder createShardingKeyBuilder() throws SQLException

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

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

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

Возвращает:

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

Использует:

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