org.opensaml.saml.metadata.resolver.impl

Class LocalDynamicMetadataResolver

java.lang.Object

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

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

org.opensaml.saml.metadata.resolver.impl.AbstractMetadataResolver

org.opensaml.saml.metadata.resolver.impl.AbstractDynamicMetadataResolver

org.opensaml.saml.metadata.resolver.impl.LocalDynamicMetadataResolver

All Implemented Interfaces:

Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, Resolver<EntityDescriptor,CriteriaSet>, ClearableMetadataResolver, DynamicMetadataResolver, MetadataResolver

public class LocalDynamicMetadataResolver
extends AbstractDynamicMetadataResolver

Resolver which dynamically resolves metadata from a local source managed by an instance of XMLObjectLoadSaveManager.

Nested Class Summary

Nested classes/interfaces inherited from class org.opensaml.saml.metadata.resolver.impl.AbstractDynamicMetadataResolver

AbstractDynamicMetadataResolver.BackingStoreCleanupSweeper, AbstractDynamicMetadataResolver.DefaultCacheKeyGenerator, AbstractDynamicMetadataResolver.DynamicEntityBackingStore, AbstractDynamicMetadataResolver.EntityManagementData, AbstractDynamicMetadataResolver.PersistentCacheInitializationMetrics

Nested classes/interfaces inherited from class org.opensaml.saml.metadata.resolver.impl.AbstractMetadataResolver

AbstractMetadataResolver.EntityBackingStore

Field Summary

Fields

Modifier and Type	Field and Description
private org.slf4j.Logger	log Logger.
private com.google.common.base.Function<CriteriaSet,String>	sourceKeyGenerator Function for generating the String key used with the source manager.
private org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject>	sourceManager The manager for the local store of metadata.

Fields inherited from class org.opensaml.saml.metadata.resolver.impl.AbstractDynamicMetadataResolver

METRIC_GAUGE_NUM_LIVE_ENTITYIDS, METRIC_GAUGE_PERSISTENT_CACHE_INIT, METRIC_RATIOGAUGE_FETCH_TO_RESOLVE, METRIC_TIMER_FETCH_FROM_ORIGIN_SOURCE, METRIC_TIMER_RESOLVE

Constructor Summary

Constructors

Constructor and Description
LocalDynamicMetadataResolver(Timer backgroundTaskTimer, org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager, com.google.common.base.Function<CriteriaSet,String> keyGenerator) Constructor.
LocalDynamicMetadataResolver(org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager) Constructor.
LocalDynamicMetadataResolver(org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager, com.google.common.base.Function<CriteriaSet,String> keyGenerator) Constructor.

Method Summary

Modifier and Type	Method and Description
protected org.opensaml.core.xml.XMLObject	fetchFromOriginSource(CriteriaSet criteria) Fetch the metadata from the origin source.
protected void	removeByEntityID(String entityID, AbstractMetadataResolver.EntityBackingStore backingStore) Remove from the backing store all metadata for the entity with the given entity ID.

Methods inherited from class org.opensaml.saml.metadata.resolver.impl.AbstractDynamicMetadataResolver

clear, clear, computeExpirationTime, computeRefreshTriggerTime, createNewBackingStore, doDestroy, getBackgroundInitializationFromCacheDelay, getBackingStore, getCleanupTaskInterval, getExpirationWarningThreshold, getIndexes, getInitializationFromCachePredicate, getMaxCacheDuration, getMaxIdleEntityData, getMetricsBaseName, getMinCacheDuration, getNegativeLookupCacheDuration, getPersistentCacheKeyGenerator, getPersistentCacheManager, getRefreshDelayFactor, indexEntityDescriptor, indexesEnabled, initializeFromPersistentCache, initMetadataResolver, isInitializeFromPersistentCacheInBackground, isPersistentCachingEnabled, isRemoveIdleEntityData, lookupCriteria, lookupEntityID, prepareForFiltering, preProcessEntityDescriptor, processNewMetadata, processNewMetadata, processNonEntityIDFetchedEntittiesDescriptor, processNonEntityIDFetchedEntityDescriptor, processPersistentCacheEntry, resolve, resolveEntityID, resolveEntityIDs, resolveFromOriginSource, resolveFromOriginSource, resolveFromOriginSourceWithEntityID, resolveFromOriginSourceWithoutEntityID, setBackgroundInitializationFromCacheDelay, setCleanupTaskInterval, setExpirationWarningThreshold, setIndexes, setInitializationFromCachePredicate, setInitializeFromPersistentCacheInBackground, setMaxCacheDuration, setMaxIdleEntityData, setMetricsBaseName, setMinCacheDuration, setNegativeLookupCacheDuration, setPersistentCacheKeyGenerator, setPersistentCacheManager, setRefreshDelayFactor, setRemoveIdleEntityData, shouldAttemptRefresh

