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

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

Параметры:

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

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

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

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

Возвращает максимальное время в секундах, в течение которого этот источник данных может ожидать при попытке подключения к базе данных. Значение, равное нулю, означает, что используется системное время ожидания по умолчанию, если оно задано; в противном случае это означает, что ограничение времени ожидания отсутствует. При создании объекта 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/javax/sql/CommonDataSource.html