Package net.shibboleth.oidc.metadata.impl

Class FilesystemProviderMetadataResolver

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

net.shibboleth.oidc.metadata.impl.AbstractOIDCEntityResolver<Key,Value>

net.shibboleth.oidc.metadata.impl.AbstractReloadingOIDCEntityResolver<Key,Value>

net.shibboleth.oidc.metadata.impl.AbstractFileOIDCEntityResolver<Issuer,OIDCProviderMetadata>

net.shibboleth.oidc.metadata.impl.FilesystemProviderMetadataResolver

All Implemented Interfaces:

ProviderMetadataResolver, RefreshableProviderMetadataResolver, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, Resolver<OIDCProviderMetadata,CriteriaSet>

public class FilesystemProviderMetadataResolver
extends AbstractFileOIDCEntityResolver<Issuer,OIDCProviderMetadata>
implements RefreshableProviderMetadataResolver

An OIDC metadata provider that pulls provider metadata from a file on the local filesystem. Based on FilesystemMetadataResolver.

Nested Class Summary

Nested classes/interfaces inherited from class net.shibboleth.oidc.metadata.impl.AbstractOIDCEntityResolver

AbstractOIDCEntityResolver.JsonBackingStore

Field Summary

Fields

Modifier and Type	Field	Description
private final org.slf4j.Logger	log	Class logger.

Constructor Summary

Constructors

Constructor	Description
FilesystemProviderMetadataResolver(Timer backgroundTaskTimer, Resource metadata)	Constructor.
FilesystemProviderMetadataResolver(Resource metadata)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected Issuer	getKey(OIDCProviderMetadata value)	Gets the identifier for the given entity.
protected List<OIDCProviderMetadata>	parse(byte[] bytes)	Parses an entity from the byte array.
Iterable<OIDCProviderMetadata>	resolve(CriteriaSet criteria)
OIDCProviderMetadata	resolveSingle(CriteriaSet criteria)

Methods inherited from class net.shibboleth.oidc.metadata.impl.AbstractFileOIDCEntityResolver

fetchMetadata, getMetadataIdentifier, getMetadataUpdateTime, setMetadataFile

Methods inherited from class net.shibboleth.oidc.metadata.impl.AbstractReloadingOIDCEntityResolver

getLastRefresh, getLastUpdate, initOIDCResolver, refresh, scheduleNextRefresh, setMaxRefreshDelay, setMinRefreshDelay

Methods inherited from class net.shibboleth.oidc.metadata.impl.AbstractOIDCEntityResolver

createNewBackingStore, doInitialize, getBackingStore, getLogPrefix, indexEntityDescriptor, isFailFastInitialization, lookupIdentifier, lookupIndexedIdentifier, preProcessEntityDescriptor, removeByIdentifier, setBackingStore, setFailFastInitialization

Methods inherited from class net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

ensureId, getId, ifDestroyedThrowDestroyedComponentException, ifInitializedThrowUnmodifiabledComponentException, ifNotInitializedThrowUninitializedComponentException

Methods inherited from class net.shibboleth.shared.component.AbstractInitializableComponent

checkComponentActive, checkSetterPreconditions, 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.shared.component.IdentifiedComponent

getId

Methods inherited from interface net.shibboleth.oidc.metadata.RefreshableProviderMetadataResolver

getLastRefresh, getLastUpdate, refresh

Field Details

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

Constructor Details

FilesystemProviderMetadataResolver

public FilesystemProviderMetadataResolver(@Nonnull
 Resource metadata)
                                   throws IOException

Constructor.

Parameters:

metadata - the metadata file

Throws:

IOException - If the metedata cannot be loaded.

FilesystemProviderMetadataResolver

public FilesystemProviderMetadataResolver(@Nullable
 Timer backgroundTaskTimer,
 @Nonnull
 Resource metadata)
                                   throws IOException

Constructor.

Parameters:

metadata - the metadata file

backgroundTaskTimer - timer used to refresh metadata in the background

Throws:

IOException - If the metedata cannot be loaded.

Method Details

resolve

@Nonnull
public Iterable<OIDCProviderMetadata> resolve(@Nullable
 CriteriaSet criteria)
                                       throws ResolverException

Specified by:

resolve in interface Resolver<OIDCProviderMetadata,CriteriaSet>

Throws:

ResolverException

resolveSingle

@Nullable
public OIDCProviderMetadata resolveSingle(@Nullable
 CriteriaSet criteria)
                                   throws ResolverException

Specified by:

resolveSingle in interface Resolver<OIDCProviderMetadata,CriteriaSet>

Throws:

ResolverException

parse

@Nonnull
protected List<OIDCProviderMetadata> parse(@Nonnull
 byte[] bytes)
                                    throws ParseException

Parses an entity from the byte array.

Specified by:

parse in class AbstractReloadingOIDCEntityResolver<Issuer,OIDCProviderMetadata>

Parameters:

bytes - The encoded entity

Returns:

The parsed entity

Throws:

ParseException - if parse fails

getKey

@Nonnull
protected Issuer getKey(@Nonnull
 OIDCProviderMetadata value)

Gets the identifier for the given entity.

Specified by:

getKey in class AbstractReloadingOIDCEntityResolver<Issuer,OIDCProviderMetadata>

Parameters:

value - The entity whose identifier will be returned.

Returns:

The identifier for the given entity.