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

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

public interface ResourceAdapter

Это представляет экземпляр адаптера ресурса и содержит операции для управления жизненным циклом и установки конечной точки сообщения. Конкретная реализация этого интерфейса обязана быть JavaBean.

Версия:

1.0

Автор:

Поршень Jeyaraman

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

void	endpointActivation(MessageEndpointFactory endpointFactory, ActivationSpec spec) Это вызывают во время активации конечной точки сообщения.
void	endpointDeactivation(MessageEndpointFactory endpointFactory, ActivationSpec spec) Это вызывают, когда конечная точка сообщения деактивирована.
XAResource[]	getXAResources(ActivationSpec[] specs) Этот метод вызывает сервер приложений во время восстановления катастрофического отказа.
void	start(BootstrapContext ctx) Это вызывают, когда экземпляр адаптера ресурса загружается.
void	stop() Это вызывают, когда экземпляр адаптера ресурса неразвертывается или во время завершения работы сервера приложений.

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

запустить

void start(BootstrapContext ctx)
           throws ResourceAdapterInternalException

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

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

Параметры:

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

Броски:

ResourceAdapterInternalException - указывает на отказ начальной загрузки. Экземпляр адаптера ресурса неприменим и должен быть отброшен.

остановиться

void stop()

Это вызывают, когда экземпляр адаптера ресурса неразвертывается или во время завершения работы сервера приложений. Это - уведомление о завершении работы от сервера приложений, и этот метод вызывает поток сервера приложений. Поток сервера приложений выполняется в неуказанном контексте.

Во время этого вызова метода ResourceAdapter JavaBean ответственен за выполнение аккуратного завершения работы экземпляра адаптера ресурса. Любое исключение, выданное этим вызовом метода, не изменяет обработку завершения работы сервера приложений или неразвертывание адаптера ресурса, которое вызвало этот вызов метода. Сервер приложений может зарегистрировать информацию об исключении в целях сообщения об ошибке.

endpointActivation

void endpointActivation(MessageEndpointFactory endpointFactory,
                        ActivationSpec spec)
                        throws ResourceException

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

Активацию конечной точки считают успешной только, когда этот метод завершается успешно, не выдавая исключений.

Параметры:

endpointFactory - экземпляр фабрики конечной точки сообщения.

spec - спецификация активации экземпляр JavaBean.

Броски:

NotSupportedException - указывает на отклонение активации конечной точки сообщения из-за неправильной информации об установке активации.

ResourceException

endpointDeactivation

void endpointDeactivation(MessageEndpointFactory endpointFactory,
                          ActivationSpec spec)

Это вызывают, когда конечная точка сообщения деактивирована. Экземпляры, которые передают как параметры этому вызову метода, должны быть идентичными тем, которых передают в для соответствия endpointActivation вызвать. Это заставляет адаптер ресурса прекращать передавать сообщения к конечной точке сообщения.

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

Параметры:

endpointFactory - экземпляр фабрики конечной точки сообщения.

spec - спецификация активации экземпляр JavaBean.

getXAResources

XAResource[] getXAResources(ActivationSpec[] specs)
                            throws ResourceException

Этот метод вызывает сервер приложений во время восстановления катастрофического отказа. Этот метод берет в массиве ActivationSpec JavaBeans и возвраты массив XAResource объекты, каждый из которых представляет уникальный менеджер ресурсов. Адаптер ресурса может возвратить нуль, если это не реализует XAResource интерфейс. Иначе, это должно возвратить массив XAResource объекты, каждый из которых представляет уникальный менеджер ресурсов, который использовался приложениями конечной точки. Сервер приложений использует XAResource объекты запросить каждый менеджер ресурсов для списка транзакций в сомнении. Это тогда завершает каждую транзакцию на ожидании, отправляя решение фиксации участвующим менеджерам ресурсов.

Параметры:

specs - массив ActivationSpec JavaBeans, каждый из которых соответствует развернутому приложению конечной точки, которое было активным до системного катастрофического отказа.

Возвраты:

массив XAResource объекты, каждый из которых представляет уникальный менеджер ресурсов.

Броски:

ResourceException - универсальное исключение, если работа перестала работать из-за состояния ошибки.