test/langtools/tools/lib/toolbox/ToolBox.java
author jjg
Mon, 02 Jul 2018 17:54:36 -0700
changeset 50967 1e24c7152e47
parent 50240 b9c483223a91
permissions -rw-r--r--
8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule Reviewed-by: darcy
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     1
/*
50240
b9c483223a91 8202947: Fix minor issues with taglets
jjg
parents: 48325
diff changeset
     2
 * Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     3
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     4
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     5
 * This code is free software; you can redistribute it and/or modify it
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     6
 * under the terms of the GNU General Public License version 2 only, as
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     7
 * published by the Free Software Foundation.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     8
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
     9
 * This code is distributed in the hope that it will be useful, but WITHOUT
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    10
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    11
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    12
 * version 2 for more details (a copy is included in the LICENSE file that
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    13
 * accompanied this code).
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    14
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    15
 * You should have received a copy of the GNU General Public License version
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    16
 * 2 along with this work; if not, write to the Free Software Foundation,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    17
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    18
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    19
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    20
 * or visit www.oracle.com if you need additional information or have any
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    21
 * questions.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    22
 */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    23
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    24
package toolbox;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    25
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    26
import java.io.BufferedWriter;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    27
import java.io.ByteArrayOutputStream;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    28
import java.io.FilterOutputStream;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    29
import java.io.FilterWriter;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    30
import java.io.IOException;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    31
import java.io.OutputStream;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    32
import java.io.PrintStream;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    33
import java.io.StringWriter;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    34
import java.io.Writer;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    35
import java.net.URI;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    36
import java.nio.charset.Charset;
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
    37
import java.nio.file.DirectoryNotEmptyException;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    38
import java.nio.file.FileVisitResult;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    39
import java.nio.file.Files;
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
    40
import java.nio.file.NoSuchFileException;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    41
import java.nio.file.Path;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    42
import java.nio.file.Paths;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    43
import java.nio.file.SimpleFileVisitor;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    44
import java.nio.file.StandardCopyOption;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    45
import java.nio.file.attribute.BasicFileAttributes;
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
    46
import java.util.ArrayList;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    47
import java.util.Arrays;
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
    48
import java.util.Collection;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    49
import java.util.Collections;
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
    50
import java.util.Deque;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    51
import java.util.HashMap;
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
    52
import java.util.LinkedList;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    53
import java.util.List;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    54
import java.util.Locale;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    55
import java.util.Map;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    56
import java.util.Objects;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    57
import java.util.Set;
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
    58
import java.util.TreeSet;
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    59
import java.util.regex.Matcher;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    60
import java.util.regex.Pattern;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    61
import java.util.stream.Collectors;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    62
import java.util.stream.StreamSupport;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    63
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    64
import javax.tools.FileObject;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    65
import javax.tools.ForwardingJavaFileManager;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    66
import javax.tools.JavaFileManager;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    67
import javax.tools.JavaFileObject;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    68
import javax.tools.JavaFileObject.Kind;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    69
import javax.tools.JavaFileManager.Location;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    70
import javax.tools.SimpleJavaFileObject;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    71
import javax.tools.ToolProvider;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    72
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    73
/**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    74
 * Utility methods and classes for writing jtreg tests for
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    75
 * javac, javah, javap, and sjavac. (For javadoc support,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    76
 * see JavadocTester.)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    77
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    78
 * <p>There is support for common file operations similar to
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    79
 * shell commands like cat, cp, diff, mv, rm, grep.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    80
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    81
 * <p>There is also support for invoking various tools, like
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    82
 * javac, javah, javap, jar, java and other JDK tools.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    83
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    84
 * <p><em>File separators</em>: for convenience, many operations accept strings
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    85
 * to represent filenames. On all platforms on which JDK is supported,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    86
 * "/" is a legal filename component separator. In particular, even
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    87
 * on Windows, where the official file separator is "\", "/" is a legal
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    88
 * alternative. It is therefore recommended that any client code using
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    89
 * strings to specify filenames should use "/".
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    90
 *
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    91
 * @author Vicente Romero (original)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    92
 * @author Jonathan Gibbons (revised)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    93
 */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    94
