Интерфейс DataSource

public interface DataSource
extends CommonDataSource, Wrapper

Фабрика для подключений к физическому источнику данных, который представляет этот DataSource объект. В качестве альтернативы механизму DriverManager, объект DataSource является предпочтительным способом получения подключения. Объект, реализующий интерфейс DataSource, обычно регистрируется в службе именования, основанной на API Java™ Naming and Directory (JNDI).

Интерфейс DataSource реализуется поставщиком драйвера. Существует три типа реализаций:

1. Базовая реализация — производит стандартный объект Connection
2. Реализация пулинга подключений — производит объект Connection, который будет автоматически участвовать в пулинге подключений. Эта реализация работает с менеджером пулинга подключений на среднем уровне.
3. Реализация распределённых транзакций — производит объект Connection, который может использоваться для распределённых транзакций и почти всегда участвует в пулинге подключений. Эта реализация работает с менеджером транзакций на среднем уровне и почти всегда с менеджером пулинга подключений.

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

Драйвер, к которому осуществляется доступ через объект DataSource , не регистрируется в DriverManager. Вместо этого объект DataSource извлекается через операцию поиска и затем используется для создания объекта Connection. С базовой реализацией подключение, полученное через объект DataSource, идентично подключению, полученному через механизм DriverManager.

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

Методы

getConnection

Connection getConnection()
                  throws SQLException

Возвращает:

подключение к источнику данных

Исключение:

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

SQLTimeoutException - когда драйвер определил, что значение таймаута, указанное методом setLoginTimeout, было превышено и по крайней мере попытался отменить текущую попытку подключения к базе данных

getConnection

Connection getConnection(String username,
                         String password)
                  throws SQLException

Параметры:

username - пользователь базы данных, от имени которого создаётся подключение

password - пароль пользователя

Возвращает:

подключение к источнику данных

Исключение:

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

SQLTimeoutException - когда драйвер определил, что значение таймаута, указанное методом setLoginTimeout, было превышено и по крайней мере попытался отменить текущую попытку подключения к базе данных

С:

1.4