liquibase.configuration

Class LiquibaseConfiguration

java.lang.Object

liquibase.configuration.LiquibaseConfiguration

All Implemented Interfaces:

SingletonObject

public class LiquibaseConfiguration
extends Object
implements SingletonObject

Provides unified management of configuration properties within Liquibase core and in extensions.

Because this class focuses on raw/untyped access to what is actually configured, it is usually best to interact with ConfigurationDefinition instances which provide type safety, standardized key naming, default values, and more.

"Registered" configuration definitions will be available for generated help.

This class will search through the configured ConfigurationValueProviders. Standard value providers are auto-loaded on startup, but more can be added/removed at runtime.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LiquibaseConfiguration()

Method Summary

Modifier and Type	Method and Description
<T extends ConfigurationContainer> T	getConfiguration(Class<T> type) Deprecated. use ConfigurationDefinition instances directly
<DataType> ConfiguredValue<DataType>	getCurrentConfiguredValue(ConfigurationValueConverter<DataType> converter, ConfigurationValueObfuscator<DataType> obfuscator, String... keyAndAliases) Searches for the given keys in the current providers.
static LiquibaseConfiguration	getInstance() Deprecated. use Scope.getSingleton(Class)
SortedSet<ConfigurationValueProvider>	getProviders()
ConfigurationDefinition<?>	getRegisteredDefinition(String key)
SortedSet<ConfigurationDefinition<?>>	getRegisteredDefinitions(boolean includeInternal) Returns all registered ConfigurationDefinitions.
void	init(Scope scope) Finishes configuration of this service.
void	registerDefinition(ConfigurationDefinition<?> definition) Registers a ConfigurationDefinition so it will be returned by getRegisteredDefinitions(boolean)
void	registerProvider(ConfigurationValueProvider valueProvider) Adds a new ConfigurationValueProvider to the active collection of providers.
boolean	removeProvider(ConfigurationValueProvider provider) Removes a specific ConfigurationValueProvider from the active collection of providers.
boolean	unregisterProvider(ConfigurationValueProvider valueProvider) Removes the given ConfigurationValueProvider from the active collection of providers.

Methods inherited from class java.lang.Object

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

Constructor Detail

LiquibaseConfiguration

protected LiquibaseConfiguration()

Method Detail

getInstance

public static LiquibaseConfiguration getInstance()

Deprecated. use Scope.getSingleton(Class)

init

public void init(Scope scope)

Finishes configuration of this service. Called as the root scope is set up, should not be called elsewhere.

registerProvider

public void registerProvider(ConfigurationValueProvider valueProvider)

Adds a new ConfigurationValueProvider to the active collection of providers.

unregisterProvider

public boolean unregisterProvider(ConfigurationValueProvider valueProvider)

Removes the given ConfigurationValueProvider from the active collection of providers.

Returns:

true if the given provider was previously registered.

removeProvider

public boolean removeProvider(ConfigurationValueProvider provider)

Removes a specific ConfigurationValueProvider from the active collection of providers.

Returns:

true if the provider was removed.

getConfiguration

public <T extends ConfigurationContainer> T getConfiguration(Class<T> type)

Deprecated. use ConfigurationDefinition instances directly

getProviders

public SortedSet<ConfigurationValueProvider> getProviders()

getCurrentConfiguredValue

public <DataType> ConfiguredValue<DataType> getCurrentConfiguredValue(ConfigurationValueConverter<DataType> converter,
                                                                      ConfigurationValueObfuscator<DataType> obfuscator,
                                                                      String... keyAndAliases)

Searches for the given keys in the current providers.

Parameters:

keyAndAliases - The first element should be the canonical key name, with later elements being aliases. At least one element must be provided.

Returns:

the value for the key, or null if not configured.

registerDefinition

public void registerDefinition(ConfigurationDefinition<?> definition)

Registers a ConfigurationDefinition so it will be returned by getRegisteredDefinitions(boolean)

getRegisteredDefinitions

public SortedSet<ConfigurationDefinition<?>> getRegisteredDefinitions(boolean includeInternal)

Returns all registered ConfigurationDefinitions. Registered definitions are used for generated help documentation.

Parameters:

includeInternal - if true, include ConfigurationDefinition.isInternal() definitions.

getRegisteredDefinition

public ConfigurationDefinition<?> getRegisteredDefinition(String key)

Returns:

the registered ConfigurationDefinition asssociated with this key. Null if none match.