test/langtools/jdk/javadoc/doclet/testSingletonLists/TestSingletonLists.java
author pmuthuswamy
Tue, 30 Apr 2019 11:58:30 +0530
changeset 54648 89f2043ee67a
parent 54596 86c1da00dd6a
permissions -rw-r--r--
8221991: Improve the HTML for the inheritance tree for a type Reviewed-by: hannesw
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
54596
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     1
/*
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     2
 * Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     4
 *
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     7
 * published by the Free Software Foundation.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     8
 *
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
     9
 * This code is distributed in the hope that it will be useful, but WITHOUT
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    10
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    11
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    12
 * version 2 for more details (a copy is included in the LICENSE file that
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    13
 * accompanied this code).
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    14
 *
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    15
 * You should have received a copy of the GNU General Public License version
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    16
 * 2 along with this work; if not, write to the Free Software Foundation,
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    17
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    18
 *
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    19
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    20
 * or visit www.oracle.com if you need additional information or have any
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    21
 * questions.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    22
 */
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    23
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    24
/*
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    25
 * @test
54648
89f2043ee67a 8221991: Improve the HTML for the inheritance tree for a type
pmuthuswamy
parents: 54596
diff changeset
    26
 * @bug 8219998 8221991
54596
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    27
 * @summary Eliminate inherently singleton lists
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    28
 * @library /tools/lib ../../lib
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    29
 * @modules jdk.javadoc/jdk.javadoc.internal.tool
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    30
 * @modules jdk.compiler/com.sun.tools.javac.api
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    31
 *          jdk.compiler/com.sun.tools.javac.main
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    32
 *          jdk.javadoc/jdk.javadoc.internal.api
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    33
 *          jdk.javadoc/jdk.javadoc.internal.tool
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    34
 * @build toolbox.ToolBox toolbox.JavacTask javadoc.tester.*
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    35
 * @run main TestSingletonLists
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    36
 */
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    37
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    38
import java.io.IOException;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    39
import java.io.PrintStream;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    40
import java.nio.file.Path;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    41
import java.util.ArrayList;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    42
import java.util.List;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    43
import java.util.Map;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    44
import java.util.Stack;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    45
import java.util.TreeMap;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    46
import java.util.function.Function;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    47
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    48
import javadoc.tester.HtmlChecker;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    49
import javadoc.tester.JavadocTester;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    50
import toolbox.ModuleBuilder;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    51
import toolbox.ToolBox;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    52
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    53
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    54
public class TestSingletonLists extends JavadocTester {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    55
    public static void main(String... args) throws Exception {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    56
        TestSingletonLists tester = new TestSingletonLists();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    57
        tester.runTests();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    58
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    59
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    60
    enum Index  { SINGLE, SPLIT };
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    61
    enum Source { PACKAGES, MODULES };
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    62
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    63
    final ToolBox tb = new ToolBox();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    64
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    65
    public void runTests() throws Exception {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    66
        for (Source s : Source.values()) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    67
            Path src = genSource(s);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    68
                for (Index i : Index.values()) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    69
                    List<String> args = new ArrayList<>();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    70
                    args.add("-d");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    71
                    args.add(String.format("out-%s-%s", s, i));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    72
                    args.add("-use");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    73
                    if (s != Source.MODULES) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    74
                        args.add("-linksource"); // broken, with modules: JDK-8219060
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    75
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    76
                    if (i == Index.SPLIT) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    77
                        args.add("-splitIndex");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    78
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    79
                    if (s == Source.PACKAGES) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    80
                        args.add("-sourcepath");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    81
                        args.add(src.toString());
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    82
                        args.add("p1");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    83
                        args.add("p2");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    84
                        args.add("p3");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    85
                    } else {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    86
                        args.add("--module-source-path");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    87
                        args.add(src.toString());
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    88
                        args.add("--module");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    89
                        args.add("mA,mB,mC");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    90
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    91
                    javadoc(args.toArray(new String[args.size()]));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    92
                    checkExit(Exit.OK);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    93
                    checkLists();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    94
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    95
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    96
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    97
        printSummary();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    98
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
    99
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   100
    Path genSource(Source s) throws IOException {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   101
        Path src = Path.of("src-" + s);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   102
        switch (s) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   103
            case PACKAGES:
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   104
                for (String p : new String[] { "1", "2", "3" }) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   105
                    tb.writeJavaFiles(src, genClasses("p" + p));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   106
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   107
                break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   108
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   109
            case MODULES:
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   110
                for (String m : new String[] { "A", "B", "C"}) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   111
                    ModuleBuilder mb = new ModuleBuilder(tb, "m" + m);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   112
                    for (String p : new String[] { "1", "2", "3" } ) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   113
                        mb.exports("p" + m + p);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   114
                        mb.classes(genClasses("p" + m + p));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   115
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   116
                    mb.write(src);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   117
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   118
                break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   119
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   120
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   121
        return src;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   122
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   123
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   124
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   125
    String[] genClasses(String pkg) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   126
        List<String> list = new ArrayList<>();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   127
        list.add("package " + pkg + ";");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   128
        for (int i = 0; i < 3; i++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   129
            list.add(genClass(pkg, i));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   130
            list.add(genAnno(pkg, i));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   131
            list.add(genEnum(pkg, i));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   132
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   133
        return list.toArray(new String[list.size()]);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   134
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   135
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   136
    String genClass(String pkg, int index) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   137
        String cn = (pkg + "c" + index).toUpperCase();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   138
        StringBuilder sb = new StringBuilder();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   139
        int pkgIndex = Character.getNumericValue(pkg.charAt(pkg.length()-1));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   140
        String pkgdependency = pkg.substring(0, pkg.length()-1) + (pkgIndex == 3 ? 1 : pkgIndex + 1);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   141
        String enumClassName = pkgdependency.toUpperCase() + "E" + index;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   142
        sb.append("package ").append(pkg).append(";\n")
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   143
                .append("import " + pkgdependency + ".*;\n")
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   144
                .append("public class ").append(cn).append(" {\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   145
        // fields
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   146
        for (int f = 0; f < 3; f++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   147
            sb.append("public int f").append(f).append(";\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   148
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   149
        // constructors
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   150
        for (int c = 0; c < 3; c++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   151
            sb.append("public ").append(cn).append("(");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   152
            for (int i = 0; i < c; i++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   153
                sb.append(i == 0 ? "" : ", ").append("int i").append(i);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   154
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   155
            sb.append(") { }\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   156
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   157
        // methods
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   158
        for (int m = 0; m < 3; m++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   159
            sb.append("public void m").append(m).append("() { }\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   160
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   161
        sb.append("public void n(").append(enumClassName).append(" e){}");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   162
        sb.append("}\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   163
        return sb.toString();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   164
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   165
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   166
    String genAnno(String pkg, int index) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   167
        String an = (pkg + "a" + index).toUpperCase();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   168
        StringBuilder sb = new StringBuilder();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   169
        sb.append("package ").append(pkg).append(";\n")
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   170
                .append("public @interface ").append(an).append(" {\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   171
        // fields
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   172
        for (int f = 0; f < 3; f++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   173
            sb.append("public static final int f").append(f).append(" = 0;\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   174
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   175
            // values
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   176
        for (int v = 0; v < 6; v++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   177
            sb.append("public int v").append(v).append("()").append(v< 3 ? "" :  " default " + v).append(";\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   178
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   179
        sb.append("}\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   180
        return sb.toString();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   181
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   182
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   183
    String genEnum(String pkg, int index) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   184
        String en = (pkg + "e" + index).toUpperCase();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   185
        StringBuilder sb = new StringBuilder();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   186
        sb.append("package ").append(pkg).append(";\n")
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   187
                .append("public enum ").append(en).append(" {\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   188
             // enum members
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   189
        for (int e = 0; e < 3; e++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   190
            sb.append(e == 0 ? "" : ", ").append("E").append(e);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   191
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   192
        sb.append(";\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   193
        // fields
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   194
        for (int f = 0; f < 3; f++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   195
            sb.append("public int f").append(f).append(";\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   196
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   197
        // methods
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   198
        for (int m = 0; m < 3; m++) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   199
            sb.append("public void m").append(m).append("() { }\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   200
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   201
        sb.append("}\n");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   202
        return sb.toString();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   203
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   204
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   205
    void checkLists() {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   206
        checking("Check lists");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   207
        ListChecker c = new ListChecker(out, this::readFile);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   208
        try {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   209
            c.checkDirectory(outputDir.toPath());
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   210
            c.report();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   211
            int errors = c.getErrorCount();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   212
            if (errors == 0) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   213
                passed("No list errors found");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   214
            } else {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   215
                failed(errors + " errors found when checking lists");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   216
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   217
        } catch (IOException e) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   218
            failed("exception thrown when reading files: " + e);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   219
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   220
    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   221
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   222
    /**
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   223
     * A class to check the presence of singleton lists.
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   224
     */
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   225
    public class ListChecker extends HtmlChecker {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   226
        private int listErrors;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   227
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   228
        private boolean inBody;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   229
        private boolean inNoScript;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   230
        private Stack<Map<String,Integer>> counts = new Stack<>();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   231
        private int regionErrors;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   232
        private String fileName;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   233
        private boolean inheritanceClass;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   234
        private List<String> excludeFiles = List.of("overview-tree.html","package-tree.html","module-summary.html");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   235
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   236
        ListChecker(PrintStream out, Function<Path,String> fileReader) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   237
            super(out, fileReader);
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   238
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   239
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   240
        protected int getErrorCount() {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   241
            return errors;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   242
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   243
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   244
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   245
        public void report() {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   246
            if (listErrors == 0) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   247
                out.println("All lists OK");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   248
            } else {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   249
                out.println(listErrors + " list errors");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   250
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   251
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   252
            if (regionErrors == 0) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   253
                out.println("All regions OK");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   254
            } else {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   255
                out.println(regionErrors + " errors in regions");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   256
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   257
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   258
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   259
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   260
        public void startFile(Path path) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   261
            fileName = path.getFileName().toString();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   262
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   263
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   264
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   265
        public void endFile() {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   266
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   267
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   268
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   269
        public void docType(String doctype) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   270
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   271
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   272
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   273
        public void startElement(String name, Map<String,String> attrs, boolean selfClosing) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   274
            switch (name) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   275
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   276
                case "ul": case "ol": case "dl":
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   277
                    counts.push(new TreeMap<>());
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   278
                    break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   279
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   280
                case "li": case "dd": case "dt": {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   281
                    Map<String, Integer> c = counts.peek();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   282
                    c.put(name, 1 + c.computeIfAbsent(name, n -> 0));
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   283
                    break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   284
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   285
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   286
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   287
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   288
        @Override
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   289
        public void endElement(String name) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   290
            switch (name) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   291
                case "ul": case "ol": {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   292
                    Map<String,Integer> c = counts.pop();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   293
                    if (c.get("li") == 0) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   294
                        error(currFile, getLineNumber(), "empty list");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   295
                    } else if (c.get("li") == 1 && fileName != null && !excludeFiles.contains(fileName)) {
54648
89f2043ee67a 8221991: Improve the HTML for the inheritance tree for a type
pmuthuswamy
parents: 54596
diff changeset
   296
                        error(currFile, getLineNumber(), "singleton list");
54596
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   297
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   298
                    break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   299
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   300
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   301
                case "dl": {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   302
                    Map<String, Integer> c = counts.pop();
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   303
                    if (c.get("dd") == 0 || c.get("dt") == 0) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   304
                        error(currFile, getLineNumber(), "empty list");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   305
                    }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   306
                    /*if (c.get("dd") == 1 || c.get("dt") == 1) {
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   307
                        error(currFile, getLineNumber(), "singleton list");
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   308
                    }*/
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   309
                    break;
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   310
                }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   311
            }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   312
        }
86c1da00dd6a 8219998: Eliminate inherently singleton lists
pmuthuswamy
parents:
diff changeset
   313
    }
54648
89f2043ee67a 8221991: Improve the HTML for the inheritance tree for a type
pmuthuswamy
parents: 54596
diff changeset
   314
}