org.opensaml.profile.action.impl

Class EncodeMessage

java.lang.Object

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

org.opensaml.profile.action.AbstractProfileAction

org.opensaml.profile.action.impl.EncodeMessage

All Implemented Interfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, ProfileAction

public class EncodeMessage
extends AbstractProfileAction

Action that encodes an outbound response from the outbound MessageContext.

The MessageEncoderFactory is used to obtain a new MessageEncoder to use, and the encoder is destroyed upon completion.

Field Summary

Fields

Modifier and Type	Field and Description
private MessageEncoderFactory	encoderFactory The factory to use to obtain an encoder.
private org.slf4j.Logger	log Class logger.
private MessageHandler	messageHandler An optional MessageHandler instance to be invoked after MessageEncoder.prepareContext() and prior to MessageEncoder.encode().
private MessageContext	msgContext The outbound MessageContext to encode.

Constructor Summary

Constructors

Constructor and Description
EncodeMessage()

Method Summary

Modifier and Type	Method and Description
protected void	doExecute(ProfileRequestContext profileRequestContext) Performs this action.
protected void	doInitialize()
protected boolean	doPreExecute(ProfileRequestContext profileRequestContext) Called prior to execution, actions may override this method to perform pre-processing for a request.
void	setMessageEncoderFactory(MessageEncoderFactory factory) Set the encoder factory to use.
void	setMessageHandler(MessageHandler handler) The supplied MessageHandler will be invoked on the MessageContext after MessageEncoder.prepareContext(), and prior to invoking MessageEncoder.encode().

Methods inherited from class org.opensaml.profile.action.AbstractProfileAction

doPostExecute, doPostExecute, execute, getHttpServletRequest, getHttpServletResponse, getLogPrefix, setHttpServletRequest, setHttpServletResponse

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

destroy, doDestroy, 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

@Nonnull
private final org.slf4j.Logger log

Class logger.

encoderFactory

@NonnullAfterInit
private MessageEncoderFactory encoderFactory

The factory to use to obtain an encoder.

messageHandler

@Nullable
private MessageHandler messageHandler

An optional MessageHandler instance to be invoked after MessageEncoder.prepareContext() and prior to MessageEncoder.encode().

msgContext

@Nullable
private MessageContext msgContext

The outbound MessageContext to encode.

Constructor Detail

EncodeMessage

public EncodeMessage()

Method Detail

setMessageEncoderFactory

public void setMessageEncoderFactory(@Nonnull
                                     MessageEncoderFactory factory)

Set the encoder factory to use.

Parameters:

factory - factory to use

setMessageHandler

public void setMessageHandler(@Nullable
                              MessageHandler handler)

The supplied MessageHandler will be invoked on the MessageContext after MessageEncoder.prepareContext(), and prior to invoking MessageEncoder.encode(). Its use is optional and primarily used for transport/binding-specific message handling, as opposed to more generalized message handling operations which would typically be invoked earlier than this action. For more details see MessageEncoder.

Parameters:

handler - a message handler

doInitialize

protected void doInitialize()
                     throws net.shibboleth.utilities.java.support.component.ComponentInitializationException

Overrides:

doInitialize in class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

Throws:

net.shibboleth.utilities.java.support.component.ComponentInitializationException

doPreExecute

protected boolean doPreExecute(@Nonnull
                               ProfileRequestContext profileRequestContext)

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

If false is returned, execution will not proceed, and the action should attach an EventContext to the context tree to signal how to continue with overall workflow processing.

If returning successfully, the last step should be to return the result of the superclass version of this method.

Overrides:

doPreExecute in class AbstractProfileAction

Parameters:

profileRequestContext - the current IdP profile request context

Returns:

true iff execution should proceed

doExecute

protected void doExecute(@Nonnull
                         ProfileRequestContext profileRequestContext)

Performs this action. Actions must override this method to perform their work.

Overrides:

doExecute in class AbstractProfileAction

Parameters:

profileRequestContext - the current IdP profile request context