1 /* |
|
2 * Copyright (c) 2011, 2016, Oracle and/or its affiliates. All rights reserved. |
|
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
|
4 * |
|
5 * This code is free software; you can redistribute it and/or modify it |
|
6 * under the terms of the GNU General Public License version 2 only, as |
|
7 * published by the Free Software Foundation. |
|
8 * |
|
9 * This code is distributed in the hope that it will be useful, but WITHOUT |
|
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
12 * version 2 for more details (a copy is included in the LICENSE file that |
|
13 * accompanied this code). |
|
14 * |
|
15 * You should have received a copy of the GNU General Public License version |
|
16 * 2 along with this work; if not, write to the Free Software Foundation, |
|
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
18 * |
|
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
|
20 * or visit www.oracle.com if you need additional information or have any |
|
21 * questions. |
|
22 */ |
|
23 |
|
24 /* |
|
25 * @test |
|
26 * @bug 6964914 |
|
27 * @summary javadoc does not output number of warnings using user written doclet |
|
28 * @modules jdk.javadoc |
|
29 */ |
|
30 |
|
31 import java.io.*; |
|
32 import java.util.*; |
|
33 |
|
34 import com.sun.javadoc.Doclet; |
|
35 import com.sun.javadoc.RootDoc; |
|
36 |
|
37 public class TestUserDoclet extends Doclet { |
|
38 public static void main(String... args) throws Exception { |
|
39 new TestUserDoclet().run(); |
|
40 } |
|
41 |
|
42 static final String docletWarning = "warning from test doclet"; |
|
43 |
|
44 /** Main doclet method. */ |
|
45 public static boolean start(RootDoc root) { |
|
46 root.printWarning(null, docletWarning); |
|
47 return true; |
|
48 } |
|
49 |
|
50 /** Main test method. */ |
|
51 void run() throws Exception { |
|
52 File javaHome = new File(System.getProperty("java.home")); |
|
53 File javadoc = new File(new File(javaHome, "bin"), "javadoc"); |
|
54 File testSrc = new File(System.getProperty("test.src")); |
|
55 File testClasses = new File(System.getProperty("test.classes")); |
|
56 |
|
57 // run javadoc in separate process to ensure doclet executed under |
|
58 // normal user conditions w.r.t. classloader |
|
59 String thisClassName = TestUserDoclet.class.getName(); |
|
60 List<String> cmdArgs = new ArrayList<>(); |
|
61 cmdArgs.add(javadoc.getPath()); |
|
62 cmdArgs.addAll(Arrays.asList( |
|
63 "-doclet", thisClassName, |
|
64 "-docletpath", testClasses.getPath(), |
|
65 new File(testSrc, thisClassName + ".java").getPath() |
|
66 )); |
|
67 Process p = new ProcessBuilder() |
|
68 .command(cmdArgs) |
|
69 .redirectErrorStream(true) |
|
70 .start(); |
|
71 |
|
72 int actualDocletWarnCount = 0; |
|
73 int reportedDocletWarnCount = 0; |
|
74 BufferedReader in = new BufferedReader(new InputStreamReader(p.getInputStream())); |
|
75 try { |
|
76 String line; |
|
77 while ((line = in.readLine()) != null) { |
|
78 System.err.println(line); |
|
79 if (line.contains(docletWarning)) |
|
80 actualDocletWarnCount++; |
|
81 if (line.matches("[0-9]+ warning(s)?")) |
|
82 reportedDocletWarnCount = |
|
83 Integer.valueOf(line.substring(0, line.indexOf(" "))); |
|
84 } |
|
85 } finally { |
|
86 in.close(); |
|
87 } |
|
88 int rc = p.waitFor(); |
|
89 if (rc != 0) |
|
90 System.err.println("javadoc failed, rc:" + rc); |
|
91 |
|
92 int expectedDocletWarnCount = 1; |
|
93 checkEqual("actual", actualDocletWarnCount, "expected", expectedDocletWarnCount); |
|
94 checkEqual("actual", actualDocletWarnCount, "reported", reportedDocletWarnCount); |
|
95 } |
|
96 |
|
97 void checkEqual(String l1, int i1, String l2, int i2) throws Exception { |
|
98 if (i1 != i2) |
|
99 throw new Exception(l1 + " warn count, " + i1 + ", does not match " |
|
100 + l2 + " warn count, " + i2); |
|
101 } |
|
102 |
|
103 } |
|