net.shibboleth.idp.attribute.resolver.ad.mapped.impl

Class MappedAttributeDefinition

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<IdPAttribute>

net.shibboleth.idp.attribute.resolver.AbstractAttributeDefinition

net.shibboleth.idp.attribute.resolver.ad.mapped.impl.MappedAttributeDefinition

All Implemented Interfaces:

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

@ThreadSafe
public class MappedAttributeDefinition
extends AbstractAttributeDefinition

Implementation of Mapped Attributes.
An attribute definition that takes the values from previous resolution stages and converts them as it creates the output attribute. Each value is compared with a lookup table (a Collection of @link{ValueMap}s) and if it matches then the appropriate value(s) is/are substituted. Non matches are either passed through or are removed depending on the setting 'passThru'.

Field Summary

Fields

Modifier and Type	Field and Description
private StringAttributeValue	defaultValue Default return value.
private org.slf4j.Logger	log Class logger.
private boolean	passThru Whether the definition passes thru unmatched values.
private Set<ValueMap>	valueMaps Value maps.

Constructor Summary

Constructors

Constructor and Description
MappedAttributeDefinition()

Method Summary

Methods

Modifier and Type	Method and Description
protected IdPAttribute	doAttributeDefinitionResolve(AttributeResolutionContext resolutionContext, AttributeResolverWorkContext workContext)
protected void	doDestroy()
protected void	doInitialize()
StringAttributeValue	getDefaultAttributeValue() Gets the default return value.
String	getDefaultValue() Gets the default return value.
Collection<ValueMap>	getValueMaps() Gets the functions used to map an input value to an output value.
boolean	isPassThru() Gets whether the definition passes unmatched values through.
protected List<StringAttributeValue>	mapValue(String value) Maps the value from a dependency in to the value(s) for this attribute.
void	setDefaultValue(String newDefaultValue) Sets the default return value.
void	setPassThru(boolean newPassThru) Sets whether the definition passes unmatched values through.
void	setValueMaps(Collection<ValueMap> mappings) Sets the functions used to map an input value to an output value.

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

doResolve, getAttributeEncoders, getDisplayDescriptions, getDisplayNames, getLogPrefix, getSourceAttributeId, isDependencyOnly, setAttributeEncoders, setDependencyOnly, setDisplayDescriptions, setDisplayNames, setSourceAttributeId

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

equals, getActivationCondition, getDependencies, getProfileContextStrategy, hashCode, isPropagateResolutionExceptions, resolve, setActivationCondition, setDependencies, setProfileContextStrategy, setPropagateResolutionExceptions

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.idp.attribute.resolver.ResolverPlugin

getActivationCondition, getDependencies, isPropagateResolutionExceptions, resolve

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.

valueMaps

@Nonnull
@NonnullElements
private Set<ValueMap> valueMaps

Value maps.

passThru

private boolean passThru

Whether the definition passes thru unmatched values.

defaultValue

@Nullable
private StringAttributeValue defaultValue

Default return value.

Constructor Detail

MappedAttributeDefinition

public MappedAttributeDefinition()

Method Detail

getValueMaps

@Nonnull
@NonnullElements
@Unmodifiable
public Collection<ValueMap> getValueMaps()

Gets the functions used to map an input value to an output value.

Returns:

functions used to map an input value to an output value

setValueMaps

public void setValueMaps(@Nullable@NullableElements
                Collection<ValueMap> mappings)

Sets the functions used to map an input value to an output value.

Parameters:

mappings - functions used to map an input value to an output value

getDefaultAttributeValue

@Nullable
public StringAttributeValue getDefaultAttributeValue()

Gets the default return value.

Returns:

the default return value.

getDefaultValue

@Nullable
public String getDefaultValue()

Gets the default return value.

Returns:

the default return value.

setDefaultValue

public void setDefaultValue(@Nullable
                   String newDefaultValue)

Sets the default return value.

Parameters:

newDefaultValue - the default return value

isPassThru

public boolean isPassThru()

Gets whether the definition passes unmatched values through.

Returns:

whether the definition passes unmatched values unchanged or suppresses them.

setPassThru

public void setPassThru(boolean newPassThru)

Sets whether the definition passes unmatched values through.

Parameters:

newPassThru - whether the definition passes unmatched values unchanged or suppresses them.

mapValue

protected List<StringAttributeValue> mapValue(@Nullable
                                  String value)

Maps the value from a dependency in to the value(s) for this attribute.

Parameters:

value - the value from the dependency

Returns:

the set of attribute values that the given dependency value maps in to

doAttributeDefinitionResolve

@Nullable
protected IdPAttribute doAttributeDefinitionResolve(@Nonnull
                                                 AttributeResolutionContext resolutionContext,
                                                 @Nonnull
                                                 AttributeResolverWorkContext workContext)
                                             throws ResolutionException

Specified by:

doAttributeDefinitionResolve in class AbstractAttributeDefinition

Throws:

ResolutionException

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class AbstractResolverPlugin<IdPAttribute>

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractAttributeDefinition

Throws:

ComponentInitializationException