compact2, compact3

javax.sql

Интерфейс DataSource

Все Суперинтерфейсы:

CommonDataSource, Обертка

public interface DataSource
extends CommonDataSource, Wrapper

Фабрика для соединений с физическим источником данных, что это DataSource объект представляет. Альтернатива DriverManager средство, a DataSource объект является привилегированными средствами получения соединения. Объект, который реализует DataSource интерфейс будет обычно регистрироваться в службе именования, основанной на Именовании ^JavaTM и Каталоге (JNDI) API.

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

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

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

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

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

С тех пор:

1.4

Сводка метода

Модификатор и Тип	Метод и Описание
Соединение	getConnection() Попытки установить соединение с источником данных, что это DataSource объект представляет.
Соединение	getConnection(String username, String password) Попытки установить соединение с источником данных, что это DataSource объект представляет.

Методы, наследованные от интерфейса javax.sql. CommonDataSource

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

Методы, наследованные от интерфейса java.sql. Обертка

isWrapperFor, unwrap

Деталь метода

getConnection

Connection getConnection()
                  throws SQLException

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

Возвраты:

соединение с источником данных

Броски:

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

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

getConnection

Connection getConnection(String username,
                         String password)
                  throws SQLException

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

Параметры:

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

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

Возвраты:

соединение с источником данных

Броски:

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

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

С тех пор:

1.4