org.opensaml.messaging.handler

Class AbstractMessageHandler<MessageType>

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

org.opensaml.messaging.handler.AbstractMessageHandler<MessageType>

Type Parameters:

MessageType - the type of message being handled

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, MessageHandler<MessageType>

@Prototype
public abstract class AbstractMessageHandler<MessageType>
extends AbstractInitializableComponent
implements MessageHandler<MessageType>

A base abstract implementation of MessageHandler.

Field Summary

Fields

Modifier and Type	Field and Description
private com.google.common.base.Predicate<MessageContext>	activationCondition Condition dictating whether to run or not.
private org.slf4j.Logger	log Logger.

Constructor Summary

Constructors

Constructor and Description
AbstractMessageHandler() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	doInvoke(MessageContext<MessageType> messageContext) Performs the handler logic.
protected void	doPostInvoke(MessageContext<MessageType> messageContext) Called after execution, handlers may override this method to perform post-processing for a request.
protected void	doPostInvoke(MessageContext<MessageType> messageContext, Exception e) Called after execution, handlers may override this method to perform post-processing for a request.
protected boolean	doPreInvoke(MessageContext<MessageType> messageContext) Called prior to execution, handlers may override this method to perform pre-processing for a request.
com.google.common.base.Predicate<MessageContext>	getActivationCondition() Get activation condition indicating whether the handler should be invoked.
protected String	getLogPrefix() Return a prefix for logging messages for this component.
void	invoke(MessageContext<MessageType> messageContext) Invoke the handler on the specified message context.
void	setActivationCondition(com.google.common.base.Predicate<MessageContext> condition) Set activation condition indicating whether the handler should be invoked.

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, doDestroy, doInitialize, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Field Detail

log

private org.slf4j.Logger log

Logger.

activationCondition

@Nonnull
private com.google.common.base.Predicate<MessageContext> activationCondition

Condition dictating whether to run or not.

Constructor Detail

AbstractMessageHandler

public AbstractMessageHandler()

Constructor.

Method Detail

getActivationCondition

@Nonnull
public com.google.common.base.Predicate<MessageContext> getActivationCondition()

Get activation condition indicating whether the handler should be invoked.

Defaults to a predicate which always returns true.

Returns:

activation condition

setActivationCondition

public void setActivationCondition(@Nonnull
                          com.google.common.base.Predicate<MessageContext> condition)

Set activation condition indicating whether the handler should be invoked.

Defaults to a predicate which always returns true.

Parameters:

condition - predicate to apply

invoke

public void invoke(@Nonnull
          MessageContext<MessageType> messageContext)
            throws MessageHandlerException

Invoke the handler on the specified message context.

Specified by:

invoke in interface MessageHandler<MessageType>

Parameters:

messageContext - the message context on which to invoke the handler

Throws:

MessageHandlerException - if the there is an error invoking the handler on the message context

doPreInvoke

protected boolean doPreInvoke(@Nonnull
                  MessageContext<MessageType> messageContext)
                       throws MessageHandlerException

Called prior to execution, handlers may override this method to perform pre-processing for a request.

The default impl applies the Predicate set via the setActivationCondition(Predicate).

If false is returned, execution will not proceed.

Subclasses which override this method should generally invoke the super version of this method first, so that the activation condition will be applied up front, and immediately return false if the super version returns false. This avoids unnecessary execution of the remaining pre-invocation code if the handler ultimately will not execute.

Parameters:

messageContext - the message context on which to invoke the handler

Returns:

true iff execution should proceed

Throws:

MessageHandlerException - if there is a problem executing the handler pre-routine

doInvoke

protected abstract void doInvoke(@Nonnull
            MessageContext<MessageType> messageContext)
                          throws MessageHandlerException

Performs the handler logic.

Parameters:

messageContext - the message context on which to invoke the handler

Throws:

MessageHandlerException - if there is an error invoking the handler on the message context

doPostInvoke

protected void doPostInvoke(@Nonnull
                MessageContext<MessageType> messageContext)

Called after execution, handlers may override this method to perform post-processing for a request.

Handlers must not "fail" during this step. This method will not be called if doPreInvoke(org.opensaml.messaging.context.MessageContext<MessageType>) fails, but is called if an exception is raised by doInvoke(org.opensaml.messaging.context.MessageContext<MessageType>).

Parameters:

messageContext - the message context on which the handler was invoked

doPostInvoke

protected void doPostInvoke(@Nonnull
                MessageContext<MessageType> messageContext,
                @Nonnull
                Exception e)

Called after execution, handlers may override this method to perform post-processing for a request.

Handlers must not "fail" during this step. This method will not be called if doPreInvoke(org.opensaml.messaging.context.MessageContext<MessageType>) fails, but is called if an exception is raised by doInvoke(org.opensaml.messaging.context.MessageContext<MessageType>).

This version of the method will be called if an exception is raised during execution of the handler. The overall handler result will be to raise this error, so any errors inadvertently raised by this method will be logged and superseded.

The default implementation simply calls the error-less version of this method.

Parameters:

messageContext - the message context on which the handler was invoked

e - an exception raised by the doInvoke(org.opensaml.messaging.context.MessageContext<MessageType>) method

getLogPrefix

@Nonnull
@NotEmpty
protected String getLogPrefix()

Return a prefix for logging messages for this component.

Returns:

a string for insertion at the beginning of any log messages