org.opensaml.saml.common.binding.artifact.impl

Class BasicSAMLArtifactMap

java.lang.Object

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

org.opensaml.saml.common.binding.artifact.impl.BasicSAMLArtifactMap

All Implemented Interfaces:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, SAMLArtifactMap

public class BasicSAMLArtifactMap
extends net.shibboleth.utilities.java.support.component.AbstractInitializableComponent
implements SAMLArtifactMap

Basic artifact map implementation.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	BasicSAMLArtifactMap.Cleanup A cleanup task that relies on the weakly consistent iterator support in the map implementation.

Nested classes/interfaces inherited from interface org.opensaml.saml.common.binding.artifact.SAMLArtifactMap

SAMLArtifactMap.SAMLArtifactMapEntry, SAMLArtifactMap.SAMLArtifactMapEntryFactory

Field Summary

Fields

Modifier and Type	Field and Description
private long	artifactLifetime Lifetime of an artifact in milliseconds.
private java.util.Map<java.lang.String,ExpiringSAMLArtifactMapEntry>	artifactStore Artifact mapping storage.
private long	cleanupInterval Number of seconds between cleanup checks.
private java.util.TimerTask	cleanupTask Task that cleans up expired records.
private java.util.Timer	cleanupTaskTimer Timer used to schedule cleanup tasks.
private SAMLArtifactMap.SAMLArtifactMapEntryFactory	entryFactory Factory for SAMLArtifactMapEntry instances.
private org.slf4j.Logger	log Class Logger.

Constructor Summary

Constructors

Constructor and Description
BasicSAMLArtifactMap() Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	contains(java.lang.String artifact) Checks if a given artifact has a map entry.
protected void	doDestroy()
protected void	doInitialize()
SAMLArtifactMap.SAMLArtifactMapEntry	get(java.lang.String artifact) Gets the artifact entry for the given artifact.
long	getArtifactLifetime() Get the artifact entry lifetime in milliseconds.
SAMLArtifactMap.SAMLArtifactMapEntryFactory	getEntryFactory() Get the map entry factory.
void	put(java.lang.String artifact, java.lang.String relyingPartyId, java.lang.String issuerId, SAMLObject samlMessage) Creates a mapping between a given artifact and the SAML message to which it maps.
void	remove(java.lang.String artifact) Removes the artifact from this map.
void	setArtifactLifetime(long lifetime) Set the artifact entry lifetime in milliseconds.
void	setCleanupInterval(long interval) Set the cleanup interval in milliseconds, or 0 for none.
void	setEntryFactory(SAMLArtifactMap.SAMLArtifactMapEntryFactory factory) Set the map entry factory.

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

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class Logger.

artifactStore

@NonnullAfterInit
private java.util.Map<java.lang.String,ExpiringSAMLArtifactMapEntry> artifactStore

Artifact mapping storage.

artifactLifetime

@Duration
 @Positive
private long artifactLifetime

Lifetime of an artifact in milliseconds.

entryFactory

@Nonnull
private SAMLArtifactMap.SAMLArtifactMapEntryFactory entryFactory

Factory for SAMLArtifactMapEntry instances.

cleanupInterval

@Duration
 @NonNegative
private long cleanupInterval

Number of seconds between cleanup checks. Default value: (300)

cleanupTaskTimer

@NonnullAfterInit
private java.util.Timer cleanupTaskTimer

Timer used to schedule cleanup tasks.

cleanupTask

@Nullable
private java.util.TimerTask cleanupTask

Task that cleans up expired records.

Constructor Detail

BasicSAMLArtifactMap

public BasicSAMLArtifactMap()

Constructor.

Method Detail

doInitialize

protected void doInitialize()
                     throws net.shibboleth.utilities.java.support.component.ComponentInitializationException

Overrides:

doInitialize in class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

Throws:

net.shibboleth.utilities.java.support.component.ComponentInitializationException

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

getArtifactLifetime

@Positive
public long getArtifactLifetime()

Get the artifact entry lifetime in milliseconds.

Returns:

the artifact entry lifetime in milliseconds

getEntryFactory

@Nonnull
public SAMLArtifactMap.SAMLArtifactMapEntryFactory getEntryFactory()

Get the map entry factory.

Returns:

the map entry factory

setArtifactLifetime

public void setArtifactLifetime(@Duration @Positive
                                long lifetime)

Set the artifact entry lifetime in milliseconds.

Parameters:

lifetime - artifact entry lifetime in milliseconds

setCleanupInterval

public void setCleanupInterval(@Duration @NonNegative
                               long interval)

Set the cleanup interval in milliseconds, or 0 for none.

Parameters:

interval - cleanup interval in milliseconds

setEntryFactory

public void setEntryFactory(@Nonnull
                            SAMLArtifactMap.SAMLArtifactMapEntryFactory factory)

Set the map entry factory.

Parameters:

factory - map entry factory

contains

public boolean contains(@Nonnull @NotEmpty
                        java.lang.String artifact)
                 throws java.io.IOException

Checks if a given artifact has a map entry.

Specified by:

contains in interface SAMLArtifactMap

Parameters:

artifact - the artifact to check

Returns:

true iff this map has an entry for the given artifact

Throws:

java.io.IOException - if an error occurs retrieving the information

get

@Nullable
public SAMLArtifactMap.SAMLArtifactMapEntry get(@Nonnull @NotEmpty
                                                          java.lang.String artifact)
                                                   throws java.io.IOException

Gets the artifact entry for the given artifact.

Specified by:

get in interface SAMLArtifactMap

Parameters:

artifact - the artifact to retrieve the entry for

Returns:

the entry, or null if the artifact has already expired or did not exist

Throws:

java.io.IOException - if an error occurs retrieving the information

put

public void put(@Nonnull @NotEmpty
                java.lang.String artifact,
                @Nonnull @NotEmpty
                java.lang.String relyingPartyId,
                @Nonnull @NotEmpty
                java.lang.String issuerId,
                @Nonnull
                SAMLObject samlMessage)
         throws java.io.IOException

Creates a mapping between a given artifact and the SAML message to which it maps.

Specified by:

put in interface SAMLArtifactMap

Parameters:

artifact - the artifact

relyingPartyId - ID of the party the artifact was sent to

issuerId - ID of the issuer of the artifact

samlMessage - the SAML message

Throws:

java.io.IOException - if an error occurs storing the information

remove

public void remove(@Nonnull @NotEmpty
                   java.lang.String artifact)
            throws java.io.IOException

Removes the artifact from this map.

Specified by:

remove in interface SAMLArtifactMap

Parameters:

artifact - artifact to be removed

Throws:

java.io.IOException - if an error occurs retrieving the information