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

javax.xml.rpc.handler
Обработчик интерфейса

Все Известные Классы с реализацией:

GenericHandler

public interface Handler

javax.xml.rpc.handler.Handler интерфейс обязан быть реализованным обработчиком сообщения SOAP. handleRequest, handleResponse и handleFault методы для обработчика сообщения SOAP получают доступ к SOAPMessage от SOAPMessageContext. Реализация этих методов может изменить SOAPMessage включая заголовки и элементы тела.

Версия:

1.0

Автор:

Рэхул Шарма

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

void	destroy() destroy метод указывает на конец жизненного цикла для экземпляра Обработчика.
javax.xml.namespace.QName[]	getHeaders() Получает блоки заголовка, которые могут быть обработаны этим экземпляром Обработчика.
boolean	handleFault(MessageContext context) handleFault метод обрабатывает отказы SOAP, основанные на сообщении SOAP, обрабатывающем модель.
boolean	handleRequest(MessageContext context) handleRequest метод обрабатывает сообщение запроса.
boolean	handleResponse(MessageContext context) handleResponse метод обрабатывает ответ сообщение SOAP.
void	init(HandlerInfo config) init метод позволяет экземпляру Обработчика инициализировать себя.

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

handleRequest

boolean handleRequest(MessageContext context)

handleRequest метод обрабатывает сообщение запроса.

Параметры:

context - MessageContext параметр обеспечивает доступ к сообщению запроса.

Возвраты:

булев Указывает на режим обработки

• Возвратиться true указать на продолжаемую обработку цепочки обработчика запроса. HandlerChain берет на себя ответственность вызова следующего объекта. Следующий объект может быть следующим обработчиком в HandlerChain или если этот обработчик является последним обработчиком в цепочке, следующий объект является объектом конечной точки службы.
• Возвратиться false указать на блокирование цепочки обработчика запроса. В этом случае далее обработка цепочки обработчика запроса блокируется, и целевая конечная точка службы не диспетчеризируется. Система времени выполнения JAX-RPC берет на себя ответственность вызова цепочки обработчика ответа затем с SOAPMessageContext. Реализация Обработчика class несет ответственность установки соответствующего ответа сообщение SOAP в любом handleRequest и/или handleResponse метод. В модели обработки значения по умолчанию цепочка обработчика ответа начинает обрабатывать от того же самого экземпляра Обработчика (который возвращал false), и идет назад в последовательности выполнения.

Броски:

JAXRPCException - Это исключение указывает на обработчик определенная ошибка периода выполнения. Если JAXRPCException бросается handleRequest методом, HandlerChain завершает дальнейшую обработку этой цепочки обработчика. На стороне сервера HandlerChain генерирует отказ SOAP, который указывает, что сообщение не могло быть обработано по причинам, не непосредственно относящимся к содержанию сообщения непосредственно, а скорее к ошибке периода выполнения во время обработки сообщения. На стороне клиента исключение распространяется к клиентскому коду

SOAPFaultException - Это указывает на отказ SOAP. Реализация Обработчика class несет ответственность установки отказа SOAP в сообщении SOAP в любом handleRequest и/или handleFault метод. Если SOAPFaultException бросается handleRequest методом обработчика запроса стороны сервера, HandlerChain завершает дальнейшую обработку обработчиков запроса в этой цепочке обработчика и вызывает handleFault метод на HandlerChain с контекстом сообщения SOAP. Затем, HandlerChain вызывает handleFault метод на обработчики, зарегистрированные в цепочке обработчика, начиная с экземпляра Обработчика, который выдавал исключение и движение назад в выполнении. handleRequest метод обработчика запроса стороны клиента не должен бросить SOAPFaultException.

handleResponse

boolean handleResponse(MessageContext context)

handleResponse метод обрабатывает ответ сообщение SOAP.

Параметры:

context - Параметр MessageContext обеспечивает доступ к ответу сообщение SOAP

Возвраты:

булев Указывает на режим обработки

• Возвратиться true указать на продолжаемую обработку ofthe цепочка обработчика ответа. HandlerChain вызывает handleResponse метод на следующем Handler в цепочке обработчика.
• Возвратиться false указать на блокирование цепочки обработчика ответа. В этом случае никакие другие обработчики ответа в цепочке обработчика не вызываются.

Броски:

JAXRPCException - Указывает на обработчик определенная ошибка периода выполнения. Если JAXRPCException бросается handleResponse методом, HandlerChain завершает дальнейшую обработку этой цепочки обработчика. На стороне сервера HandlerChain генерирует отказ SOAP, который указывает, что сообщение не могло быть обработано по причинам, не непосредственно относящимся к содержанию сообщения непосредственно, а скорее к ошибке периода выполнения во время обработки сообщения. На стороне клиента исключение на этапе выполнения распространяется к клиентскому коду.

handleFault

boolean handleFault(MessageContext context)

handleFault метод обрабатывает отказы SOAP, основанные на сообщении SOAP, обрабатывающем модель.

Параметры:

context - Параметр MessageContext обеспечивает доступ к сообщению SOAP

Возвраты:

булев Указывает на режим обработки

• Возвратиться true указать на продолжаемую обработку Отказа SOAP. HandlerChain вызывает handleFault метод на следующем Handler в цепочке обработчика.
• Возвратиться false указать на конец обработки отказа SOAP. В этом случае никакие другие обработчики в цепочке обработчика не вызываются.

Броски:

JAXRPCException - Указывает на обработчик определенная ошибка периода выполнения. Если JAXRPCException бросается handleFault методом, HandlerChain завершает дальнейшую обработку этой цепочки обработчика. На стороне сервера HandlerChain генерирует отказ SOAP, который указывает, что сообщение не могло быть обработано по причинам, не непосредственно относящимся к содержанию сообщения непосредственно, а скорее к ошибке периода выполнения во время обработки сообщения. На стороне клиента JAXRPCException распространяется к клиентскому коду.

init

void init(HandlerInfo config)

init метод позволяет экземпляру Обработчика инициализировать себя. init метод передает конфигурацию обработчика как a HandlerInfo экземпляр. HandlerInfo используется, чтобы сконфигурировать Обработчик (например: доступ установки к внешнему ресурсу или службе) во время инициализации.

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

Параметры:

config - Конфигурация для инициализации этого обработчика

Броски:

JAXRPCException - Если инициализация сбоев обработчика

уничтожить

void destroy()

destroy метод указывает на конец жизненного цикла для экземпляра Обработчика. Реализация Обработчика class должна высвободить свои средства и выполнить уборку в реализации destroy метод.

Броски:

JAXRPCException - Если ошибка во время уничтожает

getHeaders

javax.xml.namespace.QName[] getHeaders()

Получает блоки заголовка, которые могут быть обработаны этим экземпляром Обработчика.

Возвраты:

Массив QNames блоков заголовка обрабатывается этим экземпляром обработчика. QName полностью определенное имя наиболее удаленного элемента блока Заголовка.