org.opensaml.saml2.metadata.provider

クラス AbstractReloadingMetadataProvider

java.lang.Object

org.opensaml.saml2.metadata.provider.BaseMetadataProvider

org.opensaml.saml2.metadata.provider.AbstractMetadataProvider

org.opensaml.saml2.metadata.provider.AbstractObservableMetadataProvider

org.opensaml.saml2.metadata.provider.AbstractReloadingMetadataProvider

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

MetadataProvider, ObservableMetadataProvider

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

FilesystemMetadataProvider, HTTPMetadataProvider, ResourceBackedMetadataProvider

public abstract class AbstractReloadingMetadataProvider
extends AbstractObservableMetadataProvider

Base class for metadata providers that cache and periodically refresh their metadata. This metadata provider periodically checks to see if the read metadata file has changed. The delay between each refresh interval is calculated as follows. If no validUntil or cacheDuration is present then the getMaxRefreshDelay() value is used. Otherwise, the earliest refresh interval of the metadata file is checked by looking for the earliest of all the validUntil attributes and cacheDuration attributes. If that refresh interval is larger than the max refresh delay then getMaxRefreshDelay() is used. If that number is smaller than the min refresh delay then getMinRefreshDelay() is used. Otherwise the calculated refresh delay multiplied by getRefreshDelayFactor() is used. By using this factor, the provider will attempt to be refresh before the cache actually expires, allowing a some room for error and recovery. Assuming the factor is not exceedingly close to 1.0 and a min refresh delay that is not overly large, this refresh will likely occur a few times before the cache expires.

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

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

ObservableMetadataProvider.Observer

フィールドの概要

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

unmarshallerFactory

コンストラクタの概要

コンストラクタ