public class ToolBox {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    95
    /** The platform line separator. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    96
    public static final String lineSeparator = System.getProperty("line.separator");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    97
    /** The platform OS name. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    98
    public static final String osName = System.getProperty("os.name");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
    99
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   100
    /** The location of the class files for this test, or null if not set. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   101
    public static final String testClasses = System.getProperty("test.classes");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   102
    /** The location of the source files for this test, or null if not set. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   103
    public static final String testSrc = System.getProperty("test.src");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   104
    /** The location of the test JDK for this test, or null if not set. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   105
    public static final String testJDK = System.getProperty("test.jdk");
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   106
    /** The timeout factor for slow systems. */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   107
    public static final float timeoutFactor;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   108
    static {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   109
        String ttf = System.getProperty("test.timeout.factor");
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   110
        timeoutFactor = (ttf == null) ? 1.0f : Float.valueOf(ttf);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   111
    }
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   112
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   113
    /** The current directory. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   114
    public static final Path currDir = Paths.get(".");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   115
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   116
    /** The stream used for logging output. */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   117
    public PrintStream out = System.err;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   118
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   119
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   120
     * Checks if the host OS is some version of Windows.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   121
     * @return true if the host OS is some version of Windows
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   122
     */
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   123
    public static boolean isWindows() {
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   124
        return osName.toLowerCase(Locale.ENGLISH).startsWith("windows");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   125
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   126
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   127
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   128
     * Splits a string around matches of the given regular expression.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   129
     * If the string is empty, an empty list will be returned.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   130
     * @param text the string to be split
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   131
     * @param sep  the delimiting regular expression
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   132
     * @return the strings between the separators
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   133
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   134
    public List<String> split(String text, String sep) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   135
        if (text.isEmpty())
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   136
            return Collections.emptyList();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   137
        return Arrays.asList(text.split(sep));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   138
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   139
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   140
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   141
     * Checks if two lists of strings are equal.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   142
     * @param l1 the first list of strings to be compared
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   143
     * @param l2 the second list of strings to be compared
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   144
     * @throws Error if the lists are not equal
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   145
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   146
    public void checkEqual(List<String> l1, List<String> l2) throws Error {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   147
        if (!Objects.equals(l1, l2)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   148
            // l1 and l2 cannot both be null
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   149
            if (l1 == null)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   150
                throw new Error("comparison failed: l1 is null");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   151
            if (l2 == null)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   152
                throw new Error("comparison failed: l2 is null");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   153
            // report first difference
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   154
            for (int i = 0; i < Math.min(l1.size(), l2.size()); i++) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   155
                String s1 = l1.get(i);
50240
b9c483223a91 8202947: Fix minor issues with taglets
jjg
parents: 48325
diff changeset
   156
                String s2 = l2.get(i);
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   157
                if (!Objects.equals(s1, s2)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   158
                    throw new Error("comparison failed, index " + i +
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   159
                            ", (" + s1 + ":" + s2 + ")");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   160
                }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   161
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   162
            throw new Error("comparison failed: l1.size=" + l1.size() + ", l2.size=" + l2.size());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   163
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   164
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   165
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   166
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   167
     * Filters a list of strings according to the given regular expression.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   168
     * @param regex the regular expression
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   169
     * @param lines the strings to be filtered
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   170
     * @return the strings matching the regular expression
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   171
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   172
    public List<String> grep(String regex, List<String> lines) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   173
        return grep(Pattern.compile(regex), lines);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   174
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   175
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   176
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   177
     * Filters a list of strings according to the given regular expression.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   178
     * @param pattern the regular expression
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   179
     * @param lines the strings to be filtered
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   180
     * @return the strings matching the regular expression
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   181
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   182
    public List<String> grep(Pattern pattern, List<String> lines) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   183
        return lines.stream()
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   184
                .filter(s -> pattern.matcher(s).find())
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   185
                .collect(Collectors.toList());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   186
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   187
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   188
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   189
     * Copies a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   190
     * If the given destination exists and is a directory, the copy is created
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   191
     * in that directory.  Otherwise, the copy will be placed at the destination,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   192
     * possibly overwriting any existing file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   193
     * <p>Similar to the shell "cp" command: {@code cp from to}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   194
     * @param from the file to be copied
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   195
     * @param to where to copy the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   196
     * @throws IOException if any error occurred while copying the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   197
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   198
    public void copyFile(String from, String to) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   199
        copyFile(Paths.get(from), Paths.get(to));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   200
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   201
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   202
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   203
     * Copies a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   204
     * If the given destination exists and is a directory, the copy is created
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   205
     * in that directory.  Otherwise, the copy will be placed at the destination,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   206
     * possibly overwriting any existing file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   207
     * <p>Similar to the shell "cp" command: {@code cp from to}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   208
     * @param from the file to be copied
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   209
     * @param to where to copy the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   210
     * @throws IOException if an error occurred while copying the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   211
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   212
    public void copyFile(Path from, Path to) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   213
        if (Files.isDirectory(to)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   214
            to = to.resolve(from.getFileName());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   215
        } else {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   216
            Files.createDirectories(to.getParent());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   217
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   218
        Files.copy(from, to, StandardCopyOption.REPLACE_EXISTING);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   219
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   220
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   221
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   222
     * Creates one of more directories.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   223
     * For each of the series of paths, a directory will be created,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   224
     * including any necessary parent directories.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   225
     * <p>Similar to the shell command: {@code mkdir -p paths}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   226
     * @param paths the directories to be created
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   227
     * @throws IOException if an error occurred while creating the directories
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   228
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   229
    public void createDirectories(String... paths) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   230
        if (paths.length == 0)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   231
            throw new IllegalArgumentException("no directories specified");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   232
        for (String p : paths)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   233
            Files.createDirectories(Paths.get(p));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   234
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   235
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   236
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   237
     * Creates one or more directories.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   238
     * For each of the series of paths, a directory will be created,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   239
     * including any necessary parent directories.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   240
     * <p>Similar to the shell command: {@code mkdir -p paths}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   241
     * @param paths the directories to be created
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   242
     * @throws IOException if an error occurred while creating the directories
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   243
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   244
    public void createDirectories(Path... paths) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   245
        if (paths.length == 0)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   246
            throw new IllegalArgumentException("no directories specified");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   247
        for (Path p : paths)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   248
            Files.createDirectories(p);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   249
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   250
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   251
    /**
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   252
     * Deletes one or more files, awaiting confirmation that the files
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   253
     * no longer exist. Any directories to be deleted must be empty.
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   254
     * <p>Similar to the shell command: {@code rm files}.
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   255
     * @param files the names of the files to be deleted
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   256
     * @throws IOException if an error occurred while deleting the files
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   257
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   258
    public void deleteFiles(String... files) throws IOException {
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   259
        deleteFiles(List.of(files).stream().map(Paths::get).collect(Collectors.toList()));
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   260
    }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   261
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   262
    /**
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   263
     * Deletes one or more files, awaiting confirmation that the files
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   264
     * no longer exist. Any directories to be deleted must be empty.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   265
     * <p>Similar to the shell command: {@code rm files}.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   266
     * @param paths the paths for the files to be deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   267
     * @throws IOException if an error occurred while deleting the files
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   268
     */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   269
    public void deleteFiles(Path... paths) throws IOException {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   270
        deleteFiles(List.of(paths));
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   271
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   272
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   273
    /**
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   274
     * Deletes one or more files, awaiting confirmation that the files
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   275
     * no longer exist. Any directories to be deleted must be empty.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   276
     * <p>Similar to the shell command: {@code rm files}.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   277
     * @param paths the paths for the files to be deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   278
     * @throws IOException if an error occurred while deleting the files
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   279
     */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   280
    public void deleteFiles(List<Path> paths) throws IOException {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   281
        if (paths.isEmpty())
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   282
            throw new IllegalArgumentException("no files specified");
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   283
        IOException ioe = null;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   284
        for (Path path : paths) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   285
            ioe = deleteFile(path, ioe);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   286
        }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   287
        if (ioe != null) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   288
            throw ioe;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   289
        }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   290
        ensureDeleted(paths);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   291
    }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   292
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   293
    /**
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   294
     * Deletes all content of a directory (but not the directory itself),
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   295
     * awaiting confirmation that the content has been deleted.
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   296
     * @param root the directory to be cleaned
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   297
     * @throws IOException if an error occurs while cleaning the directory
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   298
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   299
    public void cleanDirectory(Path root) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   300
        if (!Files.isDirectory(root)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   301
            throw new IOException(root + " is not a directory");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   302
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   303
        Files.walkFileTree(root, new SimpleFileVisitor<Path>() {
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   304
            private IOException ioe = null;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   305
            // for each directory we visit, maintain a list of the files that we try to delete
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   306
            private Deque<List<Path>> dirFiles = new LinkedList<>();
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   307
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   308
            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   309
            public FileVisitResult visitFile(Path file, BasicFileAttributes a) throws IOException {
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   310
                ioe = deleteFile(file, ioe);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   311
                dirFiles.peekFirst().add(file);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   312
                return FileVisitResult.CONTINUE;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   313
            }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   314
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   315
            @Override
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   316
            public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes a) throws IOException {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   317
                if (!dir.equals(root)) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   318
                    dirFiles.peekFirst().add(dir);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   319
                }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   320
                dirFiles.addFirst(new ArrayList<>());
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   321
                return FileVisitResult.CONTINUE;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   322
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   323
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   324
            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   325
            public FileVisitResult postVisitDirectory(Path dir, IOException e) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   326
                if (e != null) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   327
                    throw e;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   328
                }
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   329
                if (ioe != null) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   330
                    throw ioe;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   331
                }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   332
                ensureDeleted(dirFiles.removeFirst());
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   333
                if (!dir.equals(root)) {
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   334
                    ioe = deleteFile(dir, ioe);
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   335
                }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   336
                return FileVisitResult.CONTINUE;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   337
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   338
        });
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   339
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   340
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   341
    /**
50967
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   342
     * Internal method to delete a file, using {@code Files.delete}.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   343
     * It does not wait to confirm deletion, nor does it retry.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   344
     * If an exception occurs it is either returned or added to the set of
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   345
     * suppressed exceptions for an earlier exception.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   346
     * @param path the path for the file to be deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   347
     * @param ioe the earlier exception, or null
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   348
     * @return the earlier exception or an exception that occurred while
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   349
     *  trying to delete the file
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   350
     */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   351
    private IOException deleteFile(Path path, IOException ioe) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   352
        try {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   353
            Files.delete(path);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   354
        } catch (IOException e) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   355
            if (ioe == null) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   356
                ioe = e;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   357
            } else {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   358
                ioe.addSuppressed(e);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   359
            }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   360
        }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   361
        return ioe;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   362
    }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   363
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   364
    /**
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   365
     * Wait until it is confirmed that a set of files have been deleted.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   366
     * @param paths the paths for the files to be deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   367
     * @throws IOException if a file has not been deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   368
     */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   369
    private void ensureDeleted(Collection<Path> paths)
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   370
            throws IOException {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   371
        for (Path path : paths) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   372
            ensureDeleted(path);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   373
        }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   374
    }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   375
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   376
    /**
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   377
     * Wait until it is confirmed that a file has been deleted.
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   378
     * @param path the path for the file to be deleted
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   379
     * @throws IOException if problems occur while deleting the file
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   380
     */
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   381
    private void ensureDeleted(Path path) throws IOException {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   382
        long startTime = System.currentTimeMillis();
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   383
        do {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   384
            // Note: Files.notExists is not the same as !Files.exists
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   385
            if (Files.notExists(path)) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   386
                return;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   387
            }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   388
            System.gc(); // allow finalizers and cleaners to run
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   389
            try {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   390
                Thread.sleep(RETRY_DELETE_MILLIS);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   391
            } catch (InterruptedException e) {
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   392
                throw new IOException("Interrupted while waiting for file to be deleted: " + path, e);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   393
            }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   394
        } while ((System.currentTimeMillis() - startTime) <= MAX_RETRY_DELETE_MILLIS);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   395
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   396
        throw new IOException("File not deleted: " + path);
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   397
    }
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   398
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   399
    private static final int RETRY_DELETE_MILLIS = isWindows() ? (int)(500 * timeoutFactor): 0;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   400
    private static final int MAX_RETRY_DELETE_MILLIS = isWindows() ? (int)(15 * 1000 * timeoutFactor) : 0;
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   401
1e24c7152e47 8205563: modules/AnnotationProcessing.java failed testGenerateSingleModule
jjg
parents: 50240
diff changeset
   402
    /**
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   403
     * Moves a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   404
     * If the given destination exists and is a directory, the file will be moved
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   405
     * to that directory.  Otherwise, the file will be moved to the destination,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   406
     * possibly overwriting any existing file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   407
     * <p>Similar to the shell "mv" command: {@code mv from to}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   408
     * @param from the file to be moved
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   409
     * @param to where to move the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   410
     * @throws IOException if an error occurred while moving the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   411
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   412
    public void moveFile(String from, String to) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   413
        moveFile(Paths.get(from), Paths.get(to));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   414
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   415
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   416
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   417
     * Moves a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   418
     * If the given destination exists and is a directory, the file will be moved
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   419
     * to that directory.  Otherwise, the file will be moved to the destination,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   420
     * possibly overwriting any existing file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   421
     * <p>Similar to the shell "mv" command: {@code mv from to}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   422
     * @param from the file to be moved
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   423
     * @param to where to move the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   424
     * @throws IOException if an error occurred while moving the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   425
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   426
    public void moveFile(Path from, Path to) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   427
        if (Files.isDirectory(to)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   428
            to = to.resolve(from.getFileName());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   429
        } else {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   430
            Files.createDirectories(to.getParent());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   431
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   432
        Files.move(from, to, StandardCopyOption.REPLACE_EXISTING);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   433
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   434
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   435
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   436
     * Reads the lines of a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   437
     * The file is read using the default character encoding.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   438
     * @param path the file to be read
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   439
     * @return the lines of the file
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   440
     * @throws IOException if an error occurred while reading the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   441
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   442
    public List<String> readAllLines(String path) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   443
        return readAllLines(path, null);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   444
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   445
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   446
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   447
     * Reads the lines of a file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   448
     * The file is read using the default character encoding.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   449
     * @param path the file to be read
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   450
     * @return the lines of the file
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   451
     * @throws IOException if an error occurred while reading the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   452
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   453
    public List<String> readAllLines(Path path) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   454
        return readAllLines(path, null);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   455
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   456
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   457
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   458
     * Reads the lines of a file using the given encoding.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   459
     * @param path the file to be read
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   460
     * @param encoding the encoding to be used to read the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   461
     * @return the lines of the file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   462
     * @throws IOException if an error occurred while reading the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   463
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   464
    public List<String> readAllLines(String path, String encoding) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   465
        return readAllLines(Paths.get(path), encoding);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   466
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   467
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   468
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   469
     * Reads the lines of a file using the given encoding.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   470
     * @param path the file to be read
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   471
     * @param encoding the encoding to be used to read the file
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   472
     * @return the lines of the file
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   473
     * @throws IOException if an error occurred while reading the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   474
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   475
    public List<String> readAllLines(Path path, String encoding) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   476
        return Files.readAllLines(path, getCharset(encoding));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   477
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   478
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   479
    private Charset getCharset(String encoding) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   480
        return (encoding == null) ? Charset.defaultCharset() : Charset.forName(encoding);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   481
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   482
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   483
    /**
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   484
     * Find .java files in one or more directories.
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   485
     * <p>Similar to the shell "find" command: {@code find paths -name \*.java}.
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   486
     * @param paths the directories in which to search for .java files
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   487
     * @return the .java files found
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   488
     * @throws IOException if an error occurred while searching for files
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   489
     */
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   490
    public Path[] findJavaFiles(Path... paths) throws IOException {
39105
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   491
        return findFiles(".java", paths);
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   492
    }
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   493
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   494
    /**
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   495
     * Find files matching the file extension, in one or more directories.
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   496
     * <p>Similar to the shell "find" command: {@code find paths -name \*.ext}.
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   497
     * @param fileExtension the extension to search for
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   498
     * @param paths the directories in which to search for files
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   499
     * @return the files matching the file extension
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   500
     * @throws IOException if an error occurred while searching for files
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   501
     */
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   502
    public Path[] findFiles(String fileExtension, Path... paths) throws IOException {
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   503
        Set<Path> files = new TreeSet<>();  // use TreeSet to force a consistent order
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   504
        for (Path p : paths) {
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   505
            Files.walkFileTree(p, new SimpleFileVisitor<Path>() {
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   506
                @Override
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   507
                public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   508
                        throws IOException {
39105
956490b8da9c 8159756: javadoc tests needs a tool invoker
ksrini
parents: 37758
diff changeset
   509
                    if (file.getFileName().toString().endsWith(fileExtension)) {
37758
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   510
                        files.add(file);
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   511
                    }
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   512
                    return FileVisitResult.CONTINUE;
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   513
                }
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   514
            });
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   515
        }
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   516
        return files.toArray(new Path[files.size()]);
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   517
    }
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   518
3ecf9b414e05 8155774: move code from ModuleTestBase to toolbox
jjg
parents: 36778
diff changeset
   519
    /**
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   520
     * Writes a file containing the given content.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   521
     * Any necessary directories for the file will be created.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   522
     * @param path where to write the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   523
     * @param content the content for the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   524
     * @throws IOException if an error occurred while writing the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   525
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   526
    public void writeFile(String path, String content) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   527
        writeFile(Paths.get(path), content);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   528
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   529
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   530
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   531
     * Writes a file containing the given content.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   532
     * Any necessary directories for the file will be created.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   533
     * @param path where to write the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   534
     * @param content the content for the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   535
     * @throws IOException if an error occurred while writing the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   536
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   537
    public void writeFile(Path path, String content) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   538
        Path dir = path.getParent();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   539
        if (dir != null)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   540
            Files.createDirectories(dir);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   541
        try (BufferedWriter w = Files.newBufferedWriter(path)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   542
            w.write(content);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   543
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   544
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   545
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   546
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   547
     * Writes one or more files containing Java source code.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   548
     * For each file to be written, the filename will be inferred from the
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   549
     * given base directory, the package declaration (if present) and from the
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   550
     * the name of the first class, interface or enum declared in the file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   551
     * <p>For example, if the base directory is /my/dir/ and the content
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   552
     * contains "package p; class C { }", the file will be written to
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   553
     * /my/dir/p/C.java.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   554
     * <p>Note: the content is analyzed using regular expressions;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   555
     * errors can occur if any contents have initial comments that might trip
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   556
     * up the analysis.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   557
     * @param dir the base directory
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   558
     * @param contents the contents of the files to be written
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   559
     * @throws IOException if an error occurred while writing any of the files.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   560
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   561
    public void writeJavaFiles(Path dir, String... contents) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   562
        if (contents.length == 0)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   563
            throw new IllegalArgumentException("no content specified for any files");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   564
        for (String c : contents) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   565
            new JavaSource(c).write(dir);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   566
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   567
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   568
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   569
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   570
     * Returns the path for the binary of a JDK tool within {@link testJDK}.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   571
     * @param tool the name of the tool
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   572
     * @return the path of the tool
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   573
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   574
    public Path getJDKTool(String tool) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   575
        return Paths.get(testJDK, "bin", tool);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   576
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   577
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   578
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   579
     * Returns a string representing the contents of an {@code Iterable} as a list.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   580
     * @param <T> the type parameter of the {@code Iterable}
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   581
     * @param items the iterable
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   582
     * @return the string
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   583
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   584
    <T> String toString(Iterable<T> items) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   585
        return StreamSupport.stream(items.spliterator(), false)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   586
                .map(Objects::toString)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   587
                .collect(Collectors.joining(",", "[", "]"));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   588
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   589
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   590
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   591
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   592
     * An in-memory Java source file.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   593
     * It is able to extract the file name from simple source text using
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   594
     * regular expressions.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   595
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   596
    public static class JavaSource extends SimpleJavaFileObject {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   597
        private final String source;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   598
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   599
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   600
         * Creates a in-memory file object for Java source code.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   601
         * @param className the name of the class
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   602
         * @param source the source text
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   603
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   604
        public JavaSource(String className, String source) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   605
            super(URI.create(className), JavaFileObject.Kind.SOURCE);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   606
            this.source = source;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   607
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   608
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   609
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   610
         * Creates a in-memory file object for Java source code.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   611
         * The name of the class will be inferred from the source code.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   612
         * @param source the source text
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   613
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   614
        public JavaSource(String source) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   615
            super(URI.create(getJavaFileNameFromSource(source)),
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   616
                    JavaFileObject.Kind.SOURCE);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   617
            this.source = source;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   618
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   619
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   620
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   621
         * Writes the source code to a file in the current directory.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   622
         * @throws IOException if there is a problem writing the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   623
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   624
        public void write() throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   625
            write(currDir);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   626
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   627
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   628
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   629
         * Writes the source code to a file in a specified directory.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   630
         * @param dir the directory
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   631
         * @throws IOException if there is a problem writing the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   632
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   633
        public void write(Path dir) throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   634
            Path file = dir.resolve(getJavaFileNameFromSource(source));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   635
            Files.createDirectories(file.getParent());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   636
            try (BufferedWriter out = Files.newBufferedWriter(file)) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   637
                out.write(source.replace("\n", lineSeparator));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   638
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   639
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   640
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   641
        @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   642
        public CharSequence getCharContent(boolean ignoreEncodingErrors) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   643
            return source;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   644
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   645
48325
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   646
        private static Pattern commentPattern =
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   647
                Pattern.compile("(?s)(\\s+//.*?\n|/\\*.*?\\*/)");
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   648
        private static Pattern modulePattern =
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   649
                Pattern.compile("module\\s+((?:\\w+\\.)*)");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   650
        private static Pattern packagePattern =
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   651
                Pattern.compile("package\\s+(((?:\\w+\\.)*)(?:\\w+))");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   652
        private static Pattern classPattern =
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   653
                Pattern.compile("(?:public\\s+)?(?:class|enum|interface)\\s+(\\w+)");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   654
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   655
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   656
         * Extracts the Java file name from the class declaration.
