| com.sun.xml.internal.ws.spi.runtime.SystemHandlerDelegate
SystemHandlerDelegate | public interface SystemHandlerDelegate (Code) | | A SystemHandlerDelegate is used to inject system level functionality into a
message processing runtime. The methods of this interface are invoked by
the client and enpoint message dispatchers of the message processing
runtime.
author: WS Development Team |
Method Summary | |
public void | preInvokeEndpointHook(MessageContext messageContext) This method must be called by an endpoint message dispatcher after
MustUnderstand processing and before endpoint invocation. | public boolean | processRequest(MessageContext messageContext) Called by both client and endpoint message dispatchers to activate
injected request message processing.
When called by a client side message dispatcher, this method must be
called just before the message (associated with the MessageContext)
is sent. | public void | processResponse(MessageContext messageContext) Called by both client and endpoint message dispatchers to activate
injected response message processing.
When called by the message dispatcher at the client, this method must be
called before MustUnderstand processing on the received message
(associated with the MessageContext). |
preInvokeEndpointHook | public void preInvokeEndpointHook(MessageContext messageContext)(Code) | | This method must be called by an endpoint message dispatcher after
MustUnderstand processing and before endpoint invocation.
Parameters: messageContext - when called by a SOAPBinding the argumentmust be an instanceof com.sun.xml.internal.ws.spi.runtime.SOAPMessageContext, andmust have values assigned for the following MessageContext properties.- MessageContext.SERVLET_REQUEST
- MessageContext.SERVLET_RESPONSE
- MessageContext.SERVLET_SESSION
- MessageContext.SERVLET_CONTEXT
|
processRequest | public boolean processRequest(MessageContext messageContext) throws Exception(Code) | | Called by both client and endpoint message dispatchers to activate
injected request message processing.
When called by a client side message dispatcher, this method must be
called just before the message (associated with the MessageContext)
is sent. When called by the message dispatcher at an endpoint, this
method must be called before MustUnderstand processing on the
associated message.
Parameters: messageContext - when called by a SOAPBinding the argumentmust be an instanceof com.sun.xml.internal.ws.spi.runtime.SOAPMessageContext, andwhen called by a SOAPBinding at an endpoint, the argument mustbe an instanceof com.sun.xml.internal.ws.spi.runtime.SOAPMessageContext and the Invoker (on the context) must be available for use on the server by the delegate. An argument SOAPMessageContext passed to this method by an endpointdispatcher, must have values assigned for the following MessageContext properties.- MessageContext.SERVLET_REQUEST
- MessageContext.SERVLET_RESPONSE
- MessageContext.SERVLET_SESSION
- MessageContext.SERVLET_CONTEXT
true if processing by the delegate was such that the callershould continue with its normal message processing. Returns false when the delegate has established, in the MessageContext, the response message to be sent. When this method returns false, the calling message dispatcher must return the response message without performing MustUnderstand processing and without invoking the endpoint. Only delegates called by endpoint side message dispatchers may return false throws: java.lang.Exception - when the processing by the delegate failedwithout yielding a response message; in which case, the caller shalldetermine how to process the error. |
processResponse | public void processResponse(MessageContext messageContext) throws Exception(Code) | | Called by both client and endpoint message dispatchers to activate
injected response message processing.
When called by the message dispatcher at the client, this method must be
called before MustUnderstand processing on the received message
(associated with the MessageContext). When called by the message
dispatcher at an endpoint, this method must be called after the
endpoint has been invoked, and just before the associated response
message is sent. In the special case where invocation of the endpoint
caused an Exception to be thrown, this method must not be called.
Parameters: messageContext - when called by a SOAPBinding the argumentmust be an instanceof com.sun.xml.internal.ws.spi.runtime.SOAPMessageContext. throws: java.lang.Exception - when the processing by the delegate failed.In this case, the caller must not send the response message but shall otherwise determine how to process the error. |
|
|