1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
/*
* Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
/*
* @test
* @bug 8135307
* @summary Check that CompletionFailures for missing classes are not incorrectly passed to
* the javadoc API clients.
* @library /tools/lib
* @modules jdk.compiler/com.sun.tools.javac.api
* jdk.compiler/com.sun.tools.javac.main
* jdk.jdeps/com.sun.tools.javap
* @build toolbox.JavacTask toolbox.ToolBox
* @run main CompletionError
*/
import java.io.File;
import com.sun.javadoc.*;
import com.sun.tools.javadoc.Main;
import toolbox.JavacTask;
import toolbox.ToolBox;
public class CompletionError extends Doclet
{
private static final String template =
"public class CompletionErrorAuxiliary #extends CompletionErrorMissing# #implements CompletionErrorIntfMissing# {" +
" #public CompletionErrorMissing tf;#" +
" #public CompletionErrorMissing tm() { return null; }#" +
" #public void tm(CompletionErrorMissing m) {}#" +
" #public void tm() throws CompletionErrorExcMissing {}#" +
" #public <T extends CompletionErrorMissing> void tm() {}#" +
" public String toString() { return null; }" +
"}";
private static final String testSrc = System.getProperty("test.src");
private static final String testClassPath = System.getProperty("test.class.path");
public static void main(String[] args) throws Exception {
String[] templateParts = template.split("#");
int sources = templateParts.length / 2;
for (int source = 0; source < sources; source++) {
StringBuilder testSource = new StringBuilder();
for (int i = 0; i < templateParts.length; i += 2) {
testSource.append(templateParts[i]);
if (i == 2 * source) {
testSource.append(templateParts[i + 1]);
}
}
test = 0;
testsDone = false;
while (!testsDone) {
ToolBox tb = new ToolBox();
new JavacTask(tb)
.sources(testSource.toString(),
"public class CompletionErrorMissing {}",
"public interface CompletionErrorIntfMissing {}",
"public class CompletionErrorExcMissing extends Exception {}")
.outdir(".")
.run()
.writeAll();
tb.deleteFiles("CompletionErrorMissing.class", "CompletionErrorIntfMissing.class", "CompletionErrorExcMissing.class");
// run javadoc:
if (Main.execute("javadoc", "CompletionError", CompletionError.class.getClassLoader(),
"-classpath", "." + File.pathSeparator + testClassPath,
new File(testSrc, "CompletionError.java").getPath()) != 0)
throw new Error();
}
}
}
private static int test;
private static boolean testsDone;
public static boolean start(com.sun.javadoc.RootDoc root) {
ClassDoc aux = root.classNamed("CompletionErrorAuxiliary");
if (aux == null)
throw new AssertionError("Cannot find CompletionErrorAuxiliary");
FieldDoc tf = findField(aux, "tf");
MethodDoc tm = findMethod(aux, "tm");
MethodDoc cm = findMethod(aux, "toString");
switch (test) {
case 0: aux.superclass(); break;
case 1: aux.superclassType(); break;
case 2: aux.interfaces(); break;
case 3: aux.interfaceTypes(); break;
case 4: if (tf != null) tf.type(); break;
case 5: if (tm != null) tm.overriddenClass(); break;
case 6: if (tm != null) tm.overriddenMethod(); break;
case 7: if (tm != null) tm.overriddenType(); break;
case 8:
if (tm != null) {
for (Parameter p : tm.parameters()) {
p.type();
}
}
break;
case 9: if (tm != null) tm.receiverType(); break;
case 10: if (tm != null) tm.returnType(); break;
case 11: if (tm != null) tm.thrownExceptionTypes(); break;
case 12: if (tm != null) tm.thrownExceptions(); break;
case 13:
if (tm != null) {
for (TypeVariable tv : tm.typeParameters()) {
tv.bounds();
}
}
break;
case 14: if (cm != null) cm.overriddenClass(); break;
case 15: if (cm != null) cm.overriddenMethod(); break;
case 16: if (cm != null) cm.overriddenType(); testsDone = true; break;
default:
throw new IllegalStateException("Unrecognized test!");
}
test++;
return true;
}
private static MethodDoc findMethod(ClassDoc cd, String name) {
for (MethodDoc m : cd.methods()) {
if (name.equals(m.name()))
return m;
}
return null;
}
private static FieldDoc findField(ClassDoc cd, String name) {
for (FieldDoc m : cd.fields()) {
if (name.equals(m.name()))
return m;
}
return null;
}
}
|
