XMLConfig.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
 *
 *   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 org.apache.rat.configuration;

import java.util.Arrays;

/**
 * Configuration definitions for XMLConfiguration reader and writer.
 */
public final class XMLConfig {

    /** id attribute name */
    public static final String ATT_ID = "id";
    /** name attribute name */
    public static final String ATT_NAME = "name";
    /** license reference attribute name */
    public static final String ATT_LICENSE_REF = "license_ref";
    /** class name attribute name */
    public static final String ATT_CLASS_NAME = "class";
    /** resource file name attribute name. */
    public static final String ATT_RESOURCE = "resource";
    /** root of the configuration file */
    public static final String ROOT = "rat-config";
    /** families element name */
    public static final String FAMILIES = "families";
    /** licenses element name */
    public static final String LICENSES = "licenses";
    /** license element name */
    public static final String LICENSE = "license";
    /** approved element name */
    public static final String APPROVED = "approved";
    /** family element name */
    public static final String FAMILY = "family";
    /** note element name */
    public static final String NOTE = "note";
    /** matchers element name */
    public static final String MATCHERS = "matchers";
    /** matcher element name */
    public static final String MATCHER = "matcher";

    /** License property names that should be children */
    static final String[] LICENSE_CHILDREN = { NOTE, MATCHER };
    /**
     * License property names that should not be displayed contents should be placed
     * inline
     */
    static final String[] LICENSE_INLINE = { MATCHER };

    /**
     * Matcher properties that should be directly inlined Entries are matcher node
     * name / property name pairs. A matcher may only have one inline node and then
     * only if there is no other non-property node.
     */
    static final String[][] INLINE_NODES = { { "any", "enclosed" }, { "all", "enclosed" }, { "not", "enclosed" },
            { "text", "simpleText" } };

    private XMLConfig() {
        // do not instantiate
    }

    /**
     * Returns true if the specified child node should be placed inline in the XML
     * document.
     *
     * @param parent the parent node name.
     * @param child the child node name.
     * @return true if the child should be inlined.
     */
    public static boolean isInlineNode(final String parent, final String child) {
        return Arrays.stream(INLINE_NODES).anyMatch(s -> s[0].equals(parent) && s[1].equals(child));
    }

    /**
     * Returns true if the child should be a child node of a license node, as
     * opposed to an attribute of the license.
     *
     * @param child the name of the child node.
     * @return true if the child should be a child node.
     */
    public static boolean isLicenseChild(final String child) {
        return Arrays.asList(LICENSE_CHILDREN).contains(child);
    }

    /**
     * Return true if the child should be inlined in the parent node.
     *
     * @param child the name of the child node.
     * @return true if the child should be inlined.
     */
    public static boolean isLicenseInline(final String child) {
        return Arrays.asList(LICENSE_INLINE).contains(child);
    }
}