org.jboss.jbossts.txbridge.inbound

Class JaxWSTxInboundBridgeHandler

java.lang.Object

org.jboss.jbossts.txbridge.inbound.JaxWSTxInboundBridgeHandler

All Implemented Interfaces:

Handler

public class JaxWSTxInboundBridgeHandler
extends Object
implements Handler

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

Author:

jonathan.halliday@redhat.com, 2007-04-30

Constructor Summary

Constructors

Constructor and Description
JaxWSTxInboundBridgeHandler()

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 dispatching 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) Process inbound messages by mapping the WS transaction context to a JTA one and associating the latter to the current Thread.
boolean	handleMessage(MessageContext msgContext) Process a message.
protected boolean	handleOutbound(MessageContext msgContext) Tidy up the Transaction/Thread association before returning a message to the client.

Methods inherited from class java.lang.Object

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

Constructor Detail

JaxWSTxInboundBridgeHandler

public JaxWSTxInboundBridgeHandler()

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 dispatching 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)

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

Parameters:

msgContext - unused

Returns:

true on success, false on error

handleOutbound

protected boolean handleOutbound(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