net.shibboleth.idp.attribute.resolver

Class AbstractResolverPlugin<ResolvedType>

java.lang.Object

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

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

net.shibboleth.idp.attribute.resolver.AbstractResolverPlugin<ResolvedType>

Type Parameters:

ResolvedType - object type this plug-in resolves to

All Implemented Interfaces:

ResolverPlugin<ResolvedType>, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, UnmodifiableComponent, org.springframework.beans.factory.DisposableBean

Direct Known Subclasses:

AbstractAttributeDefinition, AbstractDataConnector

@ThreadSafe
public abstract class AbstractResolverPlugin<ResolvedType>
extends AbstractIdentifiableInitializableComponent
implements ResolverPlugin<ResolvedType>, org.springframework.beans.factory.DisposableBean

Base class for all ResolverPlugins.

Field Summary

Fields

Modifier and Type	Field and Description
private com.google.common.base.Predicate<ProfileRequestContext>	activationCondition Criterion that must be met for this plugin to be active for the given request.
private Set<ResolverPluginDependency>	dependencies IDs of the ResolverPlugins this plug-in depends on.
private org.slf4j.Logger	log Class logger.
private com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext>	profileContextStrategy Strategy to get the ProfileRequestContext.
private boolean	propagateResolutionExceptions Whether an AttributeResolutionContext that occurred resolving attributes will be re-thrown.

Constructor Summary

Constructors

Constructor and Description
AbstractResolverPlugin()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doDestroy()
protected void	doInitialize()
protected abstract ResolvedType	doResolve(AttributeResolutionContext resolutionContext, AttributeResolverWorkContext workContext) Perform the actual resolution.
boolean	equals(Object obj)
com.google.common.base.Predicate<ProfileRequestContext>	getActivationCondition() Get the predicate which defines whether this plugin is active for a given request.
Set<ResolverPluginDependency>	getDependencies() Gets the unmodifiable list of dependencies for this plugin.
com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext>	getProfileContextStrategy() Gets the mechanism to find out the ProfileRequestContext.
int	hashCode()
boolean	isPropagateResolutionExceptions() Get whether a ResolutionException that occurred resolving attributes will be re-thrown.
ResolvedType	resolve(AttributeResolutionContext resolutionContext) Performs the attribute resolution for this plugin.
void	setActivationCondition(com.google.common.base.Predicate<ProfileRequestContext> pred) Sets the predicate which defines whether this plugin is active for a given request.
void	setDependencies(Set<ResolverPluginDependency> pluginDependencies) Sets the list of dependencies for this plugin.
void	setProfileContextStrategy(com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext> strategy) Sets the mechanism to find out the ProfileRequestContext.
void	setPropagateResolutionExceptions(boolean propagate) Set whether an AttributeResolutionContext that occurred resolving attributes will be re-thrown.
private boolean	startTimer(AttributeResolutionContext resolutionContext) Conditionally start a timer at the beginning of the resolution process.
private void	stopTimer(AttributeResolutionContext resolutionContext) Conditionally stop a timer at the end of the resolution process.

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Methods inherited from interface net.shibboleth.utilities.java.support.component.DestructableComponent

destroy, isDestroyed

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Methods inherited from interface org.springframework.beans.factory.DisposableBean

destroy

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

propagateResolutionExceptions

private boolean propagateResolutionExceptions

Whether an AttributeResolutionContext that occurred resolving attributes will be re-thrown.

profileContextStrategy

@Nonnull
private com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext> profileContextStrategy

Strategy to get the ProfileRequestContext.

activationCondition

@Nullable
private com.google.common.base.Predicate<ProfileRequestContext> activationCondition

Criterion that must be met for this plugin to be active for the given request.

dependencies

@Nonnull
@NonnullElements
private Set<ResolverPluginDependency> dependencies

IDs of the ResolverPlugins this plug-in depends on.

Constructor Detail

AbstractResolverPlugin

public AbstractResolverPlugin()

Method Detail

isPropagateResolutionExceptions

public boolean isPropagateResolutionExceptions()

