org.opensaml.saml2.metadata.provider

クラス AbstractMetadataProvider

java.lang.Object

org.opensaml.saml2.metadata.provider.BaseMetadataProvider

org.opensaml.saml2.metadata.provider.AbstractMetadataProvider

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

MetadataProvider

直系の既知のサブクラス:

AbstractObservableMetadataProvider

public abstract class AbstractMetadataProvider
extends BaseMetadataProvider

An abstract, base, implementation of a metadata provider.

フィールドの概要

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

unmarshallerFactory

コンストラクタの概要

コンストラクタ

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

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
protected void	clearDescriptorIndex() Clears the entity ID to entity descriptor index.
void	destroy() Destroys the metadata provider and frees any resources current held by it.
protected EntitiesDescriptor	doGetEntitiesDescriptor(String name) Gets the named EntitiesDescriptor from the metadata.
protected EntityDescriptor	doGetEntityDescriptor(String entityID) Gets the identified EntityDescriptor from the metadata.
protected abstract XMLObject	doGetMetadata() Gets the metadata currently held by the provider.
protected List<RoleDescriptor>	doGetRole(String entityID, QName roleName) Gets the identified roles from an EntityDescriptor.
protected RoleDescriptor	doGetRole(String entityID, QName roleName, String supportedProtocol) Gets the role which supports the given protocol.
protected void	doInitialization() Subclasses should override this method to perform any initialization logic necessary.
protected void	filterMetadata(XMLObject metadata) Filters the given metadata.
EntitiesDescriptor	getEntitiesDescriptor(String name) Gets a valid named EntitiesDescriptor from the metadata.
protected EntitiesDescriptor	getEntitiesDescriptorByName(String name, EntitiesDescriptor rootDescriptor) Gets the entities descriptor with the given name.
EntityDescriptor	getEntityDescriptor(String entityID) Gets the valid metadata for a given entity.
protected EntityDescriptor	getEntityDescriptorById(String entityID, EntitiesDescriptor descriptor) Gets the entity descriptor with the given ID that is a descendant of the given entities descriptor.
protected EntityDescriptor	getEntityDescriptorById(String entityID, XMLObject metadata) Gets the EntityDescriptor with the given ID from the cached metadata.
XMLObject	getMetadata() Gets the valid metadata tree, after the registered filter has been applied.
ParserPool	getParserPool() Gets the pool of parsers to use to parse XML.
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	initialize() Initializes this metadata provider.
boolean	isFailFastInitialization() Gets whether problems during initialization should cause the provider to fail or go on without metadata.
boolean	isInitialized() Gets whether this provider is initialized.
protected boolean	isValid(XMLObject descriptor) Returns whether the given descriptor is valid.
protected void	releaseMetadataDOM(XMLObject metadata) Releases the DOM representation from the metadata object.
void	setFailFastInitialization(boolean failFast) Sets whether problems during initialization should cause the provider to fail or go on without metadata.
protected void	setInitialized(boolean isInitialized) Sets whether this provider is initialized.
void	setParserPool(ParserPool pool) Sets the pool of parsers to use to parse XML.
protected XMLObject	unmarshallMetadata(InputStream metadataInput) Unmarshalls the metadata from the given stream.

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

getMetadataFilter, requireValidMetadata, setMetadataFilter, setRequireValidMetadata

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

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

コンストラクタの詳細

AbstractMetadataProvider

public AbstractMetadataProvider()

Constructor.

メソッドの詳細

getMetadata

public XMLObject getMetadata()
                      throws MetadataProviderException

Gets the valid metadata tree, after the registered filter has been applied.

戻り値:

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

doGetMetadata

protected abstract XMLObject doGetMetadata()
                                    throws MetadataProviderException

Gets the metadata currently held by the provider. This method should not check if the provider is initialized, if the metadata is valid, etc. All of this is done by the invoker of this method.

戻り値:

the metadata currently held by this provider or null if no metadata is available

例外:

MetadataProviderException - thrown if there is a problem retrieving the metadata

getEntitiesDescriptor

public EntitiesDescriptor getEntitiesDescriptor(String name)
                                         throws MetadataProviderException

Gets a valid named EntitiesDescriptor from the metadata.

パラメータ:

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

doGetEntitiesDescriptor

protected EntitiesDescriptor doGetEntitiesDescriptor(String name)
                                              throws MetadataProviderException

Gets the named EntitiesDescriptor from the metadata. This method should not check if the provider is initialized, if arguments are null, if metadata is valid, etc. All of this is done by the invoker of this method.

パラメータ:

name - the name of the EntitiesDescriptor, never null

戻り値:

the named EntitiesDescriptor or null if no such EntitiesDescriptor exists

例外:

MetadataProviderException - thrown if there is a problem searching for the EntitiesDescriptor

getEntityDescriptor

public EntityDescriptor getEntityDescriptor(String entityID)
                                     throws MetadataProviderException

Gets the valid metadata for a given entity.

パラメータ:

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

doGetEntityDescriptor

protected EntityDescriptor doGetEntityDescriptor(String entityID)
                                          throws MetadataProviderException

Gets the identified EntityDescriptor from the metadata. This method should not check if the provider is initialized, if arguments are null, if the metadata is valid, etc. All of this is done by the invoker of this method.

パラメータ:

