Package org.frankframework.receivers

Class FrankListener

java.lang.Object

org.frankframework.receivers.FrankListener

All Implemented Interfaces:

HasPhysicalDestination, IConfigurable, IConfigurationAware, IListener<Message>, INamedObject, IPushingListener<Message>, IScopeProvider, ServiceClient, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

@Category("Basic")
public class FrankListener
extends Object
implements IPushingListener<Message>, HasPhysicalDestination, ServiceClient

Listener to receive messages sent by the FrankSender, for situations where calling an Adapter directly is not desired. This could be because message / error logging is required for messages sent to the subadapter.
See the FrankSender documentation for more information.

Constructor Summary

Constructors

Constructor	Description
FrankListener()

Method Summary

Modifier and Type	Method	Description
void	afterMessageProcessed(PipeLineResult processResult, RawMessageWrapper<Message> rawMessage, PipeLineSession pipeLineSession)	Called to perform actions (like committing or sending a reply) after a message has been processed by the Pipeline.
void	close()	Close all resources used for listening.
void	configure()	configure() is called once at startup of the framework in the configure() method of the owner of this listener.
Message	extractMessage(RawMessageWrapper<Message> rawMessage, Map<String,Object> context)	Extracts data from message obtained from IPullingListener.getRawMessage(Map) or IPushingListener.wrapRawMessage(Object, PipeLineSession).
org.springframework.context.ApplicationContext	getApplicationContext()
ClassLoader	getConfigurationClassLoader()	This ClassLoader is set upon creation of the object, used to retrieve resources configured by the Ibis application.
String	getDomain()
IMessageHandler<Message>	getHandler()
static FrankListener	getListener(String name)
String	getName()
String	getPhysicalDestinationName()
boolean	isOpen()
void	open()	Prepares the listener for receiving messages.
Message	processRequest(Message message, PipeLineSession session)	Method to implement for processing a request.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setExceptionListener(IbisExceptionListener listener)	Set a (single) listener that will be notified of any exceptions.
void	setHandler(IMessageHandler<Message> handler)	Set the handler that will do the processing of the message.
void	setName(String name)	Name of the listener by which it can be found by the FrankSender.
RawMessageWrapper<Message>	wrapRawMessage(Message rawMessage, PipeLineSession session)	Wrap a raw message in a MessageWrapper.

Methods inherited from class java.lang.Object

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

Constructor Details

FrankListener

public FrankListener()

Method Details

getListener

@Nullable
public static FrankListener getListener(String name)

getPhysicalDestinationName

public String getPhysicalDestinationName()

Specified by:

getPhysicalDestinationName in interface HasPhysicalDestination

setExceptionListener

public void setExceptionListener(IbisExceptionListener listener)

Description copied from interface: IPushingListener

Set a (single) listener that will be notified of any exceptions. The listener should use this listener to notify the receiver of any exception that occurs outside the processing of a message.

Specified by:

setExceptionListener in interface IPushingListener<Message>

wrapRawMessage

public RawMessageWrapper<Message> wrapRawMessage(Message rawMessage,
 PipeLineSession session)

Description copied from interface: IPushingListener

Wrap a raw message in a MessageWrapper. Populate PipeLineSession with properties from the message.

Specified by:

wrapRawMessage in interface IPushingListener<Message>

Parameters:

rawMessage - The raw message data, unwrapped

session - PipeLineSession to populate with properties from the message.

Returns:

Wrapped raw message

configure

public void configure()

Description copied from interface: IListener

configure() is called once at startup of the framework in the configure() method of the owner of this listener. Purpose of this method is to reduce creating connections to databases etc. in the IPullingListener.getRawMessage(Map) method. As much as possible class-instantiating should take place in the configure() or open() method, to improve performance.

Specified by:

configure in interface IConfigurable

Specified by:

configure in interface IListener<Message>

open

public void open()
          throws ListenerException

Description copied from interface: IListener

Prepares the listener for receiving messages. open() is called once each time the listener is started.

Specified by:

open in interface IListener<Message>

Throws:

ListenerException

close

public void close()

Description copied from interface: IListener

Close all resources used for listening. Called once each time the listener is stopped.

Specified by:

close in interface IListener<Message>

afterMessageProcessed

public void afterMessageProcessed(PipeLineResult processResult,
 RawMessageWrapper<Message> rawMessage,
 PipeLineSession pipeLineSession)

Description copied from interface: IListener

Called to perform actions (like committing or sending a reply) after a message has been processed by the Pipeline.

Specified by:

afterMessageProcessed in interface IListener<Message>

extractMessage

public Message extractMessage(@Nonnull
 RawMessageWrapper<Message> rawMessage,
 @Nonnull
 Map<String,Object> context)

Description copied from interface: IListener

Extracts data from message obtained from IPullingListener.getRawMessage(Map) or IPushingListener.wrapRawMessage(Object, PipeLineSession). May also extract other parameters from the message and put those into the context.

Specified by:

extractMessage in interface IListener<Message>

Parameters:

rawMessage - The RawMessageWrapper from which to extract the Message.

context - Context to populate. Either a PipeLineSession or a Map threadContext depending on caller.

Returns:

input Message for adapter.

setName

public void setName(String name)

Name of the listener by which it can be found by the FrankSender. If this is not configured, the name will default to the name of the Adapter. The name of the FrankListener must be unique across the configuration.

Specified by:

setName in interface INamedObject

Parameters:

name - Name of the listener. If not set, will default to Adapter name.

processRequest

public Message processRequest(Message message,
 PipeLineSession session)
                       throws ListenerException

Description copied from interface: ServiceClient

Method to implement for processing a request. This will usually delegate to a IListener implementation.
TODO: We may want to add the correlationId parameter back to this method, for cleaner calling and cleaner implementation.

Specified by:

processRequest in interface ServiceClient

Parameters:

message - Message to process

session - PipeLineSession of the request. If the request has a correlation ID, it should be put into this session.

Returns:

Resulting Message.

Throws:

ListenerException - Thrown if an exception occurs.

getDomain

public String getDomain()

Specified by:

getDomain in interface HasPhysicalDestination

getApplicationContext

public org.springframework.context.ApplicationContext getApplicationContext()

Specified by:

getApplicationContext in interface IConfigurationAware

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

getConfigurationClassLoader

public ClassLoader getConfigurationClassLoader()

Description copied from interface: IScopeProvider

This ClassLoader is set upon creation of the object, used to retrieve resources configured by the Ibis application.

Specified by:

getConfigurationClassLoader in interface IScopeProvider

Returns:

returns the ClassLoader created by the ClassLoaderManager.

getName

public String getName()

Specified by:

getName in interface IConfigurationAware

Specified by:

getName in interface INamedObject

isOpen

public boolean isOpen()

getHandler

public IMessageHandler<Message> getHandler()

setHandler

public void setHandler(IMessageHandler<Message> handler)

Description copied from interface: IPushingListener

Set the handler that will do the processing of the message. Each of the received messages must be pushed through handler.processMessage()

Specified by:

setHandler in interface IPushingListener<Message>