Get whether a ResolutionException that occurred resolving attributes will be re-thrown. Doing so will cause the entire attribute resolution request to fail.

Specified by:

isPropagateResolutionExceptions in interface ResolverPlugin<ResolvedType>

Returns:

true if ResolutionExceptions are propagated, false if not

setPropagateResolutionExceptions

public void setPropagateResolutionExceptions(boolean propagate)

Set whether an AttributeResolutionContext that occurred resolving attributes will be re-thrown. Doing so will cause the entire attribute resolution request to fail.

Parameters:

propagate - true if ResolutionExceptions are propagated, false if not

setProfileContextStrategy

public void setProfileContextStrategy(com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext> strategy)

Sets the mechanism to find out the ProfileRequestContext.

Parameters:

strategy - the mechanism

getProfileContextStrategy

public com.google.common.base.Function<AttributeResolutionContext,ProfileRequestContext> getProfileContextStrategy()

Gets the mechanism to find out the ProfileRequestContext.

Returns:

the mechanism

getActivationCondition

@Nullable
public com.google.common.base.Predicate<ProfileRequestContext> getActivationCondition()

Get the predicate which defines whether this plugin is active for a given request.

Specified by:

getActivationCondition in interface ResolverPlugin<ResolvedType>

Returns:

the predicate.

setActivationCondition

public void setActivationCondition(@Nonnull
                          com.google.common.base.Predicate<ProfileRequestContext> pred)

Sets the predicate which defines whether this plugin is active for a given request.

Parameters:

pred - what to set

getDependencies

@Nonnull
@NonnullElements
@Unmodifiable
public Set<ResolverPluginDependency> getDependencies()

Gets the unmodifiable list of dependencies for this plugin.

Specified by:

getDependencies in interface ResolverPlugin<ResolvedType>

Returns:

unmodifiable list of dependencies for this plugin, never null

setDependencies

public void setDependencies(@Nullable@NullableElements
                   Set<ResolverPluginDependency> pluginDependencies)

Sets the list of dependencies for this plugin.

Parameters:

pluginDependencies - unmodifiable list of dependencies for this plugin

resolve

@Nullable
public final ResolvedType resolve(@Nonnull
                            AttributeResolutionContext resolutionContext)
                           throws ResolutionException

Performs the attribute resolution for this plugin.

This method first checks to see if this plugin has been initialized and has not be destroyed. Then it checks if the plugins activation criterion has been met. Finally it delegates to doResolve(AttributeResolutionContext, AttributeResolverWorkContext). If an exception is thrown and isPropagateResolutionExceptions() is false the exception is logged but not re-thrown, otherwise it is re-thrown.

Specified by:

resolve in interface ResolverPlugin<ResolvedType>

Parameters:

resolutionContext - current attribute resolution context

Returns:

the attributes made available by the resolution, or null if no attributes were resolved

Throws:

ResolutionException - thrown if there was a problem resolving the attributes

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class AbstractInitializableComponent

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractIdentifiedInitializableComponent

Throws:

ComponentInitializationException

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

doResolve

@Nullable
protected abstract ResolvedType doResolve(@Nonnull
                              AttributeResolutionContext resolutionContext,
                              @Nonnull
                              AttributeResolverWorkContext workContext)
                                   throws ResolutionException

Perform the actual resolution. The resolved attribute(s) should not be recorded in the work context.

Parameters:

resolutionContext - current resolution context

workContext - child context where intermediate results are tracked

Returns:

the resolved attributes or null if no attributes were resolved

Throws:

ResolutionException - thrown if there is a problem resolving the attributes

See Also:

resolve(AttributeResolutionContext)

startTimer

private boolean startTimer(@Nonnull
                 AttributeResolutionContext resolutionContext)

Conditionally start a timer at the beginning of the resolution process.

Parameters:

resolutionContext - attribute resolution context

Returns:

true iff the stopTimer(AttributeResolutionContext) method needs to be called

stopTimer

private void stopTimer(@Nonnull
             AttributeResolutionContext resolutionContext)

Conditionally stop a timer at the end of the resolution process.

Parameters:

resolutionContext - attribute resolution context