Examples of CombinedConfiguration

org.apache.commons.configuration.CombinedConfiguration
.apache.org/configuration/team-list.html">Commons Configuration team @since 1.3 @version $Id: CombinedConfiguration.java 712401 2008-11-08 15:29:56Z oheger $
org.apache.commons.configuration2.CombinedConfiguration
A hierarchical composite configuration class.

This class maintains a list of configuration objects, which can be added using the diverse {@code addConfiguration()} methods. After that theconfigurations can be accessed either by name (if one was provided when the configuration was added) or by index. For the whole set of managed configurations a logical node structure is constructed. For this purpose a {@link org.apache.commons.configuration2.tree.NodeCombiner NodeCombiner}object can be set. This makes it possible to specify different algorithms for the combination process.

The big advantage of this class is that it creates a truly hierarchical structure of all the properties stored in the contained configurations - even if some of them are no hierarchical configurations per se. So all enhanced features provided by a hierarchical configuration (e.g. choosing an expression engine) are applicable.

The class works by registering itself as an event listener at all added configurations. So it gets notified whenever one of these configurations is changed and can invalidate its internal node structure. The next time a property is accessed the node structure will be re-constructed using the current state of the managed configurations. Note that, depending on the used {@code NodeCombiner}, this may be a complex operation.

