Package net.shibboleth.idp.saml.attribute.transcoding

Class AbstractSAML1AttributeTranscoder<EncodedType extends IdPAttributeValue>

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

net.shibboleth.idp.attribute.transcoding.AbstractAttributeTranscoder<AttributeType>

net.shibboleth.idp.saml.attribute.transcoding.AbstractSAMLAttributeTranscoder<AttributeDesignator,EncodedType>

net.shibboleth.idp.saml.attribute.transcoding.AbstractSAML1AttributeTranscoder<EncodedType>

Type Parameters:

EncodedType - the type of data that can be handled by the transcoder

All Implemented Interfaces:

AttributeTranscoder<AttributeDesignator>, SAML1AttributeTranscoder<EncodedType>, Component, DestructableComponent, InitializableComponent

Direct Known Subclasses:

SAML1ByteAttributeTranscoder, SAML1ScopedStringAttributeTranscoder, SAML1StringAttributeTranscoder, SAML1XMLObjectAttributeTranscoder

public abstract class AbstractSAML1AttributeTranscoder<EncodedType extends IdPAttributeValue>
extends AbstractSAMLAttributeTranscoder<AttributeDesignator,EncodedType>
implements SAML1AttributeTranscoder<EncodedType>

Base class for transcoders that operate on a SAML 1 Attribute or AttributeDesignator.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AbstractSAML1AttributeTranscoder.NamingFunction	A function to produce a "canonical" name for a SAML 1 AttributeDesignator for transcoding rules.

Field Summary

Fields

Modifier and Type	Field	Description
private final SAMLObjectBuilder<Attribute>	attributeBuilder	Builder used to construct Attribute objects.
private final SAMLObjectBuilder<AttributeDesignator>	designatorBuilder	Builder used to construct AttributeDesignator objects.
private final org.slf4j.Logger	log	Class logger.

Fields inherited from interface net.shibboleth.idp.saml.attribute.transcoding.SAML1AttributeTranscoder

METADATA_TAG_NAME, PROP_ENCODE_TYPE, PROP_NAME, PROP_NAME_FROM_METADATA, PROP_NAMESPACE

Constructor Summary

Constructors

Constructor	Description
AbstractSAML1AttributeTranscoder()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected AttributeDesignator	buildAttribute(ProfileRequestContext profileRequestContext, IdPAttribute attribute, Class<? extends AttributeDesignator> to, TranscodingRule rule, List<XMLObject> attributeValues)	Builds a SAML attribute element from the given attribute values.
protected IdPAttribute	buildIdPAttribute(ProfileRequestContext profileRequestContext, AttributeDesignator attribute, TranscodingRule rule, List<IdPAttributeValue> attributeValues)	Builds an IdPAttribute from the given values.
protected void	encodeName(ProfileRequestContext profileRequestContext, IdPAttribute attribute, AttributeDesignator samlAttribute, TranscodingRule rule)
String	getEncodedName(TranscodingRule rule)	Get the name of the encoded object that would be created by a given set of instructions.
Class<AttributeDesignator>	getEncodedType()	Get the class representing the type of object supported by this transcoder.
protected Iterable<XMLObject>	getValues(AttributeDesignator input)	Returns the values to decode from the concrete input object.

Methods inherited from class net.shibboleth.idp.saml.attribute.transcoding.AbstractSAMLAttributeTranscoder

canEncodeValue, decodeValue, doDecode, doEncode, encodeValue, getStringValue

Methods inherited from class net.shibboleth.idp.attribute.transcoding.AbstractAttributeTranscoder

decode, encode, getNameFromMetadata, setActivationCondition, setNameFromMetadataLookupStrategy

Methods inherited from class net.shibboleth.shared.component.AbstractInitializableComponent

checkComponentActive, checkSetterPreconditions, destroy, doDestroy, doInitialize, ifDestroyedThrowDestroyedComponentException, ifInitializedThrowUnmodifiabledComponentException, ifNotInitializedThrowUninitializedComponentException, 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.idp.attribute.transcoding.AttributeTranscoder

decode, encode

Methods inherited from interface net.shibboleth.shared.component.InitializableComponent

initialize, isInitialized

Field Details

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

attributeBuilder

@Nonnull
private final SAMLObjectBuilder<Attribute> attributeBuilder

Builder used to construct Attribute objects.

designatorBuilder

@Nonnull
private final SAMLObjectBuilder<AttributeDesignator> designatorBuilder

Builder used to construct AttributeDesignator objects.

Constructor Details

AbstractSAML1AttributeTranscoder

public AbstractSAML1AttributeTranscoder()

Constructor.

Method Details

getEncodedType

@Nonnull
public Class<AttributeDesignator> getEncodedType()

Get the class representing the type of object supported by this transcoder.

Specified by:

getEncodedType in interface AttributeTranscoder<EncodedType extends IdPAttributeValue>

Returns:

object type supported

getEncodedName

@Nullable
public String getEncodedName(@Nonnull
 TranscodingRule rule)

Get the name of the encoded object that would be created by a given set of instructions.

Specified by:

getEncodedName in interface AttributeTranscoder<EncodedType extends IdPAttributeValue>

Parameters:

rule - properties governing the encoding process

Returns:

a canonical name for objects produced by this transcoder for the given instructions

buildAttribute

@Nonnull
protected AttributeDesignator buildAttribute(@Nullable
 ProfileRequestContext profileRequestContext,
 @Nullable
 IdPAttribute attribute,
 @Nonnull
 Class<? extends AttributeDesignator> to,
 @Nonnull
 TranscodingRule rule,
 @Nonnull
 List<XMLObject> attributeValues)
                                      throws AttributeEncodingException

Builds a SAML attribute element from the given attribute values.

Specified by:

buildAttribute in class AbstractSAMLAttributeTranscoder<AttributeDesignator,EncodedType extends IdPAttributeValue>

Parameters:

profileRequestContext - current profile request

attribute - the attribute being encoded

to - target type to create

rule - properties to control encoding

attributeValues - the encoded values for the attribute

Returns:

the SAML attribute object

Throws:

AttributeEncodingException - thrown if there is a problem constructing the SAML attribute

encodeName

protected void encodeName(@Nullable
 ProfileRequestContext profileRequestContext,
 @Nullable
 IdPAttribute attribute,
 @Nonnull
 AttributeDesignator samlAttribute,
 @Nonnull
 TranscodingRule rule)
                   throws AttributeEncodingException

Throws:

AttributeEncodingException

buildIdPAttribute

@Nonnull
protected IdPAttribute buildIdPAttribute(@Nullable
 ProfileRequestContext profileRequestContext,
 @Nonnull
 AttributeDesignator attribute,
 @Nonnull
 TranscodingRule rule,
 @Nonnull
 List<IdPAttributeValue> attributeValues)
                                  throws AttributeDecodingException

Builds an IdPAttribute from the given values.

Specified by:

buildIdPAttribute in class AbstractSAMLAttributeTranscoder<AttributeDesignator,EncodedType extends IdPAttributeValue>

Parameters:

profileRequestContext - current profile request

attribute - the attribute being decoded

rule - properties to control decoding

attributeValues - the decoded values for the attribute

Returns:

the IdPAttribute object

Throws:

AttributeDecodingException - thrown if there is a problem constructing the IdPAttribute

getValues

@Nonnull
protected Iterable<XMLObject> getValues(@Nonnull
 AttributeDesignator input)

Returns the values to decode from the concrete input object.

Specified by:

getValues in class AbstractSAMLAttributeTranscoder<AttributeDesignator,EncodedType extends IdPAttributeValue>

Parameters:

input - input object

Returns:

values to decode