test/tools/javadoc/6964914/TestStdDoclet.java

changeset 0
959103a6100f
child 2525
2eb010b6cb22
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/test/tools/javadoc/6964914/TestStdDoclet.java	Wed Apr 27 01:34:52 2016 +0800
     1.3 @@ -0,0 +1,101 @@
     1.4 +/*
     1.5 + * Copyright (c) 2011, 2013, Oracle and/or its affiliates. All rights reserved.
     1.6 + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     1.7 + *
     1.8 + * This code is free software; you can redistribute it and/or modify it
     1.9 + * under the terms of the GNU General Public License version 2 only, as
    1.10 + * published by the Free Software Foundation.
    1.11 + *
    1.12 + * This code is distributed in the hope that it will be useful, but WITHOUT
    1.13 + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    1.14 + * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
    1.15 + * version 2 for more details (a copy is included in the LICENSE file that
    1.16 + * accompanied this code).
    1.17 + *
    1.18 + * You should have received a copy of the GNU General Public License version
    1.19 + * 2 along with this work; if not, write to the Free Software Foundation,
    1.20 + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
    1.21 + *
    1.22 + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
    1.23 + * or visit www.oracle.com if you need additional information or have any
    1.24 + * questions.
    1.25 + */
    1.26 +
    1.27 +/*
    1.28 + * @test
    1.29 + * @bug 6964914
    1.30 + * @summary javadoc does not output number of warnings using user written doclet
    1.31 + */
    1.32 +
    1.33 +import java.io.*;
    1.34 +
    1.35 +/**
    1.36 + * Dummy javadoc comment.
    1.37 + * @author jjg
    1.38 + * @see DoesNotExist
    1.39 + */
    1.40 +public class TestStdDoclet {
    1.41 +    public static void main(String... args) throws Exception {
    1.42 +        new TestStdDoclet().run();
    1.43 +    }
    1.44 +
    1.45 +    /**
    1.46 +     * More dummy comments.
    1.47 +     * @throws DoesNotExist   oops, javadoc does not see this
    1.48 +     * @see DoesNotExist
    1.49 +     */
    1.50 +    void run() throws Exception {
    1.51 +        File javaHome = new File(System.getProperty("java.home"));
    1.52 +        if (javaHome.getName().equals("jre"))
    1.53 +            javaHome = javaHome.getParentFile();
    1.54 +        File javadoc = new File(new File(javaHome, "bin"), "javadoc");
    1.55 +        File testSrc = new File(System.getProperty("test.src"));
    1.56 +
    1.57 +        // run javadoc in separate process to ensure doclet executed under
    1.58 +        // normal user conditions w.r.t. classloader
    1.59 +        String thisClassName = TestStdDoclet.class.getName();
    1.60 +        Process p = new ProcessBuilder()
    1.61 +            .command(javadoc.getPath(),
    1.62 +                "-J-Xbootclasspath:" + System.getProperty("sun.boot.class.path"),
    1.63 +                "-Xdoclint:none",
    1.64 +                "-package",
    1.65 +                new File(testSrc, thisClassName + ".java").getPath())
    1.66 +            .redirectErrorStream(true)
    1.67 +            .start();
    1.68 +
    1.69 +        int actualDocletWarnCount = 0;
    1.70 +        int reportedDocletWarnCount = 0;
    1.71 +        BufferedReader in = new BufferedReader(new InputStreamReader(p.getInputStream()));
    1.72 +        try {
    1.73 +            String line;
    1.74 +            while ((line = in.readLine()) != null) {
    1.75 +                System.err.println(line);
    1.76 +                if (line.contains("DoesNotExist"))
    1.77 +                    actualDocletWarnCount++;
    1.78 +                if (line.matches("[0-9]+ warning(s)?"))
    1.79 +                    reportedDocletWarnCount =
    1.80 +                            Integer.valueOf(line.substring(0, line.indexOf(" ")));
    1.81 +            }
    1.82 +        } finally {
    1.83 +            in.close();
    1.84 +        }
    1.85 +        int rc = p.waitFor();
    1.86 +        if (rc != 0)
    1.87 +            System.err.println("javadoc failed, rc:" + rc);
    1.88 +
    1.89 +        int expectedDocletWarnCount = 2;
    1.90 +        checkEqual("actual", actualDocletWarnCount, "expected", expectedDocletWarnCount);
    1.91 +        checkEqual("actual", actualDocletWarnCount, "reported", reportedDocletWarnCount);
    1.92 +    }
    1.93 +
    1.94 +    /**
    1.95 +     * Private method should not cause a warning.
    1.96 +     * @see DoesNotExist
    1.97 +     */
    1.98 +    private void checkEqual(String l1, int i1, String l2, int i2) throws Exception {
    1.99 +        if (i1 != i2)
   1.100 +            throw new Exception(l1 + " warn count, " + i1 + ", does not match "
   1.101 +                        + l2 + " warn count, " + i2);
   1.102 +    }
   1.103 +
   1.104 +}

mercurial