Package net.shibboleth.oidc.metadata.impl

Class ChainingProviderMetadataResolver

java.lang.Object

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

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

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

net.shibboleth.oidc.metadata.impl.ChainingProviderMetadataResolver

All Implemented Interfaces:

ProviderMetadataResolver, RefreshableProviderMetadataResolver, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, Resolver<com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata,CriteriaSet>

public class ChainingProviderMetadataResolver
extends AbstractIdentifiableInitializableComponent
implements RefreshableProviderMetadataResolver

A provider metadata provider that uses registered resolvers, in turn, to answer queries. The Iterable of provider metadata returned is the first non-null and non-empty Iterable found while iterating over the registered resolvers in resolver list order.

Field Summary

Fields

Modifier and Type	Field	Description
private org.slf4j.Logger	log	Class logger.
private List<ProviderMetadataResolver>	resolvers	Registered resolvers.

Constructor Summary

Constructors

Constructor	Description
ChainingProviderMetadataResolver()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected int	countClients(ProviderMetadataResolver resolver)	Counts the clients found from the given resolver.
protected void	doDestroy()
protected void	doInitialize()
Instant	getLastRefresh()
Instant	getLastUpdate()
List<ProviderMetadataResolver>	getResolvers()	Get an immutable the list of currently registered resolvers.
void	refresh()
Iterable<com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata>	resolve(CriteriaSet criteria)
com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata	resolveSingle(CriteriaSet criteria)
void	setResolvers(List<? extends ProviderMetadataResolver> newResolvers)	Set the registered provider metadata resolvers.

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 net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

resolvers

@Nonnull
@NonnullElements
private List<ProviderMetadataResolver> resolvers

Registered resolvers.

Constructor Detail

ChainingProviderMetadataResolver

public ChainingProviderMetadataResolver()

Constructor.

Method Detail

getResolvers

@Nonnull
@NonnullElements
@Unmodifiable
@NotLive
public List<ProviderMetadataResolver> getResolvers()

Get an immutable the list of currently registered resolvers.

Returns:

list of currently registered resolvers

setResolvers

public void setResolvers(@Nullable @NonnullElements
                         List<? extends ProviderMetadataResolver> newResolvers)
                  throws ResolverException

Set the registered provider metadata resolvers.

Parameters:

newResolvers - the provider metadata resolvers to use

Throws:

ResolverException - thrown if there is a problem adding the provider metadata resolvers

resolveSingle

@Nullable
public com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata resolveSingle(@Nullable
                                                                             CriteriaSet criteria)
                                                                      throws ResolverException

Specified by:

resolveSingle in interface Resolver<com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata,CriteriaSet>

Throws:

ResolverException

resolve

@Nonnull
public Iterable<com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata> resolve(@Nullable
                                                                                 CriteriaSet criteria)
                                                                          throws ResolverException

Specified by:

resolve in interface Resolver<com.nimbusds.openid.connect.sdk.op.OIDCProviderMetadata,CriteriaSet>

Throws:

ResolverException

refresh

public void refresh()
             throws ResolverException

Specified by:

refresh in interface RefreshableProviderMetadataResolver

Throws:

ResolverException

getLastUpdate

@Nullable
public Instant getLastUpdate()

Specified by:

getLastUpdate in interface RefreshableProviderMetadataResolver

getLastRefresh

@Nullable
public Instant getLastRefresh()

Specified by:

getLastRefresh in interface RefreshableProviderMetadataResolver

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractIdentifiedInitializableComponent

Throws:

ComponentInitializationException

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class AbstractInitializableComponent

countClients

protected int countClients(ProviderMetadataResolver resolver)

Counts the clients found from the given resolver.

Parameters:

resolver - The resolver whose clients are counted.

Returns:

The amount of resolvable clients.