Интерфейс 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 - если драйвер не поддерживает этот метод
С:: 9
См. также:: ShardingKeyBuilder