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

Class SAML2XMLObjectAttributeTranscoder

java.lang.Object

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

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

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

net.shibboleth.idp.saml.attribute.transcoding.AbstractSAML2AttributeTranscoder<XMLObjectAttributeValue>

net.shibboleth.idp.saml.attribute.transcoding.impl.SAML2XMLObjectAttributeTranscoder

All Implemented Interfaces:

AttributeTranscoder<Attribute>, SAML2AttributeTranscoder<XMLObjectAttributeValue>, Component, DestructableComponent, InitializableComponent

public class SAML2XMLObjectAttributeTranscoder
extends AbstractSAML2AttributeTranscoder<XMLObjectAttributeValue>

AttributeTranscoder that supports Attribute and XMLObjectAttributeValue objects.

Nested Class Summary

Nested classes/interfaces inherited from class net.shibboleth.idp.saml.attribute.transcoding.AbstractSAML2AttributeTranscoder

AbstractSAML2AttributeTranscoder.NamingFunction

Field Summary

Fields

Modifier and Type	Field	Description
private final org.slf4j.Logger	log	Class logger.
static final String	PROP_INCLUDE_ATTR_VALUE	Property indicating whether to decode the AttributeValue element itself, or its child element.

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

PROP_ENCODE_TYPE, PROP_FRIENDLY_NAME, PROP_NAME, PROP_NAME_FORMAT

Constructor Summary

Constructors

Constructor	Description
SAML2XMLObjectAttributeTranscoder()

Method Summary

Modifier and Type	Method	Description
protected boolean	canEncodeValue(IdPAttribute attribute, IdPAttributeValue value)	Checks if the given value can be handled by the transcoder.
protected IdPAttributeValue	decodeValue(ProfileRequestContext profileRequestContext, Attribute attribute, TranscodingRule rule, XMLObject value)	Function to decode a single XMLObject into an IdPAttributeValue.
protected XMLObject	encodeValue(ProfileRequestContext profileRequestContext, IdPAttribute attribute, TranscodingRule rule, XMLObjectAttributeValue value)	Encodes an attribute value into a SAML AttributeValue element.

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

buildAttribute, buildIdPAttribute, getEncodedName, getEncodedType, getValues

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

doDecode, doEncode, getStringValue

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

decode, encode, setActivationCondition

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.idp.attribute.transcoding.AttributeTranscoder

decode, encode

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

initialize, isInitialized

Field Details

PROP_INCLUDE_ATTR_VALUE

@Nonnull
@NotEmpty
public static final String PROP_INCLUDE_ATTR_VALUE

Property indicating whether to decode the AttributeValue element itself, or its child element.

See Also:

• Constant Field Values

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

Constructor Details

SAML2XMLObjectAttributeTranscoder

public SAML2XMLObjectAttributeTranscoder()

Method Details

canEncodeValue

protected boolean canEncodeValue(@Nonnull
 IdPAttribute attribute,
 @Nonnull
 IdPAttributeValue value)

Checks if the given value can be handled by the transcoder.

In many cases this is simply a check to see if the given object is of the right type.

Specified by:

canEncodeValue in class AbstractSAMLAttributeTranscoder<Attribute,XMLObjectAttributeValue>

Parameters:

attribute - the attribute being encoded, never null

value - the value to check, never null

Returns:

true if the transcoder can encode this value, false if not

encodeValue

@Nullable
protected XMLObject encodeValue(@Nullable
 ProfileRequestContext profileRequestContext,
 @Nonnull
 IdPAttribute attribute,
 @Nonnull
 TranscodingRule rule,
 @Nonnull
 XMLObjectAttributeValue value)
                         throws AttributeEncodingException

Encodes an attribute value into a SAML AttributeValue element.

Specified by:

encodeValue in class AbstractSAMLAttributeTranscoder<Attribute,XMLObjectAttributeValue>

Parameters:

profileRequestContext - current profile request

attribute - the attribute being encoded

rule - properties to control encoding

value - the value to encode

Returns:

the attribute value or null if the resulting attribute value would be empty

Throws:

AttributeEncodingException - thrown if there is a problem encoding the attribute value

decodeValue

@Nullable
protected IdPAttributeValue decodeValue(@Nullable
 ProfileRequestContext profileRequestContext,
 @Nonnull
 Attribute attribute,
 @Nonnull
 TranscodingRule rule,
 @Nullable
 XMLObject value)

Function to decode a single XMLObject into an IdPAttributeValue.

Specified by:

decodeValue in class AbstractSAMLAttributeTranscoder<Attribute,XMLObjectAttributeValue>

Parameters:

profileRequestContext - current profile request

attribute - the attribute being decoded

rule - properties to control decoding

value - the value to decode

Returns:

the returned final IdPAttributeValue or null if decoding failed