de.otto.synapse.endpoint

Class InterceptorChain

java.lang.Object

de.otto.synapse.endpoint.InterceptorChain

All Implemented Interfaces:

MessageInterceptor

@ThreadSafe
public final class InterceptorChain
extends java.lang.Object
implements MessageInterceptor

Implementation of the Composite pattern for message interceptors that can be used to build chains of interceptors.

Just like any other MessageInterceptor, the InterceptorChain is used to process a message before it is consumed by message consumers on the receiver-side, or before it is sent by a message sender to the channel infrastructure.

The interceptors of the InterceptorChain will be called in order. The result of the first interceptor is propagated to the next interceptor, and so on.

If an interceptor returns null, the chain will return null without further processing of the message.

See Also:

Composite Pattern

Constructor Summary

Constructors

Constructor and Description
InterceptorChain() Creates an unknown InterceptorChain.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
com.google.common.collect.ImmutableList<MessageInterceptor>	getInterceptors() Returns the immutable list of registered message interceptors.
int	hashCode()
Message<java.lang.String>	intercept(Message<java.lang.String> interceptedMessage) Intercepts a message using all registered interceptors and returns the resulting message.
void	register(MessageInterceptor messageInterceptor)

Methods inherited from class java.lang.Object

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

Constructor Detail

InterceptorChain

public InterceptorChain()

Creates an unknown InterceptorChain.

Method Detail

getInterceptors

public com.google.common.collect.ImmutableList<MessageInterceptor> getInterceptors()

Returns the immutable list of registered message interceptors.

Returns:

registered message interceptors

register

public void register(MessageInterceptor messageInterceptor)

intercept

@Nullable
public Message<java.lang.String> intercept(@Nonnull
                                                     Message<java.lang.String> interceptedMessage)

Intercepts a message using all registered interceptors and returns the resulting message.

The interceptors are called in order. The result of one interceptor is propagated to the next interceptor in the chain, until the end of the chain is reached, or one interceptor has returned null.

If null is returned, the message must be dropped by the AbstractMessageEndpoint.

Every interceptor may transform the message, or may take additional actions like, for example, logging, monitoring or other things.

Specified by:

intercept in interface MessageInterceptor

Parameters:

interceptedMessage - the message to intercept

Returns:

the (possibly modified) message, or null if the message should be dropped.

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object