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


javax.resource.spi
Интерфейс ManagedConnection


public interface ManagedConnection

Экземпляр ManagedConnection представляет физическое соединение с базовым EIS.

Экземпляр ManagedConnection обеспечивает доступ к паре интерфейсов: javax.transaction.xa.XAResource и javax.resource.spi.LocalTransaction.

XAResource интерфейс используется менеджером транзакций, чтобы связать и отделить транзакцию с базовым экземпляром менеджера ресурсов EIS и выполнить протокол двухфазной фиксации. Интерфейс ManagedConnection непосредственно не используется менеджером транзакций. Больше деталей об интерфейсе XAResource описывается в спецификации JTA.

Интерфейс LocalTransaction используется сервером приложений, чтобы управлять локальными транзакциями.

Версия:
0.5
Автор:
Рэхул Шарма
См. Также:
ManagedConnectionFactory, XAResource, LocalTransaction

Сводка метода
 void addConnectionEventListener(ConnectionEventListener listener)
          Добавляет слушатель события соединения экземпляра ManagedConnection.
 void associateConnection(java.lang.Object connection)
          Используемый обычно контейнером, чтобы изменить ассоциацию соединения уровня приложения обрабатывают с экземпляром ManagedConneciton.
 void cleanup()
          Сервер приложений вызывает этот метод, чтобы вызвать любую уборку на экземпляре ManagedConnection.
 void destroy()
          Уничтожает физическое соединение с базовым менеджером ресурсов.
 java.lang.Object getConnection(javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo)
          Создает новый дескриптор соединения для базового физического соединения, представленного экземпляром ManagedConnection.
 LocalTransaction getLocalTransaction()
          Возвраты javax.resource.spi.LocalTransaction экземпляр.
 java.io.PrintWriter getLogWriter()
          Получает писателя журнала для этого экземпляра ManagedConnection.
 ManagedConnectionMetaData getMetaData()
          Получает информацию метаданных для базового экземпляра менеджера ресурсов EIS этого соединения.
 XAResource getXAResource()
          Возвраты javax.transaction.xa.XAresource экземпляр.
 void removeConnectionEventListener(ConnectionEventListener listener)
          Удаляет уже зарегистрированного слушателя события соединения из экземпляра ManagedConnection.
 void setLogWriter(java.io.PrintWriter out)
          Устанавливает писателя журнала для этого экземпляра ManagedConnection.
 

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

getConnection

java.lang.Object getConnection(javax.security.auth.Subject subject,
                               ConnectionRequestInfo cxRequestInfo)
                               throws ResourceException
Создает новый дескриптор соединения для базового физического соединения, представленного экземпляром ManagedConnection. Этот дескриптор соединения используется кодом программы, чтобы обратиться к базовому физическому соединению. Этот дескриптор соединения связывается с его экземпляром ManagedConnection в особенном методе реализации адаптера ресурса.

ManagedConnection использует Подчиненную и дополнительную Информацию ConnectionRequest (который является определенным для адаптера ресурса и непрозрачным к серверу приложений) установить состояние физического соединения.

Параметры:
subject - контекст защиты как предмет JAAS
cxRequestInfo - Экземпляр ConnectionRequestInfo
Возвраты:
универсальный Объектный экземпляр, представляющий дескриптор соединения. Для CCI дескриптор соединения, создаваемый экземпляром ManagedConnection, имеет тип javax.resource.cci. Соединение.
Броски:
ResourceException - универсальное исключение, если работа перестала работать
ResourceAdapterInternalException - адаптер ресурса внутреннее состояние ошибки
SecurityException - безопасность связанное состояние ошибки
CommException - отказавшая передача с экземпляром EIS
EISSystemException - внутреннее состояние ошибки в экземпляре EIS - использовало, если экземпляр EIS включается в установку состояния ManagedConnection

уничтожить

void destroy()
             throws ResourceException
Уничтожает физическое соединение с базовым менеджером ресурсов.

Чтобы управлять размером пула соединения, сервер приложений может explictly вызывать ManagedConnection.destroy, чтобы уничтожить физическое соединение. Адаптер ресурса должен уничтожить все выделенные системные ресурсы для этого экземпляра ManagedConnection, когда метод уничтожает, вызывается.

Броски:
ResourceException - универсальное исключение, если работа перестала работать
IllegalStateException - недопустимое состояние для того, чтобы уничтожить соединение

уборка

void cleanup()
             throws ResourceException
Сервер приложений вызывает этот метод, чтобы вызвать любую уборку на экземпляре ManagedConnection.

Метод ManagedConnection.cleanup инициирует уборку любого специфичного для клиента состояния, утвержденного экземпляром ManagedConnection. Уборка должна лишить законной силы все дескрипторы соединения, которые были созданы, используя этот экземпляр ManagedConnection. Любая попытка компонента приложения, чтобы использовать дескриптор соединения после уборки базового ManagedConnection должна привести к исключению.

Уборка ManagedConnection всегда управляется сервером приложений. Сервер приложений не должен вызвать ManagedConnection.cleanup, когда есть незаконченная транзакция (связана с экземпляром ManagedConnection) происходящий.

Вызов метода ManagedConnection.cleanup на уже убранном соединении не должен выдать исключение.

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

