com.arjuna.webservices11.wsarj.handler

Class InstanceIdentifierHandler

java.lang.Object

com.arjuna.webservices11.wsarj.handler.InstanceIdentifierHandler

All Implemented Interfaces:

Handler<SOAPMessageContext>, SOAPHandler<SOAPMessageContext>

Direct Known Subclasses:

InstanceIdentifierInHandler

public class InstanceIdentifierHandler
extends Object
implements SOAPHandler<SOAPMessageContext>

Header handler for parsing the Arjuna WS instance identifier header.

Author:

adinn

Constructor Summary

Constructors

Constructor and Description
InstanceIdentifierHandler()

Method Summary

Modifier and Type	Method and Description
void	close(MessageContext context) this hanlder ignores close messages
Set<QName>	getHeaders() Gets the header blocks that can be processed by this Handler instance.
boolean	handleFault(SOAPMessageContext context) this handler ignores faults but allows other handlers to deal with them
boolean	handleMessage(SOAPMessageContext context) Handle an outgoing message by inserting any current arjuna context attached to the context into the message headers and handle an incoming message by retrieving the context from the headers and attaching it to the context,
protected boolean	handleMessageOutbound(SOAPMessageContext context) check for an arjuna context attached to the message context and, if found, install its identifier as the value of a soap message header element

Methods inherited from class java.lang.Object

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

Constructor Detail

InstanceIdentifierHandler

public InstanceIdentifierHandler()

Method Detail

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.

handleMessage

public boolean handleMessage(SOAPMessageContext context)
                      throws ProtocolException

Handle an outgoing message by inserting any current arjuna context attached to the context into the message headers and handle an incoming message by retrieving the context from the headers and attaching it to the context,

Specified by:

handleMessage in interface Handler<SOAPMessageContext>

Parameters:

context - the message context.

Returns:

Always return true

Throws:

RuntimeException - Causes the JAX-WS runtime to cease handler processing and generate a fault.

ProtocolException - Causes the JAX-WS runtime to switch to fault message processing.

handleMessageOutbound

protected boolean handleMessageOutbound(SOAPMessageContext context)
                                 throws ProtocolException

check for an arjuna context attached to the message context and, if found, install its identifier as the value of a soap message header element

Parameters:

context -

Returns:

Throws:

ProtocolException

handleFault

public boolean handleFault(SOAPMessageContext context)

this handler ignores faults but allows other handlers to deal with them

Specified by:

handleFault in interface Handler<SOAPMessageContext>

Parameters:

context - the message context

Returns:

true to allow fault handling to continue

close

public void close(MessageContext context)

this hanlder ignores close messages

Specified by:

close in interface Handler<SOAPMessageContext>

Parameters:

context - the message context