org.jboss.jbossts.txbridge.outbound

Class JaxWSTxOutboundBridgeHandler

java.lang.Object

org.jboss.jbossts.txbridge.outbound.JaxWSTxOutboundBridgeHandler

All Implemented Interfaces:

Handler

public class JaxWSTxOutboundBridgeHandler
extends Object
implements Handler

A handler that sits in the client side JAX-WS processing pipeline between the application and the XTS header context processor. Takes the JTA transaction context provided by the former and maps it to a WS-AT transaction context for use by the latter. Handles Thread association of the WS-AT context. Note: we assume that there is a JTA transaction context present and that the service needs a WS-AT context. The handler should not be registered on methods unless both these conditions hold.

Author:

jonathan.halliday@redhat.com, 2009-02-10

Constructor Summary

Constructors

Constructor and Description
JaxWSTxOutboundBridgeHandler()

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.
boolean	handleFault(MessageContext messageContext) Tidy up the Transaction/Thread association before faults are thrown back to the client.
protected boolean	handleInbound(MessageContext msgContext) Tidy up the Transaction/Thread association before returning a message to the client.
boolean	handleMessage(MessageContext msgContext) Process a message.
protected boolean	handleOutbound(MessageContext msgContext) Process outbound messages by mapping the JTA transaction context to a WS-AT one and associating the latter to the current Thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

JaxWSTxOutboundBridgeHandler

public JaxWSTxOutboundBridgeHandler()

Method Detail

handleMessage

public boolean handleMessage(MessageContext msgContext)

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

Specified by:

handleMessage in interface Handler

Parameters:

msgContext - the context to process

Returns:

true on success, false on error

handleFault

public boolean handleFault(MessageContext messageContext)

Tidy up the Transaction/Thread association before faults are thrown back to the client.

Specified by:

handleFault in interface Handler

Parameters:

messageContext - unused

Returns:

true on success, false on error

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

Parameters:

messageContext - the message context

handleInbound

protected boolean handleInbound(MessageContext msgContext)

Tidy up the Transaction/Thread association before returning a message to the client.

Parameters:

msgContext - unused

Returns:

true on success, false on error

handleOutbound

protected boolean handleOutbound(MessageContext msgContext)

Process outbound messages by mapping the JTA transaction context to a WS-AT one and associating the latter to the current Thread.

Parameters:

msgContext - unused

Returns:

true on success, false on error