Package org.opensaml.profile.action

Class AbstractProfileAction

java.lang.Object

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

org.opensaml.profile.action.AbstractProfileAction

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, ProfileAction

Direct Known Subclasses:

AbstractConditionalProfileAction

@Prototype
public abstract class AbstractProfileAction
extends AbstractInitializableComponent
implements ProfileAction

Base class for profile actions. This base class is annotated with Prototype to indicate that it is stateful.

Field Summary

Fields

Modifier and Type	Field	Description
private NonnullSupplier<javax.servlet.http.HttpServletRequest>	httpServletRequestSupplier	Supplier for the Current HTTP request, if available.
private NonnullSupplier<javax.servlet.http.HttpServletResponse>	httpServletResponseSupplier	Current HTTP response, if available.
private org.slf4j.Logger	log	Logger.
private String	logPrefix	Cached log prefix.

Constructor Summary

Constructors

Constructor	Description
AbstractProfileAction()

Method Summary

Modifier and Type	Method	Description
protected void	doExecute(ProfileRequestContext profileRequestContext)	Performs this action.
protected void	doPostExecute(ProfileRequestContext profileRequestContext)	Called after execution, actions may override this method to perform post-processing for a request.
protected void	doPostExecute(ProfileRequestContext profileRequestContext, Exception e)	Called after execution, actions may override this method to perform post-processing for a request.
protected boolean	doPreExecute(ProfileRequestContext profileRequestContext)	Called prior to execution, actions may override this method to perform pre-processing for a request.
void	execute(ProfileRequestContext profileRequestContext)	Performs this action.
javax.servlet.http.HttpServletRequest	getHttpServletRequest()	Get the current HTTP request if available.
NonnullSupplier<javax.servlet.http.HttpServletRequest>	getHttpServletRequestSupplier()	Get the supplier for HTTP request if available.
javax.servlet.http.HttpServletResponse	getHttpServletResponse()	Get the current HTTP response if available.
NonnullSupplier<javax.servlet.http.HttpServletResponse>	getHttpServletResponseSupplier()	Get the current HTTP response supplier if available.
protected String	getLogPrefix()	Return a prefix for logging messages for this component.
void	setHttpServletRequest(javax.servlet.http.HttpServletRequest request)	Deprecated, for removal: This API element is subject to removal in a future version.
void	setHttpServletRequestSupplier(NonnullSupplier<javax.servlet.http.HttpServletRequest> requestSupplier)	Set the current HTTP request Supplier.
void	setHttpServletResponse(javax.servlet.http.HttpServletResponse response)	Deprecated, for removal: This API element is subject to removal in a future version.
void	setHttpServletResponseSupplier(NonnullSupplier<javax.servlet.http.HttpServletResponse> supplier)	Set the supplier of the current HTTP response.

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

private final org.slf4j.Logger log

Logger.

logPrefix

@Nullable
private String logPrefix

Cached log prefix.

httpServletRequestSupplier

@Nullable
private NonnullSupplier<javax.servlet.http.HttpServletRequest> httpServletRequestSupplier

Supplier for the Current HTTP request, if available.

httpServletResponseSupplier

@Nullable
private NonnullSupplier<javax.servlet.http.HttpServletResponse> httpServletResponseSupplier

Current HTTP response, if available.

Constructor Detail

AbstractProfileAction

public AbstractProfileAction()

Method Detail

getHttpServletRequest

@Nullable
public javax.servlet.http.HttpServletRequest getHttpServletRequest()

Get the current HTTP request if available.

Returns:

current HTTP request

getHttpServletRequestSupplier

@Nullable
public NonnullSupplier<javax.servlet.http.HttpServletRequest> getHttpServletRequestSupplier()

Get the supplier for HTTP request if available.

Returns:

current HTTP request

setHttpServletRequest

@Deprecated(since="4.3",
            forRemoval=true)
public void setHttpServletRequest(@Nullable
                                  javax.servlet.http.HttpServletRequest request)

Deprecated, for removal: This API element is subject to removal in a future version.

Set the current HTTP request.

Parameters:

request - current HTTP request

setHttpServletRequestSupplier

public void setHttpServletRequestSupplier(@Nullable
                                          NonnullSupplier<javax.servlet.http.HttpServletRequest> requestSupplier)

Set the current HTTP request Supplier.

Parameters:

requestSupplier - Supplier for the current HTTP request

getHttpServletResponse

@Nullable
public javax.servlet.http.HttpServletResponse getHttpServletResponse()

Get the current HTTP response if available.

Returns:

current HTTP response or null

getHttpServletResponseSupplier

@Nullable
public NonnullSupplier<javax.servlet.http.HttpServletResponse> getHttpServletResponseSupplier()

Get the current HTTP response supplier if available.

Returns:

current HTTP response supplier or null

setHttpServletResponse

@Deprecated(since="4.3",
            forRemoval=true)
public void setHttpServletResponse(@Nullable
                                   javax.servlet.http.HttpServletResponse response)

Deprecated, for removal: This API element is subject to removal in a future version.

Set the current HTTP response.

Parameters:

response - current HTTP response

setHttpServletResponseSupplier

public void setHttpServletResponseSupplier(@Nullable
                                           NonnullSupplier<javax.servlet.http.HttpServletResponse> supplier)

Set the supplier of the current HTTP response.

Parameters:

supplier - what to set

execute

public void execute(@Nonnull
                    ProfileRequestContext profileRequestContext)

Performs this action.

Specified by:

execute in interface ProfileAction

Parameters:

profileRequestContext - the current IdP profile request context

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.

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.

Parameters:

profileRequestContext - the current IdP profile request context

doPostExecute

protected void doPostExecute(@Nonnull
                             ProfileRequestContext profileRequestContext)

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

Actions must not "fail" during this step and will not have the opportunity to signal events at this stage. This method will not be called if doPreExecute(org.opensaml.profile.context.ProfileRequestContext) fails, but is called if an exception is raised by doExecute(org.opensaml.profile.context.ProfileRequestContext).

Parameters:

profileRequestContext - the current IdP profile request context

doPostExecute

protected void doPostExecute(@Nonnull
                             ProfileRequestContext profileRequestContext,
                             @Nonnull
                             Exception e)

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

Actions must not "fail" during this step and will not have the opportunity to signal events at this stage. This method will not be called if doPreExecute(org.opensaml.profile.context.ProfileRequestContext) fails, but is called if an exception is raised by doExecute(org.opensaml.profile.context.ProfileRequestContext).

This version of the method will be called if an exception is raised during execution of the action. The overall action result will be to raise this error, so any errors inadvertently raised by this method will be logged and superseded.

The default implementation simply calls the error-less version of this method.

Parameters:

profileRequestContext - the current IdP profile request context

e - an exception raised by the doExecute(org.opensaml.profile.context.ProfileRequestContext) method

getLogPrefix

@Nonnull
@NotEmpty
protected String getLogPrefix()

Return a prefix for logging messages for this component.

Returns:

a string for insertion at the beginning of any log messages