org.opensaml.saml2.metadata.provider

クラス ChainingMetadataProvider

java.lang.Object

org.opensaml.saml2.metadata.provider.BaseMetadataProvider

org.opensaml.saml2.metadata.provider.ChainingMetadataProvider

すべての実装されたインタフェース:

MetadataProvider, ObservableMetadataProvider

public class ChainingMetadataProvider
extends BaseMetadataProvider
implements ObservableMetadataProvider

A metadata provider that uses registered providers, in turn, to answer queries. When searching for entity specific information (entity metadata, roles, etc.) the entity descriptor used is the first non-null descriptor found while iterating over the registered providers in insertion order. This chaining provider implements observation by registering an observer with each contained provider. When the contained provider emits a change this provider will also emit a change to observers registered with it. As such, developers should be careful not to register a the same observer with both container providers and this provider. Doing so will result in an observer being notified twice for each change.

ネストされたクラスの概要

インタフェースから継承されたネストされたクラス/インタフェース org.opensaml.saml2.metadata.provider.ObservableMetadataProvider

ObservableMetadataProvider.Observer

フィールドの概要

クラスから継承されたフィールド org.opensaml.saml2.metadata.provider.BaseMetadataProvider

unmarshallerFactory

コンストラクタの概要

コンストラクタ

コンストラクタと説明
ChainingMetadataProvider() Constructor.

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
void	addMetadataProvider(MetadataProvider newProvider) Adds a metadata provider to the list of registered providers.
void	destroy() Destroys the metadata provider and frees any resources current held by it.
protected void	doAddMetadataProvider(MetadataProvider provider, List<MetadataProvider> providerList) Adds a metadata provider to the given collection.
protected void	emitChangeEvent() Convenience method for calling ObservableMetadataProvider.Observer.onEvent(MetadataProvider) on every registered Observer passing in this provider.
EntitiesDescriptor	getEntitiesDescriptor(String name) Gets a valid named EntitiesDescriptor from the metadata.
EntityDescriptor	getEntityDescriptor(String entityID) Gets the valid metadata for a given entity.
XMLObject	getMetadata() Gets the metadata from every registered provider and places each within a newly created EntitiesDescriptor.
MetadataFilter	getMetadataFilter() Gets the metadata filter applied to the metadata.
List<ObservableMetadataProvider.Observer>	getObservers() Gets the list of observers for the provider.
List<MetadataProvider>	getProviders() Gets an immutable the list of currently registered providers.
List<RoleDescriptor>	getRole(String entityID, QName roleName) Gets the valid role descriptors of a given type for a given entity.
RoleDescriptor	getRole(String entityID, QName roleName, String supportedProtocol) Gets the valid role descriptors of a given type for a given entity that support the given protocol.
void	removeMetadataProvider(MetadataProvider provider) Removes a metadata provider from the list of registered providers.
void	setMetadataFilter(MetadataFilter newFilter) Sets the metadata filter applied to the metadata.
void	setProviders(List<MetadataProvider> newProviders) Replaces the current set of metadata providers with give collection.
void	setRequireValidMetadata(boolean requireValidMetadata) Sets whether the metadata returned by queries must be valid.

クラスから継承されたメソッド org.opensaml.saml2.metadata.provider.BaseMetadataProvider

requireValidMetadata

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースから継承されたメソッド org.opensaml.saml2.metadata.provider.MetadataProvider

requireValidMetadata

コンストラクタの詳細

ChainingMetadataProvider

public ChainingMetadataProvider()

Constructor.

メソッドの詳細

getProviders

public List<MetadataProvider> getProviders()

Gets an immutable the list of currently registered providers.

戻り値:

list of currently registered providers

setProviders

public void setProviders(List<MetadataProvider> newProviders)
                  throws MetadataProviderException

Replaces the current set of metadata providers with give collection.

パラメータ:

newProviders - the metadata providers to replace the current providers with

例外:

MetadataProviderException - thrown if there is a problem adding the metadata provider

addMetadataProvider

public void addMetadataProvider(MetadataProvider newProvider)
                         throws MetadataProviderException

Adds a metadata provider to the list of registered providers.

パラメータ:

newProvider - the provider to be added

例外:

MetadataProviderException - thrown if there is a problem adding the metadata provider

doAddMetadataProvider

protected void doAddMetadataProvider(MetadataProvider provider,
                         List<MetadataProvider> providerList)

Adds a metadata provider to the given collection. The new provider is checked to see if it is null, if not the providers MetadataProvider.requireValidMetadata() property is set to the value of this metadata provider's property. If the given metadata provider is an instance of ObservableMetadataProvider then a ContainedProviderObserver is added to it as well.

