All Downloads are FREE. Search and download functionalities are using the official Maven repository.

de.viadee.bpm.vPAV.processing.checker.XorConventionChecker Maven / Gradle / Ivy

Go to download

The tool checks Camunda projects for consistency and discovers errors in process-driven applications. Called as a Maven plugin or JUnit test, it discovers esp. inconsistencies of a given BPMN model in the classpath and the sourcecode of an underlying java project, such as a delegate reference to a non-existing java class or a non-existing Spring bean.

There is a newer version: 3.0.8
Show newest version
/**
 * Copyright © 2017, viadee Unternehmensberatung GmbH
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *    This product includes software developed by the viadee Unternehmensberatung GmbH.
 * 4. Neither the name of the viadee Unternehmensberatung GmbH nor the
 *    names of its contributors may be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY  ''AS IS'' AND ANY
 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 * DISCLAIMED. IN NO EVENT SHALL  BE LIABLE FOR ANY
 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
package de.viadee.bpm.vPAV.processing.checker;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

import org.camunda.bpm.model.bpmn.instance.BaseElement;
import org.camunda.bpm.model.bpmn.instance.ExclusiveGateway;
import org.w3c.dom.Element;
import org.w3c.dom.Node;

import de.viadee.bpm.vPAV.BPMNScanner;
import de.viadee.bpm.vPAV.config.model.ElementConvention;
import de.viadee.bpm.vPAV.config.model.Rule;
import de.viadee.bpm.vPAV.config.model.Setting;
import de.viadee.bpm.vPAV.processing.CheckName;
import de.viadee.bpm.vPAV.processing.ProcessingException;
import de.viadee.bpm.vPAV.processing.model.data.BpmnElement;
import de.viadee.bpm.vPAV.processing.model.data.CheckerIssue;
import de.viadee.bpm.vPAV.processing.model.data.CriticalityEnum;

public class XorConventionChecker extends AbstractElementChecker {

    public XorConventionChecker(final Rule rule, final BPMNScanner bpmnScanner) {
        super(rule, bpmnScanner);
    }

    /**
     * Check if XOR gateways and their outgoing edges adhere to naming conventions
     *
     * @return issues
     */
    @Override
    public Collection check(final BpmnElement element) {

        final Collection issues = new ArrayList();
        final BaseElement bpmnElement = element.getBaseElement();
        final Map settings = rule.getSettings();

        if (bpmnElement instanceof ExclusiveGateway) {
            String xor_gateway = bpmnScanner.getXorGateWays(bpmnElement.getId());

            if (bpmnScanner.getOutgoing(xor_gateway) > 1) {

                // check default path
                if (settings != null && settings.containsKey("requiredDefault")
                        && settings.get("requiredDefault").getValue().equals("true")
                        && bpmnElement.getAttributeValue("default") == null)
                    issues.add(new CheckerIssue(rule.getName(), CriticalityEnum.WARNING,
                            element.getProcessdefinition(), null, bpmnElement.getId(),
                            bpmnElement.getAttributeValue("name"), null, null, null, "xor gateway '"
                                    + CheckName.checkName(bpmnElement) + "' has no default path"));

                final ArrayList elementConventions = (ArrayList) rule
                        .getElementConventions();

                if (elementConventions == null) {
                    throw new ProcessingException(
                            "xor naming convention checker must have one element convention!");
                }

                // TODO: dont use indices
                final String patternString = elementConventions.get(0).getPattern().trim();
                final String taskName = bpmnElement.getAttributeValue("name");
                if (taskName != null && taskName.trim().length() > 0) {
                    final Pattern pattern = Pattern.compile(patternString);
                    final String taskNameClean = taskName.replaceAll("\n", "").replaceAll("\r", "");
                    Matcher matcher = pattern.matcher(taskNameClean);

                    if (!matcher.matches()) {
                        issues.add(new CheckerIssue(rule.getName(), CriticalityEnum.WARNING,
                                element.getProcessdefinition(), null, bpmnElement.getId(),
                                bpmnElement.getAttributeValue("name"), null, null, null, "xor gateway name '"
                                        + CheckName.checkName(bpmnElement) + "' is against the naming convention"));
                    }
                } else {
                    issues.add(
                            new CheckerIssue(rule.getName(), CriticalityEnum.WARNING, element.getProcessdefinition(),
                                    null, bpmnElement.getId(), bpmnElement.getAttributeValue("name"), null, null,
                                    null, "xor gateway name must be specified"));
                }

                // TODO: dont use indices
                final ArrayList edges = bpmnScanner.getOutgoingEdges(bpmnElement.getId());
                final String patternStringEdge = elementConventions.get(1).getPattern().trim();

                for (int i = 0; i < edges.size(); i++) {
                    Element Task_Element = (Element) edges.get(i);
                    final String edgeName = Task_Element.getAttribute("name");
                    if (edgeName != null && edgeName.trim().length() > 0) {
                        final Pattern pattern = Pattern.compile(patternStringEdge);
                        final String edgeNameClean = edgeName.replaceAll("\n", "").replaceAll("\r", "");
                        Matcher matcher = pattern.matcher(edgeNameClean);
                        if (!matcher.matches()) {
                            issues.add(new CheckerIssue(rule.getName(), CriticalityEnum.WARNING,
                                    element.getProcessdefinition(), null, Task_Element.getAttribute("id"),
                                    Task_Element.getAttribute("name"), null, null, null,
                                    "outgoing edges of xor gateway '"
                                            + CheckName.checkName(bpmnElement)
                                            + "' are against the naming convention"));
                        }
                    } else {
                        issues.add(
                                new CheckerIssue(rule.getName(), CriticalityEnum.WARNING,
                                        element.getProcessdefinition(), null, Task_Element.getAttribute("id"),
                                        Task_Element.getAttribute("name"), null, null, null,
                                        "outgoing edges of xor gateway need to be named"));
                    }
                }

            }

        }
        return issues;
    }

}




© 2015 - 2025 Weber Informatics LLC | Privacy Policy