Броски:
ResourceException - универсальное исключение, если работа перестала работать
ResourceAdapterInternalException - адаптер ресурса внутреннее состояние ошибки
IllegalStateException - Недопустимое состояние для того, чтобы вызвать уборку соединения. Пример - если localtransaction происходит, который не позволяет уборку соединения

associateConnection

void associateConnection(java.lang.Object connection)
                         throws ResourceException
Используемый обычно контейнером, чтобы изменить ассоциацию соединения уровня приложения обрабатывают с экземпляром ManagedConneciton. Контейнер должен найти правильный экземпляр ManagedConnection и вызвать associateConnection метод. Чтобы установить Дескриптор Соединения как активный дескриптор соединения, контейнер может также использовать associateConnection метод, чтобы установить то же самое ManagedConnection связанный с дескриптором Соединения.

Адаптер ресурса обязан реализовывать associateConnection метод. Реализация метода для ManagedConnection должна отделить дескриптор соединения (передал в качестве параметра) от его в настоящий момент связанного ManagedConnection, и свяжите новый дескриптор соединения с собой.

Параметры:
connection - Дескриптор соединения уровня приложения
Броски:
ResourceException - Отказавший, чтобы связать дескриптор соединения с этим экземпляром ManagedConnection
IllegalStateException - Недопустимое состояние для того, чтобы вызвать этот метод
ResourceAdapterInternalException - Адаптер ресурса внутреннее состояние ошибки

addConnectionEventListener

void addConnectionEventListener(ConnectionEventListener listener)
Добавляет слушатель события соединения экземпляра ManagedConnection.

Зарегистрированные экземпляры ConnectionEventListener уведомляются относительно соединения близко и ошибочных событий, также относительно локальной транзакции связанные события на Управляемом Соединении.

Параметры:
listener - новый ConnectionEventListener, который будет зарегистрирован

removeConnectionEventListener

void removeConnectionEventListener(ConnectionEventListener listener)
Удаляет уже зарегистрированного слушателя события соединения из экземпляра ManagedConnection.

Параметры:
listener - уже зарегистрированный слушатель события соединения, который будет удален

getXAResource

XAResource getXAResource()
                         throws ResourceException
Возвраты javax.transaction.xa.XAresource экземпляр. Сервер приложений включает в список этот экземпляр XAResource с Менеджером транзакций, если экземпляр ManagedConnection используется в транзакции JTA, которая координируется Менеджером транзакций.

Возвраты:
Экземпляр XAResource
Броски:
ResourceException - универсальное исключение, если работа перестала работать
NotSupportedException - если работа не поддерживается
ResourceAdapterInternalException - адаптер ресурса внутреннее состояние ошибки

getLocalTransaction

LocalTransaction getLocalTransaction()
                                     throws ResourceException
Возвраты javax.resource.spi.LocalTransaction экземпляр. Интерфейс LocalTransaction используется контейнером, чтобы управлять локальными транзакциями для экземпляра КОМНАТЫ.

Возвраты:
Экземпляр LocalTransaction
Броски:
ResourceException - универсальное исключение, если работа перестала работать
NotSupportedException - если работа не поддерживается
ResourceAdapterInternalException - адаптер ресурса внутреннее состояние ошибки

getMetaData

ManagedConnectionMetaData getMetaData()
                                      throws ResourceException

Получает информацию метаданных для базового экземпляра менеджера ресурсов EIS этого соединения. Интерфейс ManagedConnectionMetaData предоставляет информацию о базовом экземпляре EIS, связанном с экземпляром ManagedConenction.

Возвраты:
Экземпляр ManagedConnectionMetaData
Броски:
ResourceException - универсальное исключение, если работа перестала работать
NotSupportedException - если работа не поддерживается

setLogWriter

void setLogWriter(java.io.PrintWriter out)
                  throws ResourceException
Устанавливает писателя журнала для этого экземпляра ManagedConnection.

Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnection. Сервер приложений управляет ассоциацией потока вывода с экземпляром ManagedConnection, основанным на требованиях объединения в пул соединения.

Когда объект ManagedConnection первоначально создается, писатель журнала значения по умолчанию, связанный с этим экземпляром, получается из ManagedConnectionFactory. Сервер приложений может установить писателя журнала, определенного для этого ManagedConnection, чтобы регистрировать/проследить этот экземпляр, используя setLogWriter метод.

Параметры:
out - Поток Вывода символов, который будет связан
Броски:
ResourceException - универсальное исключение, если работа перестала работать
ResourceAdapterInternalException - адаптер ресурса связанное состояние ошибки

getLogWriter

java.io.PrintWriter getLogWriter()
                                 throws ResourceException
Получает писателя журнала для этого экземпляра ManagedConnection.

Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnection. ConnectionManager управляет ассоциацией потока вывода с экземпляром ManagedConnection, основанным на требованиях объединения в пул соединения.

Писатель Журнала, связанный с экземпляром ManagedConnection, может быть набором того как значением по умолчанию от ManagedConnectionFactory (который создал это соединение), или один набор определенно для этого экземпляра сервером приложений.

Возвраты:
Символ ourput поток, связанный с этим Управляемым - экземпляр Соединения
Броски:
ResourceException - универсальное исключение, если работа перестала работать


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter