src/test/java/org/apache/commons/configuration2/event/AbstractTestConfigurationEvents.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.apache.commons.configuration2.event;

import org.apache.commons.configuration2.AbstractConfiguration;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

/**
 * Base class for testing events generated by configuration classes derived from AbstractConfiguration. This class
 * implements a couple of tests related to event generation. Concrete sub classes only have to implement the
 * {@code createConfiguration()} method for creating an instance of a specific configuration class. Because tests for
 * detail events depend on a concrete implementation an exact sequence of events cannot be checked. Instead the
 * corresponding test methods check whether the enclosing events (not the detail events) are of the expected type.
 */
public abstract class AbstractTestConfigurationEvents {

    /** Constant for a test property name. */
    static final String TEST_PROPNAME = "event.test";

    /** Constant for a test property value. */
    static final String TEST_PROPVALUE = "a value";

    /** Constant for an existing property. */
    static final String EXIST_PROPERTY = "event.property";

    /** The configuration to be tested. */
    protected AbstractConfiguration config;

    /** A test event listener. */
    protected EventListenerTestImpl listener;

    /**
     * Creates the configuration instance to be tested.
     *
     * @return the configuration instance under test
     */
    protected abstract AbstractConfiguration createConfiguration();

    @BeforeEach
    public void setUp() throws Exception {
        config = createConfiguration();
        config.addProperty(EXIST_PROPERTY, "existing value");
        listener = new EventListenerTestImpl(config);
        config.addEventListener(ConfigurationEvent.ANY, listener);
    }

    /**
     * Tests events generated by addProperty().
     */
    @Test
    void testAddPropertyEvent() {
        config.addProperty(TEST_PROPNAME, TEST_PROPVALUE);
        listener.checkEvent(ConfigurationEvent.ADD_PROPERTY, TEST_PROPNAME, TEST_PROPVALUE, true);
        listener.checkEvent(ConfigurationEvent.ADD_PROPERTY, TEST_PROPNAME, TEST_PROPVALUE, false);
        listener.done();
    }

    /**
     * Tests events generated by addProperty() when detail events are enabled.
     */
    @Test
    void testAddPropertyEventWithDetails() {
        config.setDetailEvents(true);
        config.addProperty(TEST_PROPNAME, TEST_PROPVALUE);
        listener.checkEventCount(2);
        listener.checkEvent(ConfigurationEvent.ADD_PROPERTY, TEST_PROPNAME, TEST_PROPVALUE, true);
        listener.skipToLast(ConfigurationEvent.ADD_PROPERTY);
        listener.checkEvent(ConfigurationEvent.ADD_PROPERTY, TEST_PROPNAME, TEST_PROPVALUE, false);
        listener.done();
    }

    /**
     * Tests the events generated by the clear() method.
     */
    @Test
    void testClearEvent() {
        config.clear();
        listener.checkEvent(ConfigurationEvent.CLEAR, null, null, true);
        listener.checkEvent(ConfigurationEvent.CLEAR, null, null, false);
        listener.done();
    }

    /**
     * Tests the events generated by the clear method when detail events are enabled.
     */
    @Test
    void testClearEventWithDetails() {
        config.setDetailEvents(true);
        config.clear();
        listener.checkEventCount(2);
        listener.checkEvent(ConfigurationEvent.CLEAR, null, null, true);
        listener.skipToLast(ConfigurationEvent.CLEAR);
        listener.checkEvent(ConfigurationEvent.CLEAR, null, null, false);
        listener.done();
    }

    /**
     * Tests events generated by clearProperty().
     */
    @Test
    void testClearPropertyEvent() {
        config.clearProperty(EXIST_PROPERTY);
        listener.checkEvent(ConfigurationEvent.CLEAR_PROPERTY, EXIST_PROPERTY, null, true);
        listener.checkEvent(ConfigurationEvent.CLEAR_PROPERTY, EXIST_PROPERTY, null, false);
        listener.done();
    }

    /**
     * Tests events generated by clearProperty() when detail events are enabled.
     */
    @Test
    void testClearPropertyEventWithDetails() {
        config.setDetailEvents(true);
        config.clearProperty(EXIST_PROPERTY);
        listener.checkEventCount(2);
        listener.checkEvent(ConfigurationEvent.CLEAR_PROPERTY, EXIST_PROPERTY, null, true);
        listener.skipToLast(ConfigurationEvent.CLEAR_PROPERTY);
        listener.checkEvent(ConfigurationEvent.CLEAR_PROPERTY, EXIST_PROPERTY, null, false);
        listener.done();
    }

    /**
     * Tests events generated by setProperty().
     */
    @Test
    void testSetPropertyEvent() {
        config.setProperty(EXIST_PROPERTY, TEST_PROPVALUE);
        listener.checkEvent(ConfigurationEvent.SET_PROPERTY, EXIST_PROPERTY, TEST_PROPVALUE, true);
        listener.checkEvent(ConfigurationEvent.SET_PROPERTY, EXIST_PROPERTY, TEST_PROPVALUE, false);
        listener.done();
    }

    /**
     * Tests events generated by setProperty() when detail events are enabled.
     */
    @Test
    void testSetPropertyEventWithDetails() {
        config.setDetailEvents(true);
        config.setProperty(EXIST_PROPERTY, TEST_PROPVALUE);
        listener.checkEventCount(2);
        listener.checkEvent(ConfigurationEvent.SET_PROPERTY, EXIST_PROPERTY, TEST_PROPVALUE, true);
        listener.skipToLast(ConfigurationEvent.SET_PROPERTY);
        listener.checkEvent(ConfigurationEvent.SET_PROPERTY, EXIST_PROPERTY, TEST_PROPVALUE, false);
        listener.done();
    }
}