Because of the way a {@code CombinedConfiguration} is working it has more orless view character: it provides a logic view on the configurations it contains. In this constellation not all methods defined for hierarchical configurations - especially methods that update the stored properties - can be implemented in a consistent manner. Using such methods (like {@code addProperty()}, or {@code clearProperty()} on a{@code CombinedConfiguration} is not strictly forbidden, however, dependingon the current {@link NodeCombiner} and the involved properties, the resultsmay be different than expected. Some examples may illustrate this:
- Imagine a {@code CombinedConfiguration} cc containing two childconfigurations with the following content:
  user.properties
  gui.background = blue gui.position = (10, 10, 400, 200)
  default.properties
  gui.background = black gui.foreground = white home.dir = /data
  As a {@code NodeCombiner} a{@link org.apache.commons.configuration2.tree.OverrideCombiner OverrideCombiner} is used. This combiner will ensure that defined usersettings take precedence over the default values. If the resulting {@code CombinedConfiguration} is queried for the background color,{@code blue} will be returned because this value is defined in{@code user.properties}. Now consider what happens if the key {@code gui.background} is removed from the {@code CombinedConfiguration}:
```
 cc.clearProperty("gui.background"); 
```
  Will a {@code cc.containsKey("gui.background")} now return false? No,it won't! The {@code clearProperty()} operation is executed on the node setof the combined configuration, which was constructed from the nodes of the two child configurations. It causes the value of the background node to be cleared, which is also part of the first child configuration. This modification of one of its child configurations causes the {@code CombinedConfiguration} to be re-constructed. This time the{@code OverrideCombiner} cannot find a {@code gui.background} property in thefirst child configuration, but it finds one in the second, and adds it to the resulting combined configuration. So the property is still present (with a different value now).
- {@code addProperty()} can also be problematic: Most node combiners usespecial view nodes for linking parts of the original configurations' data together. If new properties are added to such a special node, they do not belong to any of the managed configurations and thus hang in the air. Using the same configurations as in the last example, the statement
```
 addProperty("database.user", "scott"); 
```
  would cause such a hanging property. If now one of the child configurations is changed and the {@code CombinedConfiguration} is re-constructed, thisproperty will disappear! (Add operations are not problematic if they result in a child configuration being updated. For instance an {@code addProperty("home.url", "localhost");} will alter the second childconfiguration - because the prefix home is here already present; when the {@code CombinedConfiguration} is re-constructed, this change istaken into account.)
Because of such problems it is recommended to perform updates only on the managed child configurations.

Whenever the node structure of a {@code CombinedConfiguration} becomesinvalid (either because one of the contained configurations was modified or because the {@code invalidate()} method was directly called) an event isgenerated. So this can be detected by interested event listeners. This also makes it possible to add a combined configuration into another one.

Notes about thread-safety: This configuration implementation uses a {@code Synchronizer} object to protect instances against concurrent access.The concrete {@code Synchronizer} implementation used determines whether aninstance of this class is thread-safe or not. In contrast to other implementations derived from {@link BaseHierarchicalConfiguration}, thread-safety is an issue here because the nodes structure used by this configuration has to be constructed dynamically when a child configuration is changed. Therefore, when multiple threads are involved which also manipulate one of the child configurations, a proper {@code Synchronizer} object shouldbe set. Note that the {@code Synchronizer} objects used by the childconfigurations do not really matter. Because immutable in-memory nodes structures are used for them there is no danger that updates on child configurations could interfere with read operations on the combined configuration.
@since 1.3 @version $Id: CombinedConfiguration.java 1624601 2014-09-12 18:04:36Z oheger $

Examples of org.apache.commons.configuration2.CombinedConfiguration

            ConfigurationException, InterruptedException
    {
        File src1 = writeReloadFile(null, 1, 0);
        File src2 = writeReloadFile(null, 1, 1);
        writeDefinitionFile(defFile, src1);
        CombinedConfiguration config = builder.getConfiguration();
        assertEquals("Wrong initial value", 0, config.getInt(testProperty(1)));


        // No change definition file
        boolean reloaded = false;
        for (int attempts = 0; attempts < 50 && !reloaded; attempts++)
        {
            writeDefinitionFile(defFile, src2);
            reloaded = builder.getReloadingController().checkForReloading(null);
            if (!reloaded)
            {
                Thread.sleep(100);
            }
        }
        assertTrue("Need for reload not detected", reloaded);
        config = builder.getConfiguration();
        assertEquals("Wrong reloaded value", 1, config.getInt(testProperty(1)));
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

        params.setFile(ConfigurationAssert
                .getTestFile("testDigesterConfiguration.xml"));
        builder =
                new ReloadingCombinedConfigurationBuilder(
                        params.getParameters());
        CombinedConfiguration cc = builder.getConfiguration();
        assertTrue("Property not found", cc.getBoolean("test.boolean"));
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

     * @return the combined configuration obtained from the builder
     */
    private CombinedConfiguration checkConfiguration()
            throws ConfigurationException
    {
        CombinedConfiguration compositeConfiguration =
                builder.getConfiguration();


        assertEquals("Number of configurations", 3,
                compositeConfiguration.getNumberOfConfigurations());
        assertEquals(PropertiesConfiguration.class, compositeConfiguration
                .getConfiguration(0).getClass());
        assertEquals(XMLPropertiesConfiguration.class, compositeConfiguration
                .getConfiguration(1).getClass());
        assertEquals(XMLConfiguration.class, compositeConfiguration
                .getConfiguration(2).getClass());


        // check the first configuration
        PropertiesConfiguration pc =
                (PropertiesConfiguration) compositeConfiguration
                        .getConfiguration(0);
        assertNotNull("No properties configuration", pc);


        // check some properties
        checkProperties(compositeConfiguration);

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

        File additonalFile =
                ConfigurationAssert
                        .getTestFile("testDigesterConfiguration2.xml");
        builder.configure(createParameters()
                .setFile(additonalFile));
        CombinedConfiguration compositeConfiguration =
                builder.getConfiguration();
        assertEquals("Verify how many configs", 2,
                compositeConfiguration.getNumberOfConfigurations());


        // Test if union was constructed correctly
        Object prop = compositeConfiguration.getProperty("tables.table.name");
        assertTrue(prop instanceof Collection);
        assertEquals(3, ((Collection<?>) prop).size());
        assertEquals("users",
                compositeConfiguration.getProperty("tables.table(0).name"));
        assertEquals("documents",
                compositeConfiguration.getProperty("tables.table(1).name"));
        assertEquals("tasks",
                compositeConfiguration.getProperty("tables.table(2).name"));


        prop =
                compositeConfiguration
                        .getProperty("tables.table.fields.field.name");
        assertTrue(prop instanceof Collection);
        assertEquals(17, ((Collection<?>) prop).size());


        assertEquals("smtp.mydomain.org",
                compositeConfiguration.getString("mail.host.smtp"));
        assertEquals("pop3.mydomain.org",
                compositeConfiguration.getString("mail.host.pop"));


        // This was overriden
        assertEquals("masterOfPost",
                compositeConfiguration.getString("mail.account.user"));
        assertEquals("topsecret",
                compositeConfiguration.getString("mail.account.psswd"));


        // This was overridden, too, but not in additional section
        assertEquals("enhanced factory",
                compositeConfiguration.getString("test.configuration"));
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

                createDefinitionConfig("xml", attrs);
        BasicConfigurationBuilder<? extends BaseHierarchicalConfiguration> defBuilder =
                createDefinitionBuilder(defConfig);
        builder.configure(new CombinedBuilderParametersImpl()
                .setDefinitionBuilder(defBuilder));
        CombinedConfiguration cc = builder.getConfiguration();
        assertEquals("Wrong number of configurations", 1,
                cc.getNumberOfConfigurations());
        assertTrue("Wrong configuration type",
                cc.getConfiguration(name) instanceof XMLConfiguration);
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

    public void testResetBuilder() throws ConfigurationException
    {
        Map<String, Object> attrs = new HashMap<String, Object>();
        BasicConfigurationBuilder<? extends HierarchicalConfiguration<ImmutableNode>> defBuilder =
                prepareSubBuilderTest(attrs);
        CombinedConfiguration cc = builder.getConfiguration();
        ConfigurationBuilder<? extends Configuration> subBuilder =
                builder.getNamedBuilder(BUILDER_NAME);
        defBuilder.reset();
        CombinedConfiguration cc2 = builder.getConfiguration();
        assertNotSame("No new configuration instance", cc, cc2);
        ConfigurationBuilder<? extends Configuration> subBuilder2 =
                builder.getNamedBuilder(BUILDER_NAME);
        assertNotSame("No new sub builder instance", subBuilder, subBuilder2);
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

    @Test
    public void testReactOnSubBuilderChange() throws ConfigurationException
    {
        Map<String, Object> attrs = new HashMap<String, Object>();
        prepareSubBuilderTest(attrs);
        CombinedConfiguration cc = builder.getConfiguration();
        BasicConfigurationBuilder<?> subBuilder =
                (BasicConfigurationBuilder<?>) builder
                        .getNamedBuilder(BUILDER_NAME);
        subBuilder.reset();
        assertNotSame("Configuration not newly created", cc,

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

        BasicConfigurationBuilder<?> subBuilder =
                (BasicConfigurationBuilder<?>) builder
                        .getNamedBuilder(BUILDER_NAME);
        builder.reset();
        prepareSubBuilderTest(attrs);
        CombinedConfiguration cc = builder.getConfiguration();
        BasicConfigurationBuilder<?> subBuilder2 =
                (BasicConfigurationBuilder<?>) builder
                        .getNamedBuilder(BUILDER_NAME);
        assertNotSame("Got the same sub builder", subBuilder, subBuilder2);
        subBuilder.reset();

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

        File initFile =
                ConfigurationAssert
                        .getTestFile("testCCResultInitialization.xml");
        builder.configure(createParameters()
                .setFile(initFile));
        CombinedConfiguration cc = builder.getConfiguration();
        checkCombinedConfigAttrs(cc);
        CombinedConfiguration cc2 =
                (CombinedConfiguration) cc
                        .getConfiguration(CombinedConfigurationBuilder.ADDITIONAL_NAME);
        checkCombinedConfigAttrs(cc2);
    }

View Full Code Here

Examples of org.apache.commons.configuration2.CombinedConfiguration

    public void testCombinedConfigurationNoAdditional()
            throws ConfigurationException
    {
        builder.configure(createParameters()
                .setFile(TEST_FILE));
        CombinedConfiguration cc = builder.getConfiguration();
        assertNull(
                "Additional configuration was found",
                cc.getConfiguration(CombinedConfigurationBuilder.ADDITIONAL_NAME));
    }

View Full Code Here

0 1 2 3 4 5

TOP

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.