Examples of TrackedNodeModel

org.apache.commons.configuration.tree.TrackedNodeModel

A specialized {@code NodeModel} implementation that uses a tracked nodemanaged by an {@link InMemoryNodeModel} object as root node.

Models of this type are useful when working on specific sub trees of a nodes structure. This is the case for instance for a {@code SubnodeConfiguration}.

An instance of this class is constructed with an {@link InMemoryNodeModelSupport} object providing a reference to theunderlying {@code InMemoryNodeModel} and the {@link NodeSelector} pointing tothe tracked node acting as this model's root node. The {@code NodeModel}operations are implemented by delegating to the wrapped {@code InMemoryNodeModel} object specifying the selector to the tracked nodeas target root node for the update transaction. Note that the tracked node can become detached at any time. This situation is handled transparently by the implementation of {@code InMemoryNodeModel}. The reason for using an {@code InMemoryNodeModelSupport} object rather than an{@code InMemoryNodeModel} directly is that this additional layer ofindirection can be used for performing special initializations on the model before it is returned to the {@code TrackedNodeModel} object. This is neededby some dynamic configuration implementations, e.g. by {@code CombinedConfiguration}.

If the tracked node acting as root node is exclusively used by this model, it should be released when this model is no longer needed. This can be done manually by calling the {@link #close()} method. It is also possible to passa value of true to the {@code untrackOnFinalize} argument ofthe constructor. This causes {@code close()} to be called automatically ifthis object gets claimed by the garbage collector.

As {@code InMemoryNodeModel}, this class is thread-safe.
@version $Id: TrackedNodeModel.java 1588832 2014-04-20 19:36:16Z oheger $ @since 2.0
org.apache.commons.configuration2.tree.TrackedNodeModel

A specialized {@code NodeModel} implementation that uses a tracked nodemanaged by an {@link InMemoryNodeModel} object as root node.

Models of this type are useful when working on specific sub trees of a nodes structure. This is the case for instance for a {@code SubnodeConfiguration}.

An instance of this class is constructed with an {@link InMemoryNodeModelSupport} object providing a reference to theunderlying {@code InMemoryNodeModel} and the {@link NodeSelector} pointing tothe tracked node acting as this model's root node. The {@code NodeModel}operations are implemented by delegating to the wrapped {@code InMemoryNodeModel} object specifying the selector to the tracked nodeas target root node for the update transaction. Note that the tracked node can become detached at any time. This situation is handled transparently by the implementation of {@code InMemoryNodeModel}. The reason for using an {@code InMemoryNodeModelSupport} object rather than an{@code InMemoryNodeModel} directly is that this additional layer ofindirection can be used for performing special initializations on the model before it is returned to the {@code TrackedNodeModel} object. This is neededby some dynamic configuration implementations, e.g. by {@code CombinedConfiguration}.

If the tracked node acting as root node is exclusively used by this model, it should be released when this model is no longer needed. This can be done manually by calling the {@link #close()} method. It is also possible to passa value of true to the {@code untrackOnFinalize} argument ofthe constructor. This causes {@code close()} to be called automatically ifthis object gets claimed by the garbage collector.

As {@code InMemoryNodeModel}, this class is thread-safe.
@version $Id: TrackedNodeModel.java 1624601 2014-09-12 18:04:36Z oheger $ @since 2.0

Examples of org.apache.commons.configuration.tree.TrackedNodeModel

    protected NodeModel<ImmutableNode> cloneNodeModel()
    {
        InMemoryNodeModel parentModel =
                (InMemoryNodeModel) getParent().getModel();
        parentModel.trackNode(getRootSelector(), getParent());
        return new TrackedNodeModel(getParent(), getRootSelector(), true);
    }

View Full Code Here

Examples of org.apache.commons.configuration.tree.TrackedNodeModel

     */
    protected SubnodeConfiguration createSubConfigurationForTrackedNode(
            NodeSelector selector, InMemoryNodeModelSupport parentModelSupport)
    {
        SubnodeConfiguration subConfig =
                new SubnodeConfiguration(this, new TrackedNodeModel(
                        parentModelSupport, selector, true));
        initSubConfigurationForThisParent(subConfig);
        return subConfig;
    }

View Full Code Here

Examples of org.apache.commons.configuration2.tree.TrackedNodeModel

     */
    private TrackedNodeModel setUpTrackedModel(NodeSelector selector)
    {
        InMemoryNodeModel parentModel = (InMemoryNodeModel) parent.getModel();
        parentModel.trackNode(selector, parent);
        return new TrackedNodeModel(parent, selector, true);
    }

View Full Code Here

Examples of org.apache.commons.configuration2.tree.TrackedNodeModel

    public void testClone()
    {
        setUpSubnodeConfig();
        SubnodeConfiguration copy = (SubnodeConfiguration) config.clone();
        assertNotSame("Same model", config.getModel(), copy.getModel());
        TrackedNodeModel subModel = (TrackedNodeModel) copy.getModel();
        assertEquals("Wrong selector", SELECTOR, subModel.getSelector());
        InMemoryNodeModel parentModel = (InMemoryNodeModel) parent.getModel();
        assertEquals("Wrong parent model", parentModel,
                subModel.getParentModel());


        // Check whether the track count was increased
        parentModel.untrackNode(SELECTOR);
        parentModel.untrackNode(SELECTOR);
        assertTrue("Wrong finalize flag",
                subModel.isReleaseTrackedNodeOnFinalize());
    }

View Full Code Here

Examples of org.apache.commons.configuration2.tree.TrackedNodeModel

     * Tests whether the configuration can be closed.
     */
    @Test
    public void testClose()
    {
        TrackedNodeModel model = EasyMock.createMock(TrackedNodeModel.class);
        EasyMock.expect(model.getSelector()).andReturn(SELECTOR).anyTimes();
        model.close();
        EasyMock.replay(model);


        SubnodeConfiguration config = new SubnodeConfiguration(parent, model);
        config.close();
        EasyMock.verify(model);

View Full Code Here

Examples of org.apache.commons.configuration2.tree.TrackedNodeModel

     */
    protected SubnodeConfiguration createSubConfigurationForTrackedNode(
            NodeSelector selector, InMemoryNodeModelSupport parentModelSupport)
    {
        SubnodeConfiguration subConfig =
                new SubnodeConfiguration(this, new TrackedNodeModel(
                        parentModelSupport, selector, true));
        initSubConfigurationForThisParent(subConfig);
        return subConfig;
    }

View Full Code Here

Examples of org.apache.commons.configuration2.tree.TrackedNodeModel

    protected NodeModel<ImmutableNode> cloneNodeModel()
    {
        InMemoryNodeModel parentModel =
                (InMemoryNodeModel) getParent().getModel();
        parentModel.trackNode(getRootSelector(), getParent());
        return new TrackedNodeModel(getParent(), getRootSelector(), true);
    }

View Full Code Here

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.