48325
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   657
         * This method is intended for simple files and uses regular expressions.
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   658
         * Comments in the source are stripped before looking for the
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   659
         * declarations from which the name is derived.
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   660
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   661
        static String getJavaFileNameFromSource(String source) {
48325
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   662
            StringBuilder sb = new StringBuilder();
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   663
            Matcher matcher = commentPattern.matcher(source);
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   664
            int start = 0;
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   665
            while (matcher.find()) {
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   666
                sb.append(source.substring(start, matcher.start()));
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   667
                start = matcher.end();
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   668
            }
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   669
            sb.append(source.substring(start));
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   670
            source = sb.toString();
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   671
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   672
            String packageName = null;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   673
48325
e5cdedd37b78 8178070: duplicate entries in package table
jjg
parents: 47216
diff changeset
   674
            matcher = modulePattern.matcher(source);
36778
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   675
            if (matcher.find())
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   676
                return "module-info.java";
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   677
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   678
            matcher = packagePattern.matcher(source);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   679
            if (matcher.find())
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   680
                packageName = matcher.group(1).replace(".", "/");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   681
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   682
            matcher = classPattern.matcher(source);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   683
            if (matcher.find()) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   684
                String className = matcher.group(1) + ".java";
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   685
                return (packageName == null) ? className : packageName + "/" + className;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   686
            } else if (packageName != null) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   687
                return packageName + "/package-info.java";
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   688
            } else {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   689
                throw new Error("Could not extract the java class " +
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   690
                        "name from the provided source");
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   691
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   692
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   693
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   694
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   695
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   696
     * Extracts the Java file name from the class declaration.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   697
     * This method is intended for simple files and uses regular expressions,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   698
     * so comments matching the pattern can make the method fail.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   699
     * @deprecated This is a legacy method for compatibility with ToolBox v1.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   700
     *      Use {@link JavaSource#getName JavaSource.getName} instead.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   701
     * @param source the source text
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   702
     * @return the Java file name inferred from the source
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   703
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   704
    @Deprecated
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   705
    public static String getJavaFileNameFromSource(String source) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   706
        return JavaSource.getJavaFileNameFromSource(source);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   707
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   708
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   709
    /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   710
     * A memory file manager, for saving generated files in memory.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   711
     * The file manager delegates to a separate file manager for listing and
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   712
     * reading input files.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   713
     */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   714
    public static class MemoryFileManager extends ForwardingJavaFileManager {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   715
        private interface Content {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   716
            byte[] getBytes();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   717
            String getString();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   718
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   719
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   720
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   721
         * Maps binary class names to generated content.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   722
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   723
        private final Map<Location, Map<String, Content>> files;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   724
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   725
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   726
         * Construct a memory file manager which stores output files in memory,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   727
         * and delegates to a default file manager for input files.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   728
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   729
        public MemoryFileManager() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   730
            this(ToolProvider.getSystemJavaCompiler().getStandardFileManager(null, null, null));
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   731
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   732
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   733
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   734
         * Construct a memory file manager which stores output files in memory,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   735
         * and delegates to a specified file manager for input files.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   736
         * @param fileManager the file manager to be used for input files
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   737
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   738
        public MemoryFileManager(JavaFileManager fileManager) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   739
            super(fileManager);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   740
            files = new HashMap<>();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   741
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   742
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   743
        @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   744
        public JavaFileObject getJavaFileForOutput(Location location,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   745
                                                   String name,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   746
                                                   JavaFileObject.Kind kind,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   747
                                                   FileObject sibling)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   748
        {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   749
            return new MemoryFileObject(location, name, kind);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   750
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   751
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   752
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   753
         * Returns the set of names of files that have been written to a given
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   754
         * location.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   755
         * @param location the location
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   756
         * @return the set of file names
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   757
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   758
        public Set<String> getFileNames(Location location) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   759
            Map<String, Content> filesForLocation = files.get(location);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   760
            return (filesForLocation == null)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   761
                ? Collections.emptySet() : filesForLocation.keySet();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   762
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   763
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   764
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   765
         * Returns the content written to a file in a given location,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   766
         * or null if no such file has been written.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   767
         * @param location the location
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   768
         * @param name the name of the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   769
         * @return the content as an array of bytes
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   770
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   771
        public byte[] getFileBytes(Location location, String name) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   772
            Content content = getFile(location, name);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   773
            return (content == null) ? null : content.getBytes();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   774
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   775
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   776
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   777
         * Returns the content written to a file in a given location,
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   778
         * or null if no such file has been written.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   779
         * @param location the location
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   780
         * @param name the name of the file
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   781
         * @return the content as a string
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   782
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   783
        public String getFileString(Location location, String name) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   784
            Content content = getFile(location, name);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   785
            return (content == null) ? null : content.getString();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   786
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   787
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   788
        private Content getFile(Location location, String name) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   789
            Map<String, Content> filesForLocation = files.get(location);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   790
            return (filesForLocation == null) ? null : filesForLocation.get(name);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   791
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   792
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   793
        private void save(Location location, String name, Content content) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   794
            Map<String, Content> filesForLocation = files.get(location);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   795
            if (filesForLocation == null)
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   796
                files.put(location, filesForLocation = new HashMap<>());
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   797
            filesForLocation.put(name, content);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   798
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   799
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   800
        /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   801
         * A writable file object stored in memory.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   802
         */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   803
        private class MemoryFileObject extends SimpleJavaFileObject {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   804
            private final Location location;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   805
            private final String name;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   806
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   807
            /**
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   808
             * Constructs a memory file object.
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   809
             * @param name binary name of the class to be stored in this file object
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   810
             */
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   811
            MemoryFileObject(Location location, String name, JavaFileObject.Kind kind) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   812
                super(URI.create("mfm:///" + name.replace('.','/') + kind.extension),
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   813
                      Kind.CLASS);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   814
                this.location = location;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   815
                this.name = name;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   816
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   817
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   818
            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   819
            public OutputStream openOutputStream() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   820
                return new FilterOutputStream(new ByteArrayOutputStream()) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   821
                    @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   822
                    public void close() throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   823
                        out.close();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   824
                        byte[] bytes = ((ByteArrayOutputStream) out).toByteArray();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   825
                        save(location, name, new Content() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   826
                            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   827
                            public byte[] getBytes() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   828
                                return bytes;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   829
                            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   830
                            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   831
                            public String getString() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   832
                                return new String(bytes);
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   833
                            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   834
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   835
                        });
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   836
                    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   837
                };
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   838
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   839
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   840
            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   841
            public Writer openWriter() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   842
                return new FilterWriter(new StringWriter()) {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   843
                    @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   844
                    public void close() throws IOException {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   845
                        out.close();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   846
                        String text = ((StringWriter) out).toString();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   847
                        save(location, name, new Content() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   848
                            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   849
                            public byte[] getBytes() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   850
                                return text.getBytes();
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   851
                            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   852
                            @Override
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   853
                            public String getString() {
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   854
                                return text;
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   855
                            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   856
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   857
                        });
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   858
                    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   859
                };
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   860
            }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   861
        }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   862
    }
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   863
}
e04318f39f92 8152897: refactor ToolBox to allow reduced documented dependencies
jjg
parents:
diff changeset
   864