Package org.opensaml.core.config

Class ConfigurationService

java.lang.Object

org.opensaml.core.config.ConfigurationService

public class ConfigurationService
extends Object

A service which provides for the registration, retrieval and deregistration of objects related to library module configuration.

The service uses an internally-managed instance of Configuration to handle the registration, retrieval and deregistration of the configuration objects under its management.

The service first attempts to use the Java Services API to resolve the instance of Configuration to use. If multiple implementations of Configuration are registered via the Services API mechanism, the first one returned by the ServiceLoader iterator is used. If no Configuration implementation is declared or resolvable using the Services API, then it uses the default implementation MapBasedConfiguration.

The Configuration instance to use may also be set externally via setConfiguration(Configuration). This may be useful where an application-specific means such as Spring is used to configure the environment. This overrides the resolution process described above.

Field Summary

Fields

Modifier and Type	Field	Description
private static ServiceLoader<ConfigurationPropertiesSource>	configPropertiesLoader	The service loader used to locate registered implementations of ConfigurationPropertiesSource.
private static Configuration	configuration	The configuration instance to use.
static String	DEFAULT_PARTITION_NAME	The default storage partition name, if none is specified using configuration properties.
private static org.slf4j.Logger	LOG	Logger.
static String	PROPERTY_PARTITION_NAME	The configuration property name for the storage partition name to use.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ConfigurationService()	Constructor.

Method Summary

Modifier and Type	Method	Description
static <T> T	deregister(Class<T> configClass)	Deregister a configuration instance.
static <T> T	get(Class<T> configClass)	Obtain the registered configuration instance.
protected static Configuration	getConfiguration()	Get the Configuration instance to use.
static Properties	getConfigurationProperties()	Get the set of configuration meta-properties, which determines the configuration of the configuration service itself.
protected static String	getPartitionName()	Return the partition name which will be used for storage of configuration objects.
static <T,I extends T> void	register(Class<T> configClass, I configInstance)	Register a configuration instance.
static void	setConfiguration(Configuration newConfiguration)	Set the Configuration instance to use.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PARTITION_NAME

@Nonnull
public static final String DEFAULT_PARTITION_NAME

The default storage partition name, if none is specified using configuration properties.

See Also:

Constant Field Values

PROPERTY_PARTITION_NAME

@Nonnull
public static final String PROPERTY_PARTITION_NAME

The configuration property name for the storage partition name to use.

See Also:

Constant Field Values

LOG

@Nonnull
private static final org.slf4j.Logger LOG

Logger.

configPropertiesLoader

private static ServiceLoader<ConfigurationPropertiesSource> configPropertiesLoader

The service loader used to locate registered implementations of ConfigurationPropertiesSource.

configuration

private static Configuration configuration

The configuration instance to use.

Constructor Detail

ConfigurationService

protected ConfigurationService()

Constructor.

Method Detail

get

public static <T> T get(@Nonnull
                        Class<T> configClass)

Obtain the registered configuration instance.

Type Parameters:

T - the type of configuration being retrieved

Parameters:

configClass - the configuration class identifier

Returns:

the instance of the registered configuration object, or null

register

public static <T,I extends T> void register(@Nonnull
                                                  Class<T> configClass,
                                                  @Nonnull
                                                  I configInstance)

Register a configuration instance.

Type Parameters:

T - the type of configuration being registered

I - the configuration object instance type being registered, which must be an instance of T

Parameters:

configClass - the type of configuration being registered

configInstance - the configuration object instance being registered

deregister

public static <T> T deregister(@Nonnull
                               Class<T> configClass)

Deregister a configuration instance.

Type Parameters:

T - the type of configuration being deregistered

Parameters:

configClass - the type of configuration class being deregistered

Returns:

the configuration object instance which was deregistered, or null

getConfigurationProperties

@Nullable
public static Properties getConfigurationProperties()

Get the set of configuration meta-properties, which determines the configuration of the configuration service itself.

The properties set is obtained from the first registered instance of ConfigurationPropertiesSource which returns a non-null properties set. The implementations of properties sources to use are obtained via the Java Services API.

Properties made available in this meta-properties set may also be used by Initializer implementations.

Returns:

the set of configuration meta-properties

setConfiguration

public static void setConfiguration(@Nonnull
                                    Configuration newConfiguration)

Set the Configuration instance to use.

The configuration instance to use is normally resolved via the Java Services API, or is defaulted. However, this method is provided to allow the configuration instance to be supplied externally, perhaps using an application-specific means such as Spring dependency injection.

Parameters:

newConfiguration - the Configuration instance to use

getPartitionName

@Nonnull
@NotEmpty
protected static String getPartitionName()

Return the partition name which will be used for storage of configuration objects.

This partition name is obtained from the configuration meta-properties. If a value is not supplied via that mechanism, then an internal default value is used.

Returns:

the partition name

getConfiguration

@Nonnull
protected static Configuration getConfiguration()

Get the Configuration instance to use.

The implementation to return is first resolved using the Java Services API. If this produces no implementation, then an instance of the default implementation of MapBasedConfiguration is used.

Returns:

the Configuration implementation instance