com.tngtech.archunit.library.freeze.ViolationStore Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of archunit Show documentation
A Java architecture test library, to specify and assert architecture rules in plain Java - Module 'archunit'
The newest version!
/*
 * Copyright 2014-2024 TNG Technology Consulting GmbH
 *
 * Licensed 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
 *
 *     http://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 com.tngtech.archunit.library.freeze;

import java.util.List;
import java.util.Properties;

import com.tngtech.archunit.PublicAPI;
import com.tngtech.archunit.lang.ArchRule;

import static com.tngtech.archunit.PublicAPI.Usage.INHERITANCE;

/**
 * Provides some sort of storage for violations to {@link FreezingArchRule}.
 */
@PublicAPI(usage = INHERITANCE)
public interface ViolationStore {

    /**
     * Provides custom initialization with properties derived from
     * {@value com.tngtech.archunit.ArchConfiguration#ARCHUNIT_PROPERTIES_RESOURCE_NAME}
     * by considering the sub properties of {@code freeze.store}.
     * 


     * If {@value com.tngtech.archunit.ArchConfiguration#ARCHUNIT_PROPERTIES_RESOURCE_NAME} contains, e.g.,
     *
     * 
     * freeze.store.propOne=valueOne
     * freeze.store.propTwo=valueTwo
     * 
     *
     * then this method will be called with properties containing
     *
     * 
     * propOne=valueOne
     * propTwo=valueTwo
     *
     * @param properties The properties derived from the {@value com.tngtech.archunit.ArchConfiguration#ARCHUNIT_PROPERTIES_RESOURCE_NAME} prefix
     *                   {@code freeze.store}.
     */
    void initialize(Properties properties);

    /**
     * @param rule An {@link ArchRule}
     * @return true, if and only if this {@link ViolationStore} contains stored violations for the passed {@link ArchRule}
     */
    boolean contains(ArchRule rule);

    /**
     * Provides a way to initially store or later update violations of an {@link ArchRule}. If there are violations currently stored for the passed
     * rule, those violations will be completely overwritten.
     *
     * @param rule An {@link ArchRule} to store violations for
     * @param violations A list of lines of violations of an {@link ArchRule}
     */
    void save(ArchRule rule, List violations);

    /**
     * @param rule An {@link ArchRule}
     * @return The lines of violations currently stored for the passed {@link ArchRule}
     */
    List getViolations(ArchRule rule);

    /**
     * A simple delegate for a {@link ViolationStore} to allow adjusting the behavior of another
     * {@link ViolationStore} by delegation (e.g. {@link TextFileBasedViolationStore})
     */
    @PublicAPI(usage = INHERITANCE)
    class Delegate implements ViolationStore {
        private final ViolationStore delegate;

        public Delegate(ViolationStore delegate) {
            this.delegate = delegate;
        }

        @Override
        public void initialize(Properties properties) {
            delegate.initialize(properties);
        }

        @Override
        public boolean contains(ArchRule rule) {
            return delegate.contains(rule);
        }

        @Override
        public void save(ArchRule rule, List violations) {
            delegate.save(rule, violations);
        }

        @Override
        public List getViolations(ArchRule rule) {
            return delegate.getViolations(rule);
        }
    }
}