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:

AbstractAuthenticationAction, AbstractCASProtocolAction, AbstractProfileInterceptorAction, AbstractSubjectCanonicalizationAction, AddAuthnStatementToAssertionFromInboundAssertionToken, AddDelegationPolicyToAssertion, AddDelegationRestrictionToAssertions, BaseAddAttributeStatementToAssertion, DecorateDelegatedAssertion, DestroySessions, DoLockoutManagerOperation, DoStorageOperation, EvaluateDelegationPolicy, ExtractSubjectFromRequest, FilterAttributes, FilterByQueriedAttributeDesignators, FilterByQueriedAttributes, FinalizeSAMLSubjectCanonicalization, FinalizeSAMLTokenProcessing, InitializeAdministrativeProfileContextTree, InitializeAuthenticationContext, InitializeOutboundMessageContext, InitializeOutboundMessageContextForError, InitializeProfileRequestContext, InitializeProxyProfileRequestContext, InitializeRelyingPartyContextFromSAMLPeer, LogContextTree, LogSpringContextInfo, MapRequestedAttributesInAttributeConsumingService, OutputMetrics, PopulateAuditContext, PopulateBindingAndEndpointContexts, PopulateDelegationContext, PopulateEncryptionParameters, PopulateInboundMessageContextWithSAMLSelf, PopulateLibertyContext, PopulateLogoutPropagationContext, PopulateMultiRPContextFromLogoutContext, PopulateOutboundMessageContext, PopulateSessionContext, PopulateSubjectContext, PopulateUserAgentContext, PrepareInboundMessageContext, PreProcessLogoutMessage, ProcessDelegatedAssertion, ProcessLogout, ProcessLogoutRequest, RecordResponseComplete, ReloadMetadata, ReloadServiceConfiguration, ResolveAttributes, RestoreProfileRequestContextTree, SaveLogoutContext, SaveProfileRequestContextTree, ScriptedAction, SelectLogoutPropagationFlow, SelectProfileConfiguration, SelectRelyingPartyConfiguration, SetRPUIInformation, SOAPLogoutRequest, UnlockDataSealers, UnlockPrivateKeys, UpdateSAMLSelfEntityContext, UpdateSessionWithSPSession, WebFlowMessageHandlerAdaptor, WebFlowProfileActionAdaptor, WriteAuditLog, WriteFTICKSLog

@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 final 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)
String	getMessage(String code, Object[] args, String defaultMessage, Locale locale)
String	getMessage(String code, Object[] args, Locale locale)
String	getMessage(MessageSourceResolvable resolvable, 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 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 Details

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 Details

AbstractProfileAction

public AbstractProfileAction()

Constructor. Initializes the ID of this action to the class name and calls setProfileContextLookupStrategy(Function) with WebflowRequestContextProfileRequestContextLookup.

Method Details

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"

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.