修飾子	コンストラクタと説明
protected	AbstractReloadingMetadataProvider() Constructor.
protected	AbstractReloadingMetadataProvider(Timer backgroundTaskTimer) Constructor.

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
protected long	computeNextRefreshDelay(org.joda.time.DateTime expectedExpiration) Computes the delay until the next refresh time based on the current metadata's expiration time and the refresh interval floor.
void	destroy() Destroys the metadata provider and frees any resources current held by it.
protected XMLObject	doGetMetadata() Gets the metadata currently held by the provider.
protected void	doInitialization() Subclasses should override this method to perform any initialization logic necessary.
protected abstract byte[]	fetchMetadata() Fetches metadata from a source.
org.joda.time.DateTime	getExpirationTime() Gets the time when the currently cached metadata expires.
org.joda.time.DateTime	getLastRefresh() Gets the time the last refresh cycle occurred.
org.joda.time.DateTime	getLastUpdate() Gets the time that the currently available metadata was last updated.
long	getMaxRefreshDelay() Gets the maximum amount of time, in milliseconds, between refresh intervals.
protected abstract String	getMetadataIdentifier() Gets an identifier which may be used to distinguish this metadata in logging statements.
int	getMinRefreshDelay() Gets the minimum amount of time, in milliseconds, between refreshes.
org.joda.time.DateTime	getNextRefresh() Gets the time when the next refresh cycle will occur.
float	getRefreshDelayFactor() Gets the delay factor used to compute the next refresh time.
protected byte[]	inputstreamToByteArray(InputStream ins) Converts an InputStream into a byte array.
protected void	postProcessMetadata(byte[] metadataBytes, Document metadataDom, XMLObject metadata) Post-processing hook called after new metadata has been unmarshalled, filtered, and the DOM released (from the XMLObject) but before the metadata is saved off.
protected void	processCachedMetadata(String metadataIdentifier, org.joda.time.DateTime refreshStart) Processes a cached metadata document in order to determine, and schedule, the next time it should be refreshed.
protected void	processNewMetadata(String metadataIdentifier, org.joda.time.DateTime refreshStart, byte[] metadataBytes) Process a new metadata document.
protected void	processNonExpiredMetadata(String metadataIdentifier, org.joda.time.DateTime refreshStart, byte[] metadataBytes, XMLObject metadata) Processes metadata that has been determined to be valid at the time it was fetched.
protected void	processPreExpiredMetadata(String metadataIdentifier, org.joda.time.DateTime refreshStart, byte[] metadataBytes, XMLObject metadata) Processes metadata that has been determined to be invalid (usually because it's already expired) at the time it was fetched.
void	refresh() Refreshes the metadata from its source.
void	setMaxRefreshDelay(long delay) Sets the maximum amount of time, in milliseconds, between refresh intervals.
void	setMinRefreshDelay(int delay) Sets the minimum amount of time, in milliseconds, between refreshes.
void	setRefreshDelayFactor(float factor) Sets the delay factor used to compute the next refresh time.
protected XMLObject	unmarshallMetadata(byte[] metadataBytes) Unmarshalls the given metadata bytes.

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

emitChangeEvent, getObservers

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

clearDescriptorIndex, doGetEntitiesDescriptor, doGetEntityDescriptor, doGetRole, doGetRole, filterMetadata, getEntitiesDescriptor, getEntitiesDescriptorByName, getEntityDescriptor, getEntityDescriptorById, getEntityDescriptorById, getMetadata, getParserPool, getRole, getRole, initialize, isFailFastInitialization, isInitialized, isValid, releaseMetadataDOM, setFailFastInitialization, setInitialized, setParserPool, unmarshallMetadata

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

getMetadataFilter, requireValidMetadata, setMetadataFilter, setRequireValidMetadata

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

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

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

getEntitiesDescriptor, getEntityDescriptor, getMetadata, getMetadataFilter, getRole, getRole, requireValidMetadata, setMetadataFilter, setRequireValidMetadata

コンストラクタの詳細

AbstractReloadingMetadataProvider

protected AbstractReloadingMetadataProvider()

Constructor.

AbstractReloadingMetadataProvider

protected AbstractReloadingMetadataProvider(Timer backgroundTaskTimer)

Constructor.

パラメータ:

backgroundTaskTimer - time used to schedule background refresh tasks

メソッドの詳細

getExpirationTime

public org.joda.time.DateTime getExpirationTime()

Gets the time when the currently cached metadata expires.

戻り値:

time when the currently cached metadata expires, or null if no metadata is cached

getLastUpdate

public org.joda.time.DateTime getLastUpdate()

Gets the time that the currently available metadata was last updated. Note, this may be different than the time retrieved by getLastUpdate() is the metadata was known not to have changed during the last refresh cycle.

戻り値:

time when the currently metadata was last update, 0 if metadata has never successfully been read in

getLastRefresh

public org.joda.time.DateTime getLastRefresh()

Gets the time the last refresh cycle occurred.

戻り値:

time the last refresh cycle occurred

getNextRefresh

public org.joda.time.DateTime getNextRefresh()

Gets the time when the next refresh cycle will occur.

戻り値:

time when the next refresh cycle will occur

getMaxRefreshDelay

public long getMaxRefreshDelay()

Gets the maximum amount of time, in milliseconds, between refresh intervals.

戻り値:

maximum amount of time between refresh intervals

setMaxRefreshDelay

public void setMaxRefreshDelay(long delay)

Sets the maximum amount of time, in milliseconds, between refresh intervals.

パラメータ:

delay - maximum amount of time, in milliseconds, between refresh intervals

getRefreshDelayFactor

public float getRefreshDelayFactor()

Gets the delay factor used to compute the next refresh time.

戻り値:

delay factor used to compute the next refresh time

setRefreshDelayFactor

public void setRefreshDelayFactor(float factor)

Sets the delay factor used to compute the next refresh time. The delay must be between 0.0 and 1.0, exclusive.

パラメータ:

factor - delay factor used to compute the next refresh time

getMinRefreshDelay

public int getMinRefreshDelay()

Gets the minimum amount of time, in milliseconds, between refreshes.

戻り値:

minimum amount of time, in milliseconds, between refreshes

setMinRefreshDelay

public void setMinRefreshDelay(int delay)

Sets the minimum amount of time, in milliseconds, between refreshes.

パラメータ:

delay - minimum amount of time, in milliseconds, between refreshes

destroy

public void destroy()

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

オーバーライド:

destroy クラス内 AbstractObservableMetadataProvider

doGetMetadata

protected 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.

定義:

doGetMetadata クラス内 AbstractMetadataProvider

戻り値:

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

例外:

MetadataProviderException - thrown if there is a problem retrieving the metadata

doInitialization

protected void doInitialization()
                         throws MetadataProviderException

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

オーバーライド:

doInitialization クラス内 AbstractMetadataProvider

例外:

MetadataProviderException - thrown if there is a problem initializing the provider

refresh

public void refresh()
             throws MetadataProviderException

Refreshes the metadata from its source.

例外:

MetadataProviderException - thrown is there is a problem retrieving and processing the metadata

getMetadataIdentifier

protected abstract String getMetadataIdentifier()

Gets an identifier which may be used to distinguish this metadata in logging statements.

戻り値:

identifier which may be used to distinguish this metadata in logging statements

fetchMetadata

protected abstract byte[] fetchMetadata()
                                 throws MetadataProviderException

Fetches metadata from a source.

戻り値:

the fetched metadata, or null if the metadata is known not to have changed since the last retrieval

例外:

MetadataProviderException - thrown if there is a problem fetching the metadata

unmarshallMetadata

protected XMLObject unmarshallMetadata(byte[] metadataBytes)
                                throws MetadataProviderException

Unmarshalls the given metadata bytes.

パラメータ:

metadataBytes - raw metadata bytes

戻り値:

the metadata

例外:

MetadataProviderException - thrown if the metadata can not be unmarshalled

processCachedMetadata

protected void processCachedMetadata(String metadataIdentifier,
                         org.joda.time.DateTime refreshStart)
                              throws MetadataProviderException

Processes a cached metadata document in order to determine, and schedule, the next time it should be refreshed.

パラメータ:

metadataIdentifier - identifier of the metadata source

refreshStart - when the current refresh cycle started

例外:

MetadataProviderException - throw is there is a problem process the cached metadata

processNewMetadata

protected void processNewMetadata(String metadataIdentifier,
                      org.joda.time.DateTime refreshStart,
                      byte[] metadataBytes)
                           throws MetadataProviderException

Process a new metadata document. Processing include unmarshalling and filtering metadata, determining the next time is should be refreshed and scheduling the next refresh cycle.

パラメータ:

metadataIdentifier - identifier of the metadata source

refreshStart - when the current refresh cycle started

metadataBytes - raw bytes of the new metadata document

例外:

MetadataProviderException - thrown if there is a problem unmarshalling or filtering the new metadata

processPreExpiredMetadata

protected void processPreExpiredMetadata(String metadataIdentifier,
                             org.joda.time.DateTime refreshStart,
                             byte[] metadataBytes,
                             XMLObject metadata)

Processes metadata that has been determined to be invalid (usually because it's already expired) at the time it was fetched. A metadata document is considered be invalid if its root element returns false when passed to the AbstractMetadataProvider.isValid(XMLObject) method.

パラメータ:

metadataIdentifier - identifier of the metadata source

refreshStart - when the current refresh cycle started

metadataBytes - raw bytes of the new metadata document

metadata - new metadata document unmarshalled

processNonExpiredMetadata

protected void processNonExpiredMetadata(String metadataIdentifier,
                             org.joda.time.DateTime refreshStart,
                             byte[] metadataBytes,
                             XMLObject metadata)
                                  throws MetadataProviderException

Processes metadata that has been determined to be valid at the time it was fetched. A metadata document is considered be valid if its root element returns true when passed to the AbstractMetadataProvider.isValid(XMLObject) method.

パラメータ:

metadataIdentifier - identifier of the metadata source

refreshStart - when the current refresh cycle started

metadataBytes - raw bytes of the new metadata document

metadata - new metadata document unmarshalled

例外:

MetadataProviderException - thrown if there s a problem processing the metadata

postProcessMetadata

protected void postProcessMetadata(byte[] metadataBytes,
                       Document metadataDom,
                       XMLObject metadata)
                            throws MetadataProviderException

Post-processing hook called after new metadata has been unmarshalled, filtered, and the DOM released (from the XMLObject) but before the metadata is saved off. Any exception thrown by this hook will cause the retrieved metadata to be discarded. The default implementation of this method is a no-op

パラメータ:

metadataBytes - raw metadata bytes retrieved via fetchMetadata()

metadataDom - metadata after it has been parsed in to a DOM document

metadata - metadata after it has been run through all registered filters and its DOM released

例外:

MetadataProviderException - thrown if there is a problem with the provided data

computeNextRefreshDelay

protected long computeNextRefreshDelay(org.joda.time.DateTime expectedExpiration)

Computes the delay until the next refresh time based on the current metadata's expiration time and the refresh interval floor.

パラメータ:

expectedExpiration - the time when the metadata is expected to expire and need refreshing

戻り値:

delay, in milliseconds, until the next refresh time

inputstreamToByteArray

protected byte[] inputstreamToByteArray(InputStream ins)
                                 throws MetadataProviderException

Converts an InputStream into a byte array.

パラメータ:

ins - input stream to convert

戻り値:

resultant byte array

例外:

MetadataProviderException - thrown if there is a problem reading the resultant byte array