entityID - ID of the EntityDescriptor, never null

戻り値:

the identified EntityDescriptor or null if no such EntityDescriptor exists

例外:

MetadataProviderException - thrown if there is a problem searching for the EntityDescriptor

getRole

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

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

パラメータ:

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

doGetRole

protected List<RoleDescriptor> doGetRole(String entityID,
                             QName roleName)
                                  throws MetadataProviderException

Gets the identified roles from an EntityDescriptor. This method should not check if the provider is initialized, if arguments are null, if the roles are valid, etc. All of this is done by the invoker of this method.

パラメータ:

entityID - ID of the entity from which to retrieve the roles, never null

roleName - name of the roles to search for, never null

戻り値:

the modifiable list of identified roles or an empty list if no roles exists

例外:

MetadataProviderException - thrown if there is a problem searching for the 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.

パラメータ:

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

doGetRole

protected RoleDescriptor doGetRole(String entityID,
                       QName roleName,
                       String supportedProtocol)
                            throws MetadataProviderException

Gets the role which supports the given protocol.

パラメータ:

entityID - ID of the entity from which to retrieve roles, never null

roleName - name of the role to search for, never null

supportedProtocol - protocol to search for, never null

戻り値:

the role supporting the protocol or null if no such role exists

例外:

MetadataProviderException - thrown if there is a problem search for the roles

isInitialized

public boolean isInitialized()

Gets whether this provider is initialized.

戻り値:

whether this provider is initialized

setInitialized

protected void setInitialized(boolean isInitialized)

Sets whether this provider is initialized.

パラメータ:

isInitialized - whether this provider is initialized

isFailFastInitialization

public boolean isFailFastInitialization()

Gets whether problems during initialization should cause the provider to fail or go on without metadata. The assumption being that in most cases a provider will recover at some point in the future.

戻り値:

whether problems during initialization should cause the provider to fail

setFailFastInitialization

public void setFailFastInitialization(boolean failFast)

Sets whether problems during initialization should cause the provider to fail or go on without metadata. The assumption being that in most cases a provider will recover at some point in the future.

パラメータ:

failFast - whether problems during initialization should cause the provider to fail

getParserPool

public ParserPool getParserPool()

Gets the pool of parsers to use to parse XML.

戻り値:

pool of parsers to use to parse XML

setParserPool

public void setParserPool(ParserPool pool)

Sets the pool of parsers to use to parse XML.

パラメータ:

pool - pool of parsers to use to parse XML

initialize

public void initialize()
                throws MetadataProviderException

Initializes this metadata provider. If called after the metadata provider has already been initialized this method simply returns.

例外:

MetadataProviderException - thrown if there is a problem initializing the problem and fail fast Initialization is enabled

destroy

public void destroy()

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

オーバーライド:

destroy クラス内 BaseMetadataProvider

doInitialization

protected void doInitialization()
                         throws MetadataProviderException

Subclasses should override this method to perform any initialization logic necessary. Default implementation is a no-op.

例外:

MetadataProviderException - thrown if there is a problem initializing the provider

clearDescriptorIndex

protected void clearDescriptorIndex()

Clears the entity ID to entity descriptor index.

unmarshallMetadata

protected XMLObject unmarshallMetadata(InputStream metadataInput)
                                throws UnmarshallingException

Unmarshalls the metadata from the given stream. The stream is closed by this method and the returned metadata released its DOM representation.

パラメータ:

metadataInput - the input reader to the metadata.

戻り値:

the unmarshalled metadata

例外:

UnmarshallingException - thrown if the metadata can no be unmarshalled

filterMetadata

protected void filterMetadata(XMLObject metadata)
                       throws FilterException

Filters the given metadata.

パラメータ:

metadata - the metadata to be filtered

例外:

FilterException - thrown if there is an error filtering the metadata

releaseMetadataDOM

protected void releaseMetadataDOM(XMLObject metadata)

Releases the DOM representation from the metadata object.

パラメータ:

metadata - the metadata object

getEntityDescriptorById

protected EntityDescriptor getEntityDescriptorById(String entityID,
                                       XMLObject metadata)

Gets the EntityDescriptor with the given ID from the cached metadata.

パラメータ:

entityID - the ID of the entity to get the descriptor for

metadata - metadata associated with the entity

戻り値:

the EntityDescriptor

getEntityDescriptorById

protected EntityDescriptor getEntityDescriptorById(String entityID,
                                       EntitiesDescriptor descriptor)

Gets the entity descriptor with the given ID that is a descendant of the given entities descriptor.

パラメータ:

entityID - the ID of the entity whose descriptor is to be fetched

descriptor - the entities descriptor

戻り値:

the entity descriptor

getEntitiesDescriptorByName

protected EntitiesDescriptor getEntitiesDescriptorByName(String name,
                                             EntitiesDescriptor rootDescriptor)

Gets the entities descriptor with the given name.

パラメータ:

name - name of the entities descriptor

rootDescriptor - the root descriptor to search in

戻り値:

the EntitiesDescriptor with the given name

isValid

protected boolean isValid(XMLObject descriptor)

Returns whether the given descriptor is valid. If valid metadata is not required this method always returns true.

パラメータ:

descriptor - the descriptor to check

戻り値:

true if valid metadata is not required or the given descriptor is valid, false otherwise