com.soa.message.handler

Class HandlerChainFactory

java.lang.Object

com.soa.message.handler.HandlerChainFactory

All Implemented Interfaces:

HandlerFactory

public class HandlerChainFactory
extends java.lang.Object
implements HandlerFactory

HandlerFactory implementation that builds a chain of MessageHandlers. The chain is returned as a composite MessageHandler. The MessageHandlers in the chain are created by calling a configured list of MessageHandlerFactories.

Since:

3.1

Constructor Summary

Constructors

Constructor and Description
HandlerChainFactory() Default constructor.

Method Summary

Modifier and Type	Method and Description
MessageHandler	create(HandlerContext context, HandlerRole role) Creates a ChainHandler that implements a chain of handlers.
void	setCloseInReverse(boolean closeInReverse) Configures whether the handlers in the chain should be closed in reverse order.
void	setHandleOutInReverse(boolean handleInReverse) Configures whether the handlers in the chain should be called in reverse for out/fault messages.
void	setHandlerFactories(java.util.List<HandlerFactory> handlerFactories) Configures the list of HandlerFactories to invoke to create the handler chain.

Methods inherited from class java.lang.Object

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

Constructor Detail

HandlerChainFactory

public HandlerChainFactory()

Default constructor.

Method Detail

setHandlerFactories

public void setHandlerFactories(java.util.List<HandlerFactory> handlerFactories)

Configures the list of HandlerFactories to invoke to create the handler chain.

Parameters:

handlerFactories - List of HandlerFactory objects.

setHandleOutInReverse

public void setHandleOutInReverse(boolean handleInReverse)

Configures whether the handlers in the chain should be called in reverse for out/fault messages.

Parameters:

handleInReverse - True if handlers should be called in reverse, false if not. Default is true.

setCloseInReverse

public void setCloseInReverse(boolean closeInReverse)

Configures whether the handlers in the chain should be closed in reverse order.

Parameters:

closeInReverse - True if handlers should be closed in reverse order, false if not. Default is true.

create

public MessageHandler create(HandlerContext context,
                             HandlerRole role)
                      throws GException

Creates a ChainHandler that implements a chain of handlers.

Specified by:

create in interface HandlerFactory

Parameters:

context - HandlerContext describing the scope of the handler chain.

role - HandlerRole of the created handler.

Returns:

ChainHandler with nested handlers, null if no factories have been configured.

Throws:

GException - Thrown if an error was encountered trying to create the handler.