net.shibboleth.idp.authn.impl

Class DefaultAuthenticationResultSerializer

java.lang.Object

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

net.shibboleth.idp.authn.impl.DefaultAuthenticationResultSerializer

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, StorageSerializer<AuthenticationResult>

public class DefaultAuthenticationResultSerializer
extends AbstractInitializableComponent
implements StorageSerializer<AuthenticationResult>

Handles serialization of results, delegating handling of Principal objects to one or more PrincipalSerializer plugins.

Field Summary

Fields

Modifier and Type	Field and Description
private static String	AUTHN_INSTANT_FIELD Field name of authentication instant.
private AuthenticationResultPrincipalSerializer	authnResultPrincipalSerializer Specialized serializer for AuthenticationResultPrincipal that requires a circular ref.
private static String	FLOW_ID_FIELD Field name of Flow ID.
private javax.json.stream.JsonGeneratorFactory	generatorFactory JSON generator factory.
private GenericPrincipalSerializer	genericSerializer Generic principal serializer for any unsupported principals.
private org.slf4j.Logger	log Class logger.
private static String	PRINCIPAL_ARRAY_FIELD Field name of principal array.
private Collection<PrincipalSerializer<String>>	principalSerializers Principal serializers.
private static String	PRIV_CREDS_ARRAY_FIELD Field name of private credentials array.
private static String	PUB_CREDS_ARRAY_FIELD Field name of public credentials array.
private javax.json.JsonReaderFactory	readerFactory JSON reader factory.

Constructor Summary

Constructors

Constructor and Description
DefaultAuthenticationResultSerializer() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
AuthenticationResult	deserialize(long version, String context, String key, String value, Long expiration)
private Principal	deserializePrincipal(javax.json.JsonValue jsonValue) Attempt to deserialize a principal with the registered and default serializers.
void	doInitialize()
GenericPrincipalSerializer	getGenericPrincipalSerializer() Returns the GenericPrincipalSerializer used for any unsupported principals found in the AuthenticationResult.
String	serialize(AuthenticationResult instance)
private void	serializePrincipal(javax.json.stream.JsonGenerator generator, Principal principal) Attempt to serialize a principal with the registered and default serializers.
void	setPrincipalSerializers(Collection<PrincipalSerializer<String>> serializers) Set the principal serializers used for principals found in the AuthenticationResult.

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

destroy, doDestroy, 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.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Field Detail

FLOW_ID_FIELD

@Nonnull
@NotEmpty
private static final String FLOW_ID_FIELD

Field name of Flow ID.

See Also:

Constant Field Values

AUTHN_INSTANT_FIELD

@Nonnull
@NotEmpty
private static final String AUTHN_INSTANT_FIELD

Field name of authentication instant.

See Also:

Constant Field Values

PRINCIPAL_ARRAY_FIELD

@Nonnull
@NotEmpty
private static final String PRINCIPAL_ARRAY_FIELD

Field name of principal array.

See Also:

Constant Field Values

PUB_CREDS_ARRAY_FIELD

@Nonnull
@NotEmpty
private static final String PUB_CREDS_ARRAY_FIELD

Field name of public credentials array.

See Also:

Constant Field Values

PRIV_CREDS_ARRAY_FIELD

@Nonnull
@NotEmpty
private static final String PRIV_CREDS_ARRAY_FIELD

Field name of private credentials array.

See Also:

Constant Field Values

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

generatorFactory

@Nonnull
private final javax.json.stream.JsonGeneratorFactory generatorFactory

JSON generator factory.

readerFactory

@Nonnull
private final javax.json.JsonReaderFactory readerFactory

JSON reader factory.

principalSerializers

@Nonnull
@NonnullElements
private Collection<PrincipalSerializer<String>> principalSerializers

Principal serializers.

authnResultPrincipalSerializer

@Nonnull
private final AuthenticationResultPrincipalSerializer authnResultPrincipalSerializer

Specialized serializer for AuthenticationResultPrincipal that requires a circular ref.

genericSerializer

@Nonnull
private final GenericPrincipalSerializer genericSerializer

Generic principal serializer for any unsupported principals.

Constructor Detail

DefaultAuthenticationResultSerializer

public DefaultAuthenticationResultSerializer()

Constructor.

Method Detail

setPrincipalSerializers

public void setPrincipalSerializers(@Nonnull@NonnullElements
                           Collection<PrincipalSerializer<String>> serializers)

Set the principal serializers used for principals found in the AuthenticationResult.

Parameters:

serializers - principal serializers to use

getGenericPrincipalSerializer

@Nonnull
public GenericPrincipalSerializer getGenericPrincipalSerializer()

Returns the GenericPrincipalSerializer used for any unsupported principals found in the AuthenticationResult.

Returns:

generic principal serializer

doInitialize

public void doInitialize()
                  throws ComponentInitializationException

Overrides:

doInitialize in class AbstractInitializableComponent

Throws:

ComponentInitializationException

serialize

@Nonnull
@NotEmpty
public String serialize(@Nonnull
                                AuthenticationResult instance)
                 throws IOException

Specified by:

serialize in interface StorageSerializer<AuthenticationResult>

Throws:

IOException

deserialize

@Nonnull
public AuthenticationResult deserialize(long version,
                                       @Nonnull@NotEmpty
                                       String context,
                                       @Nonnull@NotEmpty
                                       String key,
                                       @Nonnull@NotEmpty
                                       String value,
                                       @Nullable
                                       Long expiration)
                                 throws IOException

Specified by:

deserialize in interface StorageSerializer<AuthenticationResult>

Throws:

IOException

serializePrincipal

private void serializePrincipal(@Nonnull
                      javax.json.stream.JsonGenerator generator,
                      @Nonnull
                      Principal principal)
                         throws IOException

Attempt to serialize a principal with the registered and default serializers.

Parameters:

generator - the JSON context to write into

principal - object to serialize

Throws:

IOException - if serialization fails

deserializePrincipal

@Nullable
private Principal deserializePrincipal(@Nonnull
                                      javax.json.JsonValue jsonValue)
                                throws IOException

Attempt to deserialize a principal with the registered and default serializers.

Parameters:

jsonValue - the JSON object to parse

Returns:

the Principal recovered, or null

Throws:

IOException - if an error occurs