HTMLPrinter.java

/*
 *  Copyright (c) 2001-2024, Jean Tessier
 *  All rights reserved.
 *  
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions
 *  are met:
 *  
 *      * Redistributions of source code must retain the above copyright
 *        notice, this list of conditions and the following disclaimer.
 *  
 *      * 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.
 *  
 *      * Neither the name of Jean Tessier nor the names of his contributors
 *        may be used to endorse or promote products derived from this software
 *        without specific prior written permission.
 *  
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *  "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 THE REGENTS OR
 *  CONTRIBUTORS 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 com.jeantessier.dependency;

import java.io.*;
import java.util.*;

public class HTMLPrinter extends TextPrinter {
    public static final String DEFAULT_URL_FORMAT = "#%s";

    private static final String FROM = "<--";
    private static final String TO = "-->";
    private static final String BIDIRECTIONAL = "<->";

    private final String urlFormat;

    public HTMLPrinter(PrintWriter out, String format) {
        super(out);

        this.urlFormat = format;
    }

    public HTMLPrinter(TraversalStrategy strategy, PrintWriter out, String format) {
        super(strategy, out);

        this.urlFormat = format;
    }

    protected Printer printScopeNodeName(Node node, String name) {
        var fullName = node.getName();

        var urlArgument = perlEscapeName(fullName);
        var url = String.format(urlFormat, urlArgument);

        var link = new StringBuilder("<a");
        link.append(" class=\"scope");
        if (isShowInferred() && !node.isConfirmed()) {
            link.append(" inferred");
        }
        link.append("\"");
        link.append(" href=\"").append(url).append("\"");
        link.append(" id=\"").append(fullName).append("\"");
        link.append(">");
        link.append(name);
        link.append("</a>");

        openPotentialInferredSpan(node);
        printNodeName(node, link.toString());
        closePotentialInferredSpan(node);

        return this;
    }

    protected void printDependencies(Node node, Map<Node, Integer> dependencies) {
        String scopeNodeName = node.getName();

        dependencies.forEach((dependency, value) -> {
            var rawName = dependency.getName();
            var urlArgument = perlEscapeName(rawName);
            var url = String.format(urlFormat, urlArgument);

            String symbol;
            String idConjunction;
            if (value < 0) {
                symbol = FROM;
                idConjunction = "_from_";
            } else if (value > 0) {
                symbol = TO;
                idConjunction = "_to_";
            } else {
                symbol = BIDIRECTIONAL;
                idConjunction = "_bidirectional_";
            }

            var link = new StringBuilder("<a");
            if (isShowInferred() && !dependency.isConfirmed()) {
                link.append(" class=\"inferred\"");
            }
            link.append(" href=\"").append(url).append("\"");
            link.append(" id=\"").append(scopeNodeName).append(idConjunction).append(rawName).append("\"");
            link.append(">");
            link.append(rawName);
            link.append("</a>");

            indent();
            openPotentialInferredSpan(dependency);
            append(symbol).append(" ").printDependencyNodeName(dependency, link.toString());
            closePotentialInferredSpan(dependency);
            eol();
        });
    }

    private void openPotentialInferredSpan(Node node) {
        if (isShowInferred() && !node.isConfirmed()) {
            append("<span class=\"inferred\">");
        }
    }

    private void closePotentialInferredSpan(Node node) {
        if (isShowInferred() && !node.isConfirmed()) {
            append("</span>");
        }
    }

    private String perlEscapeName(String name) {
        String result = name;

        result = perl().substitute("s/\\(/\\\\(/g", result);
        result = perl().substitute("s/\\)/\\\\)/g", result);
        result = perl().substitute("s/\\$/\\\\\\$/g", result);
        result = perl().substitute("s/\\[/\\\\[/g", result);
        result = perl().substitute("s/\\]/\\\\]/g", result);

        return result;
    }
}