パラメータ:

provider - provider to be added to the collection

providerList - collection to which the provider is added

removeMetadataProvider

public void removeMetadataProvider(MetadataProvider provider)

Removes a metadata provider from the list of registered providers.

パラメータ:

provider - provider to be removed

setRequireValidMetadata

public void setRequireValidMetadata(boolean requireValidMetadata)

Sets whether the metadata returned by queries must be valid.

定義:

setRequireValidMetadata インタフェース内 MetadataProvider

オーバーライド:

setRequireValidMetadata クラス内 BaseMetadataProvider

パラメータ:

requireValidMetadata - whether the metadata returned by queries must be valid

getMetadataFilter

public MetadataFilter getMetadataFilter()

Gets the metadata filter applied to the metadata.

定義:

getMetadataFilter インタフェース内 MetadataProvider

オーバーライド:

getMetadataFilter クラス内 BaseMetadataProvider

戻り値:

the metadata filter applied to the metadata

setMetadataFilter

public void setMetadataFilter(MetadataFilter newFilter)
                       throws MetadataProviderException

Sets the metadata filter applied to the metadata.

定義:

setMetadataFilter インタフェース内 MetadataProvider

オーバーライド:

setMetadataFilter クラス内 BaseMetadataProvider

パラメータ:

newFilter - the metadata filter applied to the metadata

例外:

MetadataProviderException - thrown if the provider can not apply the filter to the metadata

getMetadata

public XMLObject getMetadata()
                      throws MetadataProviderException

Gets the metadata from every registered provider and places each within a newly created EntitiesDescriptor. Gets the valid metadata tree, after the registered filter has been applied.

定義:

getMetadata インタフェース内 MetadataProvider

戻り値:

the entire metadata tree

例外:

MetadataProviderException - thrown if the provider can not fetch the metadata, must not be thrown simply if there is no metadata to fetch

getEntitiesDescriptor

public EntitiesDescriptor getEntitiesDescriptor(String name)
                                         throws MetadataProviderException

Gets a valid named EntitiesDescriptor from the metadata.

定義:

getEntitiesDescriptor インタフェース内 MetadataProvider

パラメータ:

name - the name of the EntitiesDescriptor

戻り値:

the EntitiesDescriptor or null

例外:

MetadataProviderException - thrown if the provider can not fetch the metadata, must not be thrown if there is simply no EntitiesDescriptor with the given name

getEntityDescriptor

public EntityDescriptor getEntityDescriptor(String entityID)
                                     throws MetadataProviderException

Gets the valid metadata for a given entity.

定義:

getEntityDescriptor インタフェース内 MetadataProvider

パラメータ:

entityID - the ID of the entity

戻り値:

the entity's metadata or null if there is no metadata or no valid metadata

例外:

MetadataProviderException - thrown if the provider can not fetch the metadata, must not be thrown if there is simply no EntityDescriptor with the given ID

getRole

public List<RoleDescriptor> getRole(String entityID,
                           QName roleName)
                             throws MetadataProviderException

Gets the valid role descriptors of a given type for a given entity.

定義:

getRole インタフェース内 MetadataProvider

パラメータ:

entityID - the ID of the entity

roleName - the role type

戻り値:

the modifiable list of role descriptors

例外:

MetadataProviderException - thrown if the provider can not fetch the metadata, must not be thrown if there is simply no such entity with the given roles

getRole

public RoleDescriptor getRole(String entityID,
                     QName roleName,
                     String supportedProtocol)
                       throws MetadataProviderException

Gets the valid role descriptors of a given type for a given entity that support the given protocol.

定義:

getRole インタフェース内 MetadataProvider

パラメータ:

entityID - the ID of the entity

roleName - the role type

supportedProtocol - the protocol supported by the role

戻り値:

the role descriptor

例外:

MetadataProviderException - thrown if the provider can not fetch the metadata, must not be thrown if there is simply no such entity with the given role supporting the given protocol

getObservers

public List<ObservableMetadataProvider.Observer> getObservers()

Gets the list of observers for the provider. New observers may be added to the list or old ones removed.

定義:

getObservers インタフェース内 ObservableMetadataProvider

戻り値:

the list of observers

destroy

public void destroy()

Destroys the metadata provider and frees any resources current held by it. Default method is a no-op.

オーバーライド:

destroy クラス内 BaseMetadataProvider

emitChangeEvent

protected void emitChangeEvent()

Convenience method for calling ObservableMetadataProvider.Observer.onEvent(MetadataProvider) on every registered Observer passing in this provider.