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>, Aware, MessageSource, MessageSourceAware, Action

Direct Known Subclasses:

AbstractProfileInterceptorAction, ScriptedAction

@ThreadSafe
public abstract class AbstractProfileAction<InboundMessageType,OutboundMessageType>
extends AbstractConditionalProfileAction<InboundMessageType,OutboundMessageType>
implements Action, MessageSource, 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 org.slf4j.Logger	log Class logger.
private MessageSource	messageSource MessageSource injected by Spring, typically the parent ApplicationContext itself.
private Function<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 Event	doExecute(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.
Event	execute(RequestContext springRequestContext)
String	getMessage(MessageSourceResolvable resolvable, Locale locale)
String	getMessage(String code, Object[] args, Locale locale)
String	getMessage(String code, Object[] args, String defaultMessage, Locale locale)
Function<RequestContext,ProfileRequestContext>	getProfileContextLookupStrategy() Get the strategy used to lookup the ProfileRequestContext from a given WebFlow RequestContext.
protected RequestContext	getRequestContext(ProfileRequestContext profileRequestContext) Gets the Spring RequestContext from a SpringRequestContext stored in the context tree.
protected 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(MessageSource source)
void	setProfileContextLookupStrategy(Function<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 org.slf4j.Logger log

Class logger.

profileContextLookupStrategy

@Nonnull
private Function<RequestContext,ProfileRequestContext> profileContextLookupStrategy

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

messageSource

@Nonnull
private 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 Function<RequestContext,ProfileRequestContext> getProfileContextLookupStrategy()

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

Returns:

lookup strategy

setProfileContextLookupStrategy

public void setProfileContextLookupStrategy(@Nonnull
                                   Function<RequestContext,ProfileRequestContext> strategy)

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

Parameters:

strategy - lookup strategy

execute

@Nonnull
public Event execute(@Nonnull
                    RequestContext springRequestContext)

Specified by:

execute in interface Action

doExecute

@Nonnull
protected Event doExecute(@Nonnull
                      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 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(MessageSource source)

Specified by:

setMessageSource in interface MessageSourceAware

getMessage

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

Specified by:

getMessage in interface MessageSource

getMessage

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

Specified by:

getMessage in interface MessageSource

getMessage

public String getMessage(MessageSourceResolvable resolvable,
                Locale locale)

Specified by:

getMessage in interface MessageSource

getRequestContext

@Nullable
protected 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.