Package net.shibboleth.oidc.metadata.impl

Class ChainingClientInformationResolver

java.lang.Object

net.shibboleth.shared.component.AbstractInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiedInitializableComponent

net.shibboleth.shared.component.AbstractIdentifiableInitializableComponent

net.shibboleth.oidc.metadata.impl.ChainingClientInformationResolver

All Implemented Interfaces:

ClientInformationResolver, RefreshableClientInformationResolver, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent, Resolver<OIDCClientInformation,CriteriaSet>

public class ChainingClientInformationResolver
extends AbstractIdentifiableInitializableComponent
implements RefreshableClientInformationResolver

A client information provider that uses registered resolvers, in turn, to answer queries. The Iterable of client informations 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 final org.slf4j.Logger	log	Class logger.
private List<ClientInformationResolver>	resolvers	Registered resolvers.

Constructor Summary

Constructors

Constructor	Description
ChainingClientInformationResolver()	Constructor.

Method Summary

Modifier and Type	Method	Description
protected int	countClients(ClientInformationResolver resolver)	Counts the clients found from the given resolver.
protected void	doDestroy()
protected void	doInitialize()
Instant	getLastRefresh()	Gets the time the last refresh cycle occurred.
Instant	getLastUpdate()	Get the time that the currently available client information was last updated.
List<ClientInformationResolver>	getResolvers()	Get an immutable the list of currently registered resolvers.
void	refresh()	Refresh the data exposed by the resolver.
Iterable<OIDCClientInformation>	resolve(CriteriaSet criteria)
OIDCClientInformation	resolveSingle(CriteriaSet criteria)
void	setResolvers(List<? extends ClientInformationResolver> newResolvers)	Set the registered client information resolvers.

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

Field Details

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

resolvers

@Nonnull
@NonnullElements
private List<ClientInformationResolver> resolvers

Registered resolvers.

Constructor Details

ChainingClientInformationResolver

public ChainingClientInformationResolver()

Constructor.

Method Details

getResolvers

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

Get an immutable the list of currently registered resolvers.

Returns:

list of currently registered resolvers

setResolvers

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

Set the registered client information resolvers.

Parameters:

newResolvers - the client information resolvers to use

Throws:

ResolverException - thrown if there is a problem adding the client information resolvers

resolveSingle

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

Specified by:

resolveSingle in interface Resolver<OIDCClientInformation,CriteriaSet>

Throws:

ResolverException

resolve

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

Specified by:

resolve in interface Resolver<OIDCClientInformation,CriteriaSet>

Throws:

ResolverException

refresh

public void refresh()
             throws ResolverException

Refresh the data exposed by the resolver.

An implementation of this method should typically be either synchronized or make use other locking mechanisms to protect against concurrent access.

Specified by:

refresh in interface RefreshableClientInformationResolver

Throws:

ResolverException - if the refresh operation was unsuccessful

getLastUpdate

@Nullable
public Instant getLastUpdate()

Get the time that the currently available client information was last updated. Note, this may be different than the time retrieved by RefreshableClientInformationResolver.getLastRefresh() is the client information was known not to have changed during the last refresh cycle.

Specified by:

getLastUpdate in interface RefreshableClientInformationResolver

Returns:

time when the currently client information was last updated, null if it has never successfully been read in

getLastRefresh

@Nullable
public Instant getLastRefresh()

Gets the time the last refresh cycle occurred.

Specified by:

getLastRefresh in interface RefreshableClientInformationResolver

Returns:

time the last refresh cycle occurred

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(ClientInformationResolver resolver)

Counts the clients found from the given resolver.

Parameters:

resolver - The resolver whose clients are counted.

Returns:

The amount of resolvable clients.