net.shibboleth.idp.attribute.resolver

Class ResolvedDataConnector

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<Map<String,IdPAttribute>>

net.shibboleth.idp.attribute.resolver.AbstractDataConnector

net.shibboleth.idp.attribute.resolver.ResolvedDataConnector

All Implemented Interfaces:

DataConnector, DataConnectorEx, ResolverPlugin<Map<String,IdPAttribute>>, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, UnmodifiableComponent, org.springframework.beans.factory.DisposableBean

@ThreadSafe
public final class ResolvedDataConnector
extends AbstractDataConnector

A proxy which wraps a resolved data connector and always returns the same attributes. The goal being that once a data connector is resolved this can be used in its place and calls to ResolverPlugin.resolve(AttributeResolutionContext) are "free". This proxy is immutable so all setter methods simply return.

Field Summary

Fields

Modifier and Type	Field and Description
private Map<String,IdPAttribute>	resolvedAttributes The attributes produced by the resolved data connector.
private DataConnector	resolvedConnector The data connector that was resolved to produce the attributes.

Constructor Summary

Constructors

Constructor and Description
ResolvedDataConnector(DataConnector connector, Map<String,IdPAttribute> attributes) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected Map<String,IdPAttribute>	doDataConnectorResolve(AttributeResolutionContext resolutionContext, AttributeResolverWorkContext workContext) Retrieves a collection of attributes from some data source.
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.
String	getFailoverDataConnectorId() Gets the ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error.
String	getId()
Map<String,IdPAttribute>	getResolvedAttributes() Gets the resolved attributes.
DataConnector	getResolvedConnector() Gets the wrapped data connector that was resolved.
int	hashCode()
boolean	isInitialized()
boolean	isPropagateResolutionExceptions() Get whether a ResolutionException that occurred resolving attributes will be re-thrown.
void	setFailoverDataConnectorId(String id) Set the ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error.
void	setPropagateResolutionExceptions(boolean propagate) Set whether an AttributeResolutionContext that occurred resolving attributes will be re-thrown.
String	toString()

Methods inherited from class net.shibboleth.idp.attribute.resolver.AbstractDataConnector

doInitialize, doResolve, getLastFail, getLogPrefix, getNoRetryDelay, setLastFail, setNoRetryDelay

Methods inherited from class net.shibboleth.idp.attribute.resolver.AbstractResolverPlugin

doDestroy, getProfileContextStrategy, resolve, setActivationCondition, setDependencies, setProfileContextStrategy

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

setId

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

destroy, initialize, isDestroyed

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.shibboleth.idp.attribute.resolver.ResolverPlugin

resolve

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

initialize

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

destroy, isDestroyed

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

destroy

Field Detail

resolvedConnector

@Nonnull
private final DataConnector resolvedConnector

The data connector that was resolved to produce the attributes.

resolvedAttributes

@Nullable
private final Map<String,IdPAttribute> resolvedAttributes

The attributes produced by the resolved data connector.

Constructor Detail

ResolvedDataConnector

public ResolvedDataConnector(@Nonnull
                     DataConnector connector,
                     @Nullable
                     Map<String,IdPAttribute> attributes)

Constructor.

Parameters:

connector - data connector that was resolved to produce the attributes

attributes - attributes produced by the resolved data connector

Method Detail

doDataConnectorResolve

@Nullable
protected Map<String,IdPAttribute> doDataConnectorResolve(@Nonnull
                                                       AttributeResolutionContext resolutionContext,
                                                       @Nonnull
                                                       AttributeResolverWorkContext workContext)
                                                   throws ResolutionException

Retrieves a collection of attributes from some data source.

Specified by:

doDataConnectorResolve in class AbstractDataConnector

Parameters:

resolutionContext - current resolution context

workContext - current resolver work context

Returns:

collected attributes indexed by attribute ID

Throws:

ResolutionException - thrown if there is a problem resolving the attributes

equals

public boolean equals(Object obj)

Overrides:

equals in class AbstractResolverPlugin<Map<String,IdPAttribute>>

getDependencies

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

Gets the unmodifiable list of dependencies for this plugin.

Specified by:

getDependencies in interface ResolverPlugin<Map<String,IdPAttribute>>

Overrides:

getDependencies in class AbstractResolverPlugin<Map<String,IdPAttribute>>

Returns:

unmodifiable list of dependencies for this plugin, never null

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<Map<String,IdPAttribute>>

Overrides:

getActivationCondition in class AbstractResolverPlugin<Map<String,IdPAttribute>>

Returns:

the predicate.

getFailoverDataConnectorId

@Nullable
public String getFailoverDataConnectorId()

Gets the ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error.

Specified by:

getFailoverDataConnectorId in interface DataConnector

Overrides:

getFailoverDataConnectorId in class AbstractDataConnector

Returns:

ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error

getId

@Nonnull
public String getId()

Specified by:

getId in interface IdentifiedComponent

Overrides:

getId in class AbstractIdentifiedInitializableComponent

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractResolverPlugin<Map<String,IdPAttribute>>

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<Map<String,IdPAttribute>>

Overrides:

isPropagateResolutionExceptions in class AbstractResolverPlugin<Map<String,IdPAttribute>>

Returns:

true if ResolutionExceptions are propagated, false if not

setFailoverDataConnectorId

public void setFailoverDataConnectorId(String id)

Set the ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error.

Overrides:

setFailoverDataConnectorId in class AbstractDataConnector

Parameters:

id - ID of the AbstractDataConnector whose values will be used in the event that this data connector experiences an error

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.

Overrides:

setPropagateResolutionExceptions in class AbstractResolverPlugin<Map<String,IdPAttribute>>

Parameters:

propagate - true if ResolutionExceptions are propagated, false if not

toString

@Nonnull
public String toString()

Overrides:

toString in class Object

getResolvedAttributes

@Nullable
public Map<String,IdPAttribute> getResolvedAttributes()

Gets the resolved attributes.

Returns:

the resolved attributes

getResolvedConnector

@Nonnull
public DataConnector getResolvedConnector()

Gets the wrapped data connector that was resolved.

Returns:

the resolved data connector

isInitialized

public boolean isInitialized()

Specified by:

isInitialized in interface InitializableComponent

Overrides:

isInitialized in class AbstractInitializableComponent