Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
public interface ManagedConnection
Экземпляр ManagedConnection представляет физическое соединение с базовым EIS.
Экземпляр ManagedConnection обеспечивает доступ к паре интерфейсов: javax.transaction.xa.XAResource
и javax.resource.spi.LocalTransaction
.
XAResource
интерфейс используется менеджером транзакций, чтобы связать и отделить транзакцию с базовым экземпляром менеджера ресурсов EIS и выполнить протокол двухфазной фиксации. Интерфейс ManagedConnection непосредственно не используется менеджером транзакций. Больше деталей об интерфейсе XAResource описывается в спецификации JTA.
Интерфейс LocalTransaction используется сервером приложений, чтобы управлять локальными транзакциями.
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. |
Деталь метода |
---|
java.lang.Object getConnection(javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException
ManagedConnection использует Подчиненную и дополнительную Информацию ConnectionRequest (который является определенным для адаптера ресурса и непрозрачным к серверу приложений) установить состояние физического соединения.
subject
- контекст защиты как предмет JAAScxRequestInfo
- Экземпляр ConnectionRequestInfo ResourceException
- универсальное исключение, если работа перестала работать ResourceAdapterInternalException
- адаптер ресурса внутреннее состояние ошибки SecurityException
- безопасность связанное состояние ошибки CommException
- отказавшая передача с экземпляром EIS EISSystemException
- внутреннее состояние ошибки в экземпляре EIS - использовало, если экземпляр EIS включается в установку состояния ManagedConnectionvoid destroy() throws ResourceException
Чтобы управлять размером пула соединения, сервер приложений может explictly вызывать ManagedConnection.destroy, чтобы уничтожить физическое соединение. Адаптер ресурса должен уничтожить все выделенные системные ресурсы для этого экземпляра ManagedConnection, когда метод уничтожает, вызывается.
ResourceException
- универсальное исключение, если работа перестала работать IllegalStateException
- недопустимое состояние для того, чтобы уничтожить соединениеvoid cleanup() throws ResourceException
Метод ManagedConnection.cleanup инициирует уборку любого специфичного для клиента состояния, утвержденного экземпляром ManagedConnection. Уборка должна лишить законной силы все дескрипторы соединения, которые были созданы, используя этот экземпляр ManagedConnection. Любая попытка компонента приложения, чтобы использовать дескриптор соединения после уборки базового ManagedConnection должна привести к исключению.
Уборка ManagedConnection всегда управляется сервером приложений. Сервер приложений не должен вызвать ManagedConnection.cleanup, когда есть незаконченная транзакция (связана с экземпляром ManagedConnection) происходящий.
Вызов метода ManagedConnection.cleanup на уже убранном соединении не должен выдать исключение.
Уборка экземпляра ManagedConnection сбрасывает свой клиент определенное состояние и готовит соединение, которое будет отложено в к пулу соединения. Метод уборки не должен заставить адаптер ресурса закрывать физический канал и исправлять системные ресурсы, связанные с физическим соединением.
ResourceException
- универсальное исключение, если работа перестала работать ResourceAdapterInternalException
- адаптер ресурса внутреннее состояние ошибки IllegalStateException
- Недопустимое состояние для того, чтобы вызвать уборку соединения. Пример - если localtransaction происходит, который не позволяет уборку соединенияvoid associateConnection(java.lang.Object connection) throws ResourceException
associateConnection
метод, чтобы установить то же самое ManagedConnection
связанный с дескриптором Соединения. Адаптер ресурса обязан реализовывать associateConnection метод. Реализация метода для ManagedConnection должна отделить дескриптор соединения (передал в качестве параметра) от его в настоящий момент связанного ManagedConnection, и свяжите новый дескриптор соединения с собой.
connection
- Дескриптор соединения уровня приложения ResourceException
- Отказавший, чтобы связать дескриптор соединения с этим экземпляром ManagedConnection IllegalStateException
- Недопустимое состояние для того, чтобы вызвать этот метод ResourceAdapterInternalException
- Адаптер ресурса внутреннее состояние ошибкиvoid addConnectionEventListener(ConnectionEventListener listener)
Зарегистрированные экземпляры ConnectionEventListener уведомляются относительно соединения близко и ошибочных событий, также относительно локальной транзакции связанные события на Управляемом Соединении.
listener
- новый ConnectionEventListener, который будет зарегистрированvoid removeConnectionEventListener(ConnectionEventListener listener)
listener
- уже зарегистрированный слушатель события соединения, который будет удаленXAResource getXAResource() throws ResourceException
javax.transaction.xa.XAresource
экземпляр. Сервер приложений включает в список этот экземпляр XAResource с Менеджером транзакций, если экземпляр ManagedConnection используется в транзакции JTA, которая координируется Менеджером транзакций.
ResourceException
- универсальное исключение, если работа перестала работать NotSupportedException
- если работа не поддерживается ResourceAdapterInternalException
- адаптер ресурса внутреннее состояние ошибкиLocalTransaction getLocalTransaction() throws ResourceException
javax.resource.spi.LocalTransaction
экземпляр. Интерфейс LocalTransaction используется контейнером, чтобы управлять локальными транзакциями для экземпляра КОМНАТЫ.
ResourceException
- универсальное исключение, если работа перестала работать NotSupportedException
- если работа не поддерживается ResourceAdapterInternalException
- адаптер ресурса внутреннее состояние ошибкиManagedConnectionMetaData getMetaData() throws ResourceException
Получает информацию метаданных для базового экземпляра менеджера ресурсов EIS этого соединения. Интерфейс ManagedConnectionMetaData предоставляет информацию о базовом экземпляре EIS, связанном с экземпляром ManagedConenction.
ResourceException
- универсальное исключение, если работа перестала работать NotSupportedException
- если работа не поддерживаетсяvoid setLogWriter(java.io.PrintWriter out) throws ResourceException
Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnection. Сервер приложений управляет ассоциацией потока вывода с экземпляром ManagedConnection, основанным на требованиях объединения в пул соединения.
Когда объект ManagedConnection первоначально создается, писатель журнала значения по умолчанию, связанный с этим экземпляром, получается из ManagedConnectionFactory. Сервер приложений может установить писателя журнала, определенного для этого ManagedConnection, чтобы регистрировать/проследить этот экземпляр, используя setLogWriter метод.
out
- Поток Вывода символов, который будет связан ResourceException
- универсальное исключение, если работа перестала работать ResourceAdapterInternalException
- адаптер ресурса связанное состояние ошибкиjava.io.PrintWriter getLogWriter() throws ResourceException
Писатель журнала является потоком вывода символов, к которому будут напечатаны все журналирование и трассировка сообщений для этого экземпляра ManagedConnection. ConnectionManager управляет ассоциацией потока вывода с экземпляром ManagedConnection, основанным на требованиях объединения в пул соединения.
Писатель Журнала, связанный с экземпляром ManagedConnection, может быть набором того как значением по умолчанию от ManagedConnectionFactory (который создал это соединение), или один набор определенно для этого экземпляра сервером приложений.
ResourceException
- универсальное исключение, если работа перестала работать
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41