Methods inherited from class org.opensaml.saml.metadata.resolver.impl.AbstractMetadataResolver

doInitialize, filterMetadata, getCriterionPredicateRegistry, getLogPrefix, getMetadataFilter, getParserPool, getUnmarshallerFactory, isFailFastInitialization, isRequireValidMetadata, isSatisfyAnyPredicates, isUseDefaultPredicateRegistry, isValid, lookupIndexedEntityID, predicateFilterCandidates, preProcessEntitiesDescriptor, releaseMetadataDOM, resolveSingle, setBackingStore, setCriterionPredicateRegistry, setFailFastInitialization, setMetadataFilter, setParserPool, setRequireValidMetadata, setSatisfyAnyPredicates, setUseDefaultPredicateRegistry, unmarshallMetadata

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, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opensaml.saml.metadata.resolver.MetadataResolver

getMetadataFilter, isRequireValidMetadata, setMetadataFilter, setRequireValidMetadata

Methods inherited from interface net.shibboleth.utilities.java.support.resolver.Resolver

resolveSingle

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

getId

Field Detail

log

private org.slf4j.Logger log

Logger.

sourceManager

@Nonnull
private org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> sourceManager

The manager for the local store of metadata.

sourceKeyGenerator

@Nonnull
private com.google.common.base.Function<CriteriaSet,String> sourceKeyGenerator

Function for generating the String key used with the source manager.

Constructor Detail

LocalDynamicMetadataResolver

public LocalDynamicMetadataResolver(@Nonnull
                                    org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager)

Constructor.

Source key generator will be an internal instance of DefaultLocalDynamicSourceKeyGenerator, with all default parameters.

Parameters:

manager - the manager for the local source of metadata

LocalDynamicMetadataResolver

public LocalDynamicMetadataResolver(@Nonnull
                                    org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager,
                                    @Nullable
                                    com.google.common.base.Function<CriteriaSet,String> keyGenerator)

Constructor.

Parameters:

manager - the manager for the local source of metadata

keyGenerator - the source key generator function

LocalDynamicMetadataResolver

public LocalDynamicMetadataResolver(@Nullable
                                    Timer backgroundTaskTimer,
                                    @Nonnull
                                    org.opensaml.core.xml.persist.XMLObjectLoadSaveManager<org.opensaml.core.xml.XMLObject> manager,
                                    @Nullable
                                    com.google.common.base.Function<CriteriaSet,String> keyGenerator)

Constructor.

If the supplied source key generator is null, an internal instance of DefaultLocalDynamicSourceKeyGenerator will be used, with all default parameters.

Parameters:

backgroundTaskTimer - timer for management of background tasks

manager - the manager for the local source of metadata

keyGenerator - the source key generator function

Method Detail

removeByEntityID

protected void removeByEntityID(String entityID,
                                AbstractMetadataResolver.EntityBackingStore backingStore)

Remove from the backing store all metadata for the entity with the given entity ID.

Overrides:

removeByEntityID in class AbstractDynamicMetadataResolver

Parameters:

entityID - the entity ID of the metadata to remove

backingStore - the backing store instance to update

fetchFromOriginSource

protected org.opensaml.core.xml.XMLObject fetchFromOriginSource(CriteriaSet criteria)
                                                         throws IOException

Fetch the metadata from the origin source.

Specified by:

fetchFromOriginSource in class AbstractDynamicMetadataResolver

Parameters:

criteria - the input criteria set

Returns:

the resolved metadata root XMLObject, or null if metadata could not be fetched

Throws:

IOException - if there is a fatal error fetching metadata from the origin source