Class ReloadingMultiFileConfigurationBuilder<T extends FileBasedConfiguration>
- java.lang.Object
-
- org.apache.commons.configuration2.builder.BasicConfigurationBuilder<T>
-
- org.apache.commons.configuration2.builder.combined.MultiFileConfigurationBuilder<T>
-
- org.apache.commons.configuration2.builder.combined.ReloadingMultiFileConfigurationBuilder<T>
-
- Type Parameters:
T- the concrete type ofConfigurationobjects created by this builder
- All Implemented Interfaces:
ConfigurationBuilder<T>,EventSource,ReloadingControllerSupport
public class ReloadingMultiFileConfigurationBuilder<T extends FileBasedConfiguration> extends MultiFileConfigurationBuilder<T> implements ReloadingControllerSupport
A specialized
MultiFileConfigurationBuilderimplementation which adds support for reloading.This class - as its super class - allows operating on multiple configuration files whose file names are determined using a file name pattern and a
ConfigurationInterpolatorobject. It provides the following additional features:- Configuration builder for managed configurations have reloading support. So reloading is possible for all configuration sources loaded by this builder instance.
- A
ReloadingControlleris provided which can be used to trigger reload checks on all managed configurations.
Although this builder manages an arbitrary number of child configurations, to clients only a single configuration is visible - the one selected by the evaluation of the file name pattern. Builder reset notifications triggered by the reloading mechanism do not really take this fact into account; they are not limited to the currently selected child configuration, but occur for each of the managed configuration.
- Since:
- 2.0
-
-
Constructor Summary
Constructors Constructor Description ReloadingMultiFileConfigurationBuilder(Class<T> resCls)Creates a new instance ofReloadingMultiFileConfigurationBuilderwithout setting initialization parameters.ReloadingMultiFileConfigurationBuilder(Class<T> resCls, Map<String,Object> params)Creates a new instance ofReloadingMultiFileConfigurationBuilderand sets initialization parameters.ReloadingMultiFileConfigurationBuilder(Class<T> resCls, Map<String,Object> params, boolean allowFailOnInit)Creates a new instance ofReloadingMultiFileConfigurationBuilderand sets initialization parameters and a flag whether initialization failures should be ignored.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected FileBasedConfigurationBuilder<T>createManagedBuilder(String fileName, Map<String,Object> params)Creates a builder for a managed configuration.ReloadingControllergetReloadingController()Gets theReloadingControllerassociated with this object.-
Methods inherited from class org.apache.commons.configuration2.builder.combined.MultiFileConfigurationBuilder
addEventListener, configure, constructFileName, createInitializedManagedBuilder, createInterpolator, getConfiguration, getInterpolator, getManagedBuilder, getManagedBuilders, removeEventListener, resetParameters
-
Methods inherited from class org.apache.commons.configuration2.builder.BasicConfigurationBuilder
addParameters, connectToReloadingController, copyEventListeners, copyEventListeners, createResult, createResultDeclaration, createResultInstance, fetchBeanHelper, fireBuilderEvent, getParameters, getResultClass, getResultDeclaration, initResultInstance, installEventListener, isAllowFailOnInit, reset, resetResult, setParameters
-
-
-
-
Constructor Detail
-
ReloadingMultiFileConfigurationBuilder
public ReloadingMultiFileConfigurationBuilder(Class<T> resCls, Map<String,Object> params, boolean allowFailOnInit)
Creates a new instance ofReloadingMultiFileConfigurationBuilderand sets initialization parameters and a flag whether initialization failures should be ignored.- Parameters:
resCls- the result configuration classparams- a map with initialization parametersallowFailOnInit- a flag whether initialization errors should be ignored- Throws:
IllegalArgumentException- if the result class is null
-
ReloadingMultiFileConfigurationBuilder
public ReloadingMultiFileConfigurationBuilder(Class<T> resCls, Map<String,Object> params)
Creates a new instance ofReloadingMultiFileConfigurationBuilderand sets initialization parameters.- Parameters:
resCls- the result configuration classparams- a map with initialization parameters- Throws:
IllegalArgumentException- if the result class is null
-
ReloadingMultiFileConfigurationBuilder
public ReloadingMultiFileConfigurationBuilder(Class<T> resCls)
Creates a new instance ofReloadingMultiFileConfigurationBuilderwithout setting initialization parameters.- Parameters:
resCls- the result configuration class- Throws:
IllegalArgumentException- if the result class is null
-
-
Method Detail
-
getReloadingController
public ReloadingController getReloadingController()
Gets theReloadingControllerassociated with this object. This implementation returns a specialReloadingControllerthat delegates to the reloading controllers of the managed builders created so far.- Specified by:
getReloadingControllerin interfaceReloadingControllerSupport- Returns:
- the associated
ReloadingController
-
createManagedBuilder
protected FileBasedConfigurationBuilder<T> createManagedBuilder(String fileName, Map<String,Object> params) throws ConfigurationException
Creates a builder for a managed configuration. This method is called whenever a configuration for a file name is requested which has not yet been loaded. The passed in map with parameters is populated from this builder's configuration (i.e. the basic parameters plus the optional parameters for managed builders). This base implementation creates a standard builder for file-based configurations. Derived classes may override it to create special purpose builders. This implementation returns a file-based configuration builder with reloading support.- Overrides:
createManagedBuilderin classMultiFileConfigurationBuilder<T extends FileBasedConfiguration>- Parameters:
fileName- the name of the file to be loadedparams- a map with initialization parameters for the new builder- Returns:
- the newly created builder instance
- Throws:
ConfigurationException- if an error occurs
-
-