org.opensaml.xml

クラス XMLConfigurator

java.lang.Object

org.opensaml.xml.XMLConfigurator

public class XMLConfigurator
extends Object

Reads in an XML configuration and configures the XMLTooling library accordingly.

コンストラクタの概要

コンストラクタ

コンストラクタと説明
XMLConfigurator() Constructor.
XMLConfigurator(boolean retainXML) 推奨されていません。 this method will be removed once Configuration no longer has the option to store the XML configuration fragements

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
protected Object	createClassInstance(Element configuration) Constructs an instance of the given class.
protected void	initializeIDAttributes(Element idAttributesElement) Registers the global ID attributes specified in the configuration file.
protected void	initializeObjectProviders(Element objectProviders) Intializes the object providers defined in the configuration file.
protected void	initializeValidatorSuites(Element validatorSuitesElement) Initializes the validator suites specified in the configuration file.
void	load(Document configuration) Loads the configuration docuement.
protected void	load(Element configurationRoot) Loads a configuration after it's been schema validated.
void	load(File configurationFile) Loads the configuration file(s) from the given file.
void	load(InputStream configurationStream) Loads a configuration file from an input stream.
protected void	validateConfiguration(Document configuration) Schema validates the given configuration.

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

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

コンストラクタの詳細

XMLConfigurator

public XMLConfigurator()
                throws ConfigurationException

Constructor.

例外:

ConfigurationException - thrown if the validation schema for configuration files can not be created

XMLConfigurator

public XMLConfigurator(boolean retainXML)
                throws ConfigurationException

推奨されていません。 this method will be removed once Configuration no longer has the option to store the XML configuration fragements

Constructor.

パラメータ:

retainXML - whether to retain the XML configuration elements within the Configuration.

例外:

ConfigurationException - thrown if the validation schema for configuration files can not be created

メソッドの詳細

load

public void load(File configurationFile)
          throws ConfigurationException

Loads the configuration file(s) from the given file. If the file is a directory each file within the directory is loaded.

パラメータ:

configurationFile - the configuration file(s) to be loaded

例外:

ConfigurationException - thrown if the configuration file(s) can not be be read or invalid

load

public void load(InputStream configurationStream)
          throws ConfigurationException

Loads a configuration file from an input stream.

パラメータ:

configurationStream - configuration stream

例外:

ConfigurationException - thrown if the given configuration is invalid or can not be read

load

public void load(Document configuration)
          throws ConfigurationException

Loads the configuration docuement.

パラメータ:

configuration - the configurationd document

例外:

ConfigurationException - thrown if the configuration file(s) can not be be read or invalid

load

protected void load(Element configurationRoot)
             throws ConfigurationException

Loads a configuration after it's been schema validated.

パラメータ:

configurationRoot - root of the configuration

例外:

ConfigurationException - thrown if there is a problem processing the configuration

initializeObjectProviders

protected void initializeObjectProviders(Element objectProviders)
                                  throws ConfigurationException

Intializes the object providers defined in the configuration file.

パラメータ:

objectProviders - the configuration for the various object providers

例外:

ConfigurationException - thrown if the configuration elements are invalid

initializeValidatorSuites

protected void initializeValidatorSuites(Element validatorSuitesElement)
                                  throws ConfigurationException

Initializes the validator suites specified in the configuration file.

パラメータ:

validatorSuitesElement - the ValidatorSuites element from the configuration file

例外:

ConfigurationException - thrown if there is a problem initializing the validator suites, usually because of malformed elements

initializeIDAttributes

protected void initializeIDAttributes(Element idAttributesElement)
                               throws ConfigurationException

Registers the global ID attributes specified in the configuration file.

パラメータ:

idAttributesElement - the IDAttributes element from the configuration file

例外:

ConfigurationException - thrown if there is a problem with a parsing or registering the the ID attribute

createClassInstance

protected Object createClassInstance(Element configuration)
                              throws ConfigurationException

Constructs an instance of the given class.

パラメータ:

configuration - the current configuration element

戻り値:

an instance of the given class

例外:

ConfigurationException - thrown if the class can not be instaniated

validateConfiguration

protected void validateConfiguration(Document configuration)
                              throws ConfigurationException

Schema validates the given configuration.

パラメータ:

configuration - the configuration to validate

例外:

ConfigurationException - thrown if the configuration is not schema-valid