Spec-Zone .ru спецификации, руководства, описания, API

javax.resource.cci
Соединение интерфейса

public interface Connection

Соединение представляет дескриптор уровня приложения, который используется клиентом, чтобы получить доступ к базовому физическому соединению. Фактическое физическое соединение, связанное с экземпляром Соединения, представляется экземпляром ManagedConnection.

Клиент получает экземпляр Соединения при использовании getConnection метод на a ConnectionFactory экземпляр. Соединение может быть связано с нулем или большим количеством экземпляров Взаимодействия.

Версия:

0.8

Автор:

Рэхул Шарма

См. Также:

ConnectionFactory, Interaction

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

void	close() Новички близко соединения обрабатывают на уровне приложения.
Взаимодействие	createInteraction() Создает Взаимодействие, связанное с этим Соединением.
LocalTransaction	getLocalTransaction() Возвращает экземпляр LocalTransaction, который позволяет компоненту разграничить менеджер ресурсов локальные транзакции на Соединении.
ConnectionMetaData	getMetaData() Получает информацию о базовом экземпляре EIS, представленном через активное соединение.
ResultSetInfo	getResultSetInfo() Получает информацию о функциональности ResultSet, поддерживаемой соединенным экземпляром EIS.

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

createInteraction

Interaction createInteraction()
                              throws ResourceException

Создает Взаимодействие, связанное с этим Соединением. Взаимодействие позволяет приложению выполнить функции EIS.

Возвраты:

Экземпляр взаимодействия

Броски:

ResourceException - Отказавший, чтобы создать Взаимодействие

getLocalTransaction

LocalTransaction getLocalTransaction()
                                     throws ResourceException

Возвращает экземпляр LocalTransaction, который позволяет компоненту разграничить менеджер ресурсов локальные транзакции на Соединении. Если адаптер ресурса не позволяет компоненту разграничивать локальные транзакции на использовании Соединения интерфейс LocalTransaction, то метод getLocalTransaction должен бросить NotSupportedException.

Возвраты:

Экземпляр LocalTransaction

Броски:

ResourceException - Отказавший, чтобы возвратить экземпляр LocalTransaction из-за ошибки адаптера ресурса

NotSupportedException - Установление границ Менеджера ресурсов локальные транзакции не поддерживается на этом Соединении

См. Также:

LocalTransaction

getMetaData

ConnectionMetaData getMetaData()
                               throws ResourceException

Получает информацию о базовом экземпляре EIS, представленном через активное соединение.

Возвраты:

Информация о представлении экземпляра ConnectionMetaData об экземпляре EIS

Броски:

ResourceException - Отказавший, чтобы получить информацию о соединенном экземпляре EIS. Ошибка может быть ресурсом, внутренним адаптером, специфичным для EIS или связанная передача.

getResultSetInfo

ResultSetInfo getResultSetInfo()
                               throws ResourceException

Получает информацию о функциональности ResultSet, поддерживаемой соединенным экземпляром EIS.

Возвраты:

Экземпляр ResultSetInfo

Броски:

ResourceException - Отказавший, чтобы получить соответствующую информацию ResultSet

NotSupportedException - Функциональность ResultSet не поддерживается

близко

void close()
           throws ResourceException

Новички близко соединения обрабатывают на уровне приложения. Клиент не должен использовать закрытое соединение, чтобы взаимодействовать с EIS.

Броски:

ResourceException - Исключение, выданное, если близко на соединении обрабатывают сбои.

Любое недопустимое соединение закрывает вызов - пример, вызывая близко на дескрипторе соединения, который уже закрывается - должен также выдать это исключение.