com.arjuna.mw.wst11.client

Class JaxWSHeaderContextProcessor

java.lang.Object

com.arjuna.mw.wst11.client.JaxWSHeaderContextProcessor

All Implemented Interfaces:

Handler<SOAPMessageContext>, SOAPHandler<SOAPMessageContext>

public class JaxWSHeaderContextProcessor
extends Object
implements SOAPHandler<SOAPMessageContext>

The class is used to perform WS-Transaction context insertion and extraction for application level SOAP messages using JaxWS. This is the client side version.

Constructor Summary

Constructors

Constructor and Description
JaxWSHeaderContextProcessor()

Method Summary

Modifier and Type	Method and Description
void	close(MessageContext messageContext) Called at the conclusion of a message exchange pattern just prior to the JAX-WS runtime disptaching a message, fault or exception.
Set<QName>	getHeaders() Gets the header blocks that can be processed by this Handler instance.
boolean	handleFault(SOAPMessageContext messageContext) Tidy up the Transaction/Thread association.
protected boolean	handleInbound(SOAPMessageContext messageContext) Tidy up the Transaction/Thread association before control is returned to the user.
boolean	handleMessage(SOAPMessageContext msgContext) Process a message.
boolean	handleMessage(SOAPMessageContext msgContext, boolean mustUnderstand) Process a message.
protected boolean	handleOutbound(SOAPMessageContext messageContext, boolean mustUnderstand) Process the tx thread context and attach serialized version as msg header
boolean	handleOutboundMessage(SOAPMessage soapMessage) Handle the request.
boolean	handleOutboundMessage(SOAPMessage soapMessage, boolean mustUnderstand) Handle the request.
protected void	resumeTransaction(SOAPMessage soapMessage) Resume the current transaction.
void	setHeaders(Set headers) Sets the header blocks that can be processed by this Handler instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JaxWSHeaderContextProcessor

public JaxWSHeaderContextProcessor()

Method Detail

handleMessage

public boolean handleMessage(SOAPMessageContext msgContext)

Process a message. Determines if it is inbound or outbound and dispatches accordingly.

Specified by:

handleMessage in interface Handler<SOAPMessageContext>

Parameters:

msgContext -

Returns:

true

handleMessage

public boolean handleMessage(SOAPMessageContext msgContext,
                             boolean mustUnderstand)

Process a message. Determines if it is inbound or outbound and dispatches accordingly.

Parameters:

msgContext -

mustUnderstand -

Returns:

true

handleFault

public boolean handleFault(SOAPMessageContext messageContext)

Tidy up the Transaction/Thread association.

Specified by:

handleFault in interface Handler<SOAPMessageContext>

Parameters:

messageContext -

Returns:

true

close

public void close(MessageContext messageContext)

Description copied from interface: Handler

Called at the conclusion of a message exchange pattern just prior to the JAX-WS runtime disptaching a message, fault or exception. Refer to the description of the handler framework in the JAX-WS specification for full details.

Specified by:

close in interface Handler<SOAPMessageContext>

Parameters:

messageContext - the message context

getHeaders

public Set<QName> getHeaders()

Gets the header blocks that can be processed by this Handler instance.

Specified by:

getHeaders in interface SOAPHandler<SOAPMessageContext>

Returns:

Set of QNames of header blocks processed by this handler instance. QName is the qualified name of the outermost element of the Header block.

setHeaders

public void setHeaders(Set headers)

Sets the header blocks that can be processed by this Handler instance. Note: this impl ignores this function's args as the values are hardcoded.

handleInbound

protected boolean handleInbound(SOAPMessageContext messageContext)

Tidy up the Transaction/Thread association before control is returned to the user.

Parameters:

messageContext -

Returns:

true

handleOutbound

protected boolean handleOutbound(SOAPMessageContext messageContext,
                                 boolean mustUnderstand)

Process the tx thread context and attach serialized version as msg header

Parameters:

messageContext -

mustUnderstand -

Returns:

true

handleOutboundMessage

public boolean handleOutboundMessage(SOAPMessage soapMessage)

Handle the request.

Parameters:

soapMessage - The current message context.

handleOutboundMessage

public boolean handleOutboundMessage(SOAPMessage soapMessage,
                                     boolean mustUnderstand)

Handle the request.

Parameters:

soapMessage - The current message context.

mustUnderstand - Value of MustUnderstand attribute.

Returns:

whether the message was handled

resumeTransaction

protected void resumeTransaction(SOAPMessage soapMessage)

Resume the current transaction.