net.shibboleth.idp.profile

Class AbstractProfileAction<InboundMessageType,OutboundMessageType>

java.lang.Object

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

org.opensaml.profile.action.AbstractProfileAction<InboundMessageType,OutboundMessageType>

org.opensaml.profile.action.AbstractConditionalProfileAction<InboundMessageType,OutboundMessageType>

net.shibboleth.idp.profile.AbstractProfileAction<InboundMessageType,OutboundMessageType>

Type Parameters:

InboundMessageType - type of in-bound message

OutboundMessageType - type of out-bound message

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, ProfileAction<InboundMessageType,OutboundMessageType>, org.springframework.beans.factory.Aware, org.springframework.context.MessageSource, org.springframework.context.MessageSourceAware, org.springframework.webflow.execution.Action

Direct Known Subclasses:

AbstractProfileInterceptorAction, ScriptedAction

@ThreadSafe
public abstract class AbstractProfileAction<InboundMessageType,OutboundMessageType>
extends AbstractConditionalProfileAction<InboundMessageType,OutboundMessageType>
implements org.springframework.webflow.execution.Action, org.springframework.context.MessageSource, org.springframework.context.MessageSourceAware

Base class for Spring-aware profile actions.

This base class takes care of the following:

• retrieving the ProfileRequestContext from the current request environment
• populating the SWF RequestContext into the profile context tree
• starting or stopping any timers as instructed by a MetricContext in the tree

Action implementations may override doExecute(RequestContext, ProfileRequestContext) if they require SWF functionality, but most should override AbstractProfileAction.doExecute(ProfileRequestContext) instead.

Field Summary

Fields

Modifier and Type	Field and Description
private Logger	log Class logger.
private org.springframework.context.MessageSource	messageSource MessageSource injected by Spring, typically the parent ApplicationContext itself.
private com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext>	profileContextLookupStrategy Strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.

Constructor Summary

Constructors

Constructor and Description
AbstractProfileAction() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected org.springframework.webflow.execution.Event	doExecute(org.springframework.webflow.execution.RequestContext springRequestContext, ProfileRequestContext<InboundMessageType,OutboundMessageType> profileRequestContext) Spring-aware actions can override this method to fully control the execution of an Action by the Web Flow engine.
org.springframework.webflow.execution.Event	execute(org.springframework.webflow.execution.RequestContext springRequestContext)
String	getMessage(org.springframework.context.MessageSourceResolvable resolvable, Locale locale)
String	getMessage(String code, Object[] args, Locale locale)
String	getMessage(String code, Object[] args, String defaultMessage, Locale locale)
com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext>	getProfileContextLookupStrategy() Get the strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.
protected org.springframework.webflow.execution.RequestContext	getRequestContext(ProfileRequestContext profileRequestContext) Gets the Spring RequestContext from a SpringRequestContext stored in the context tree.
protected org.springframework.webflow.execution.Event	getResult(ProfileAction action, ProfileRequestContext<InboundMessageType,OutboundMessageType> profileRequestContext) Examines the profile context for an event to return, or signals a successful outcome if no EventContext is located; the EventContext will be removed upon completion.
void	setMessageSource(org.springframework.context.MessageSource source)
void	setProfileContextLookupStrategy(com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext> strategy) Set the strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.

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

doPreExecute, getActivationCondition, setActivationCondition

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

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

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

@Nonnull
private final Logger log

Class logger.

profileContextLookupStrategy

@Nonnull
private com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext> profileContextLookupStrategy

Strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.

messageSource

@Nonnull
private org.springframework.context.MessageSource messageSource

MessageSource injected by Spring, typically the parent ApplicationContext itself.

Constructor Detail

AbstractProfileAction

public AbstractProfileAction()

Constructor. Initializes the ID of this action to the class name. Initializes profileContextLookupStrategy to WebflowRequestContextProfileRequestContextLookup.

Method Detail

getProfileContextLookupStrategy

@Nonnull
public com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext> getProfileContextLookupStrategy()

Get the strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.

Returns:

lookup strategy

setProfileContextLookupStrategy

public void setProfileContextLookupStrategy(@Nonnull
                                   com.google.common.base.Function<org.springframework.webflow.execution.RequestContext,ProfileRequestContext> strategy)

Set the strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.

Parameters:

strategy - lookup strategy

execute

@Nonnull
public org.springframework.webflow.execution.Event execute(@Nonnull
                                                          org.springframework.webflow.execution.RequestContext springRequestContext)

Specified by:

execute in interface org.springframework.webflow.execution.Action

doExecute

@Nonnull
protected org.springframework.webflow.execution.Event doExecute(@Nonnull
                                                            org.springframework.webflow.execution.RequestContext springRequestContext,
                                                            @Nonnull
                                                            ProfileRequestContext<InboundMessageType,OutboundMessageType> profileRequestContext)

Spring-aware actions can override this method to fully control the execution of an Action by the Web Flow engine.

Alternatively they may override AbstractProfileAction.doExecute(ProfileRequestContext) and access Spring information via a SpringRequestContext attached to the profile request context.

The default implementation attaches the Spring Web Flow request context to the profile request context tree to "narrow" the execution signature to the basic OpenSAML ProfileAction interface. After execution, an EventContext is sought, and used to return a result back to the Web Flow engine. If no context exists, a "proceed" event is signaled.

Parameters:

springRequestContext - the Spring request context

profileRequestContext - a profile request context

Returns:

a Web Flow event produced by the action

getResult

@Nonnull
protected org.springframework.webflow.execution.Event getResult(@Nonnull
                                                            ProfileAction action,
                                                            @Nonnull
                                                            ProfileRequestContext<InboundMessageType,OutboundMessageType> profileRequestContext)

Examines the profile context for an event to return, or signals a successful outcome if no EventContext is located; the EventContext will be removed upon completion.

The EventContext must contain a Spring Web Flow Event or a String. Any other type of context data will be ignored.

Parameters:

action - the action signaling the event

profileRequestContext - the profile request context to examine

Returns:

an event based on the profile request context, or "proceed"

setMessageSource

public void setMessageSource(org.springframework.context.MessageSource source)

Specified by:

setMessageSource in interface org.springframework.context.MessageSourceAware

getMessage

public String getMessage(String code,
                Object[] args,
                String defaultMessage,
                Locale locale)

Specified by:

getMessage in interface org.springframework.context.MessageSource

getMessage

public String getMessage(String code,
                Object[] args,
                Locale locale)

Specified by:

getMessage in interface org.springframework.context.MessageSource

getMessage

public String getMessage(org.springframework.context.MessageSourceResolvable resolvable,
                Locale locale)

Specified by:

getMessage in interface org.springframework.context.MessageSource

getRequestContext

@Nullable
protected org.springframework.webflow.execution.RequestContext getRequestContext(@Nonnull
                                                                              ProfileRequestContext profileRequestContext)

Gets the Spring RequestContext from a SpringRequestContext stored in the context tree.

Parameters:

profileRequestContext - Profile request context.

Returns:

Spring request context.