Package net.shibboleth.idp.profile

Class AbstractProfileAction

java.lang.Object

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

org.opensaml.profile.action.AbstractProfileAction

org.opensaml.profile.action.AbstractConditionalProfileAction

net.shibboleth.idp.profile.AbstractProfileAction

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, ProfileAction, Aware, MessageSource, MessageSourceAware, Action

Direct Known Subclasses:

AbstractProfileInterceptorAction, ScriptedAction

@ThreadSafe
public abstract class AbstractProfileAction
extends AbstractConditionalProfileAction
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	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	Description
AbstractProfileAction()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected Event	doExecute(RequestContext springRequestContext, ProfileRequestContext 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)
protected <T> T	getBean(ProfileRequestContext profileRequestContext, String name, Class<T> claz)	Utilizes the active flow's ApplicationContext to obtain a bean of a given name and class.
protected <T> T	getBean(RequestContext flowRequestContext, String name, Class<T> claz)	Utilizes the active flow's ApplicationContext to obtain a bean of a given name and class.
String	getMessage(String code, Object[] args, String defaultMessage, Locale locale)
String	getMessage(String code, Object[] args, Locale locale)
String	getMessage(MessageSourceResolvable resolvable, Locale locale)
protected <T> T	getParameter(ProfileRequestContext profileRequestContext, String name)	Return a casted parameter of a given name from the flow's flow or conversation scope (in that order).
protected <T> T	getParameter(RequestContext flowRequestContext, String name)	Return a casted parameter of a given name from the flow's flow or conversation scope (in that order).
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 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, getHttpServletRequestSupplier, getHttpServletResponse, getHttpServletResponseSupplier, getLogPrefix, setHttpServletRequest, setHttpServletRequestSupplier, setHttpServletResponse, setHttpServletResponseSupplier

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 and calls setProfileContextLookupStrategy(Function) with 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 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 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"

getBean

@Nullable
protected <T> T getBean(@Nonnull
                        ProfileRequestContext profileRequestContext,
                        @Nonnull @NotEmpty
                        String name,
                        @Nonnull
                        Class<T> claz)

Utilizes the active flow's ApplicationContext to obtain a bean of a given name and class.

Type Parameters:

T - the bean type

Parameters:

profileRequestContext - the profile request context

name - bean name

claz - bean type

Returns:

the bean or null

Since:

4.3.0

getBean

@Nullable
protected <T> T getBean(@Nonnull
                        RequestContext flowRequestContext,
                        @Nonnull @NotEmpty
                        String name,
                        @Nonnull
                        Class<T> claz)

Utilizes the active flow's ApplicationContext to obtain a bean of a given name and class.

Type Parameters:

T - the bean type

Parameters:

flowRequestContext - the active flow's request context

name - bean name

claz - bean type

Returns:

the bean or null

Since:

4.3.0

getParameter

@Nullable
protected <T> T getParameter(@Nonnull
                             ProfileRequestContext profileRequestContext,
                             @Nonnull @NotEmpty
                             String name)

Return a casted parameter of a given name from the flow's flow or conversation scope (in that order).

Type Parameters:

T - the parameter type

Parameters:

profileRequestContext - profile request context

name - parameter name

Returns:

the parameter or null

Since:

4.3.0

getParameter

@Nullable
protected <T> T getParameter(@Nonnull
                             RequestContext flowRequestContext,
                             @Nonnull @NotEmpty
                             String name)

Return a casted parameter of a given name from the flow's flow or conversation scope (in that order).

Type Parameters:

T - the parameter type

Parameters:

flowRequestContext - the active flow's request context

name - parameter name

Returns:

the parameter or null

Since:

4.3.0

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.