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>, 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 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, 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, 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.

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

computeExpirationTime, computeRefreshTriggerTime, createNewBackingStore, doDestroy, getBackgroundInitializationFromCacheDelay, getBackingStore, getCleanupTaskInterval, getInitializationFromCachePredicate, getMaxCacheDuration, getMaxIdleEntityData, getMetricsBaseName, getMinCacheDuration, getPersistentCacheKeyGenerator, getPersistentCacheManager, getRefreshDelayFactor, initializeFromPersistentCache, initMetadataResolver, isInitializeFromPersistentCacheInBackground, isPersistentCachingEnabled, isRemoveIdleEntityData, lookupEntityID, prepareForFiltering, preProcessEntityDescriptor, processNewMetadata, processNewMetadata, processPersistentCacheEntry, removeByEntityID, resolve, resolveFromOriginSource, setBackgroundInitializationFromCacheDelay, setCleanupTaskInterval, setInitializationFromCachePredicate, setInitializeFromPersistentCacheInBackground, setMaxCacheDuration, setMaxIdleEntityData, setMetricsBaseName, setMinCacheDuration, setPersistentCacheKeyGenerator, setPersistentCacheManager, setRefreshDelayFactor, setRemoveIdleEntityData, shouldAttemptRefresh

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

doInitialize, filterMetadata, getCriterionPredicateRegistry, getLogPrefix, getMetadataFilter, getParserPool, getUnmarshallerFactory, indexEntityDescriptor, 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 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 EntityIDDigestGenerator, 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
                                    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
                                    Function<CriteriaSet,String> keyGenerator)

Constructor.

If the supplied source key generator is null, an internal instance of EntityIDDigestGenerator 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

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