Интерфейс CommonDataSource

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

public interface CommonDataSource

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

С момента:: 1.6

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

Модификатор и тип	Метод	Описание
`default ShardingKeyBuilder`	`createShardingKeyBuilder()`	Создает новый экземпляр `ShardingKeyBuilder`
`int`	`getLoginTimeout()`	Получает максимальное время в секундах, которое этот источник данных может ждать при попытке подключения к базе данных.
`PrintWriter`	`getLogWriter()`	Возвращает записыватель логов для этого объекта `DataSource`.
`Logger`	`getParentLogger()`	Возвращает родительский Logger для всех Logger, используемых этим источником данных.
`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 таймаут входа в систему изначально равен нулю.

Параметры:

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

Выбрасывает:

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

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

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

Возвращает:

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

Выбрасывает:

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

См. также:

getParentLogger

Logger getParentLogger() throws SQLFeatureNotSupportedException

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

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

createShardingKeyBuilder

default ShardingKeyBuilder createShardingKeyBuilder() throws SQLException

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

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

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

Возвращает:

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

Выбрасывает:

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

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

С момента:

См. также:

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/CommonDataSource.html