699 lines
40 KiB
Java
699 lines
40 KiB
Java
/*
|
|
* Copyright (c) 2003, 2020, 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 4789689 4905985 4927164 4827184 4993906 5004549 7025314 7010344 8025633 8026567 8162363
|
|
* 8175200 8186332 8182765 8196202 8187288 8173730 8215307
|
|
* @summary Run Javadoc on a set of source files that demonstrate new
|
|
* language features. Check the output to ensure that the new
|
|
* language features are properly documented.
|
|
* @library ../../lib
|
|
* @modules jdk.javadoc/jdk.javadoc.internal.tool
|
|
* @build javadoc.tester.*
|
|
* @run main TestNewLanguageFeatures
|
|
*/
|
|
|
|
import javadoc.tester.JavadocTester;
|
|
|
|
public class TestNewLanguageFeatures extends JavadocTester {
|
|
|
|
public static void main(String... args) throws Exception {
|
|
TestNewLanguageFeatures tester = new TestNewLanguageFeatures();
|
|
tester.runTests();
|
|
}
|
|
|
|
@Test
|
|
public void test() {
|
|
javadoc("-Xdoclint:none",
|
|
"-d", "out",
|
|
"-use",
|
|
"--no-platform-links",
|
|
"-sourcepath", testSrc,
|
|
"pkg", "pkg1", "pkg2");
|
|
checkExit(Exit.OK);
|
|
|
|
checkEnums();
|
|
checkTypeParameters();
|
|
checkVarArgs();
|
|
checkAnnotationTypeUsage();
|
|
}
|
|
|
|
//=================================
|
|
// ENUM TESTING
|
|
//=================================
|
|
void checkEnums() {
|
|
checkOutput("pkg/Coin.html", true,
|
|
// Make sure enum header is correct.
|
|
"Enum Coin</h1>",
|
|
// Make sure enum signature is correct.
|
|
"""
|
|
<div class="type-signature"><span class="modifiers">public enum </span><span clas\
|
|
s="element-name type-name-label">Coin</span>
|
|
<span class="extends-implements">extends java.lang.Enum<<a href="Coin.html" ti\
|
|
tle="enum in pkg">Coin</a>></span></div>""",
|
|
// Check for enum constant section
|
|
"<div class=\"caption\"><span>Enum Constants</span></div>",
|
|
// Detail for enum constant
|
|
"""
|
|
<span class="member-name-link"><a href="#Dime">Dime</a></span>""",
|
|
// Automatically insert documentation for values() and valueOf().
|
|
"Returns an array containing the constants of this enum type,",
|
|
"Returns the enum constant of this type with the specified name",
|
|
"Overloaded valueOf() method has correct documentation.",
|
|
"Overloaded values method has correct documentation.",
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public static</span> \
|
|
<span class="return-type"><a href="Coin.html" title="enum in pkg">Coin</a></span\
|
|
> <span class="element-name">valueOf</span>​<span class="parameters">(java.la\
|
|
ng.String name)</span></div>
|
|
<div class="block">Returns the enum constant of this type with the specified name.
|
|
The string must match <i>exactly</i> an identifier used to declare an
|
|
enum constant in this type. (Extraneous whitespace characters are\s
|
|
not permitted.)</div>
|
|
<dl class="notes">
|
|
<dt>Parameters:</dt>
|
|
<dd><code>name</code> - the name of the enum constant to be returned.</dd>
|
|
<dt>Returns:</dt>
|
|
<dd>the enum constant with the specified name</dd>
|
|
<dt>Throws:</dt>
|
|
<dd><code>java.lang.IllegalArgumentException</code> - if this enum type has no constant with the specified name</dd>
|
|
<dd><code>java.lang.NullPointerException</code> - if the argument is null</dd>""");
|
|
|
|
// NO constructor section
|
|
checkOutput("pkg/Coin.html", false,
|
|
"<h3>Constructor Summary</h3>");
|
|
}
|
|
|
|
//=================================
|
|
// TYPE PARAMETER TESTING
|
|
//=================================
|
|
|
|
void checkTypeParameters() {
|
|
checkOutput("pkg/TypeParameters.html", true,
|
|
// Make sure the header is correct.
|
|
"Class TypeParameters<E></h1>",
|
|
// Check class type parameters section.
|
|
"""
|
|
<dt>Type Parameters:</dt>
|
|
<dd><code>E</code> - the type parameter for this class.""",
|
|
// Type parameters in @see/@link
|
|
"""
|
|
<dl class="notes">
|
|
<dt>See Also:</dt>
|
|
<dd><a href="TypeParameters.html" title="class in pkg"><code>TypeParameters</code></a></dd>
|
|
</dl>""",
|
|
// Method that uses class type parameter.
|
|
"""
|
|
(<a href="TypeParameters.html" title="type parameter in TypeParameters">E</a> param)""",
|
|
// Method type parameter section.
|
|
"""
|
|
<dt>Type Parameters:</dt>
|
|
<dd><code>T</code> - This is the first type parameter.</dd>
|
|
<dd><code>V</code> - This is the second type parameter.""",
|
|
// Signature of method with type parameters
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public</span> <span c\
|
|
lass="type-parameters"><T extends java.util.List,​
|
|
V></span>
|
|
<span class="return-type">java.lang.String[]</span> <span class="element-name">meth\
|
|
odThatHasTypeParameters</span>​<span class="parameters">(T param1,
|
|
V param2)</span></div>""",
|
|
// Method that returns TypeParameters
|
|
"""
|
|
<div class="col-first even-row-color method-summary-table-tab2 method-summary-table-t\
|
|
ab4 method-summary-table"><code><a href="TypeParameters.html" title="type parame\
|
|
ter in TypeParameters">E</a>[]</code></div>
|
|
<div class="col-second even-row-color method-summary-table-tab2 method-summary-table-\
|
|
tab4 method-summary-table"><code><span class="member-name-link"><a href="#method\
|
|
ThatReturnsTypeParameterA(E%5B%5D)">methodThatReturnsTypeParameterA</a></span>&#\
|
|
8203;(<a href="TypeParameters.html" title="type parameter in TypeParameters">E</\
|
|
a>[] e)</code>""",
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public</span> <span c\
|
|
lass="return-type"><a href="TypeParameters.html" title="type parameter in TypePa\
|
|
rameters">E</a>[]</span> <span class="element-name">methodThatReturnsTypeParameterA\
|
|
</span>​<span class="parameters">(<a href="TypeParameters.html" tit\
|
|
le="type parameter in TypeParameters">E</a>[] e)</span></div>
|
|
""",
|
|
"""
|
|
<div class="col-first even-row-color method-summary-table-tab2 method-summary-table-t\
|
|
ab4 method-summary-table"><code><T extends java.lang.Object & java.lang.C\
|
|
omparable<? super T>><br>T</code></div>
|
|
<div class="col-second even-row-color method-summary-table-tab2 method-summary-table-\
|
|
tab4 method-summary-table"><code><span class="member-name-link"><a href="#method\
|
|
tThatReturnsTypeParametersB(java.util.Collection)">methodtThatReturnsTypeParamet\
|
|
ersB</a></span>​(java.util.Collection<? extends T> coll)</code>""",
|
|
"""
|
|
<div class="block">Returns TypeParameters</div>
|
|
""",
|
|
// Method takes a TypeVariable
|
|
"""
|
|
<div class="col-first odd-row-color method-summary-table-tab2 method-summary-table-t\
|
|
ab4 method-summary-table"><code><X extends java.lang.Throwable><br><a href\
|
|
="TypeParameters.html" title="type parameter in TypeParameters">E</a></code></di\
|
|
v>
|
|
<div class="col-second odd-row-color method-summary-table-tab2 method-summary-table-\
|
|
tab4 method-summary-table"><code><span class="member-name-link"><a href="#orElse\
|
|
Throw(java.util.function.Supplier)">orElseThrow</a></span>​(java.util.func\
|
|
tion.Supplier<? extends X> exceptionSupplier)</code>"""
|
|
);
|
|
|
|
checkOutput("pkg/Wildcards.html", true,
|
|
// Wildcard testing.
|
|
"""
|
|
<a href="TypeParameters.html" title="class in pkg">TypeParameters</a><? super java.lang.String> a""",
|
|
"""
|
|
<a href="TypeParameters.html" title="class in pkg">TypeParameters</a><? extends java.lang.StringBuffer> b""",
|
|
"""
|
|
<a href="TypeParameters.html" title="class in pkg">TypeParameters</a> c""");
|
|
|
|
checkOutput(Output.OUT, true,
|
|
// Bad type parameter warnings.
|
|
"""
|
|
warning - @param argument "<BadClassTypeParam>" is not the name of a type parameter.""",
|
|
"""
|
|
warning - @param argument "<BadMethodTypeParam>" is not the name of a type parameter.""");
|
|
|
|
// Signature of subclass that has type parameters.
|
|
checkOutput("pkg/TypeParameterSubClass.html", true,
|
|
"""
|
|
<div class="type-signature"><span class="modifiers">public class </span><span cl\
|
|
ass="element-name type-name-label">TypeParameterSubClass<T extends java.lang.\
|
|
String></span>
|
|
<span class="extends-implements">extends <a href="TypeParameterSuperClass.html" \
|
|
title="class in pkg">TypeParameterSuperClass</a><T></span></div>""");
|
|
|
|
// Interface generic parameter substitution
|
|
// Signature of subclass that has type parameters.
|
|
checkOutput("pkg/TypeParameters.html", true,
|
|
"""
|
|
<dl class="notes">
|
|
<dt>All Implemented Interfaces:</dt>
|
|
<dd><code><a href="SubInterface.html" title="interface in pkg">SubInterface</a>&\
|
|
lt;E></code>, <code><a href="SuperInterface.html" title="interface in pkg">Su\
|
|
perInterface</a><E></code></dd>
|
|
</dl>""");
|
|
|
|
checkOutput("pkg/SuperInterface.html", true,
|
|
"""
|
|
<dl class="notes">
|
|
<dt>All Known Subinterfaces:</dt>
|
|
<dd><code><a href="SubInterface.html" title="interface in pkg">SubInterface</a><V></code></dd>
|
|
</dl>""");
|
|
checkOutput("pkg/SubInterface.html", true,
|
|
"""
|
|
<dl class="notes">
|
|
<dt>All Superinterfaces:</dt>
|
|
<dd><code><a href="SuperInterface.html" title="interface in pkg">SuperInterface</a><V></code></dd>
|
|
</dl>""");
|
|
|
|
//==============================================================
|
|
// Handle multiple bounds.
|
|
//==============================================================
|
|
checkOutput("pkg/MultiTypeParameters.html", true,
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public</span> <span c\
|
|
lass="type-parameters"><T extends java.lang.Number & java.lang.Runnable&g\
|
|
t;</span>
|
|
<span class="return-type">T</span> <span class="element-name">foo</span>​<spa\
|
|
n class="parameters">(T t)</span></div>""");
|
|
|
|
//==============================================================
|
|
// Test Class-Use Documentation for Type Parameters.
|
|
//==============================================================
|
|
// ClassUseTest1: <T extends Foo & Foo2>
|
|
checkOutput("pkg2/class-use/Foo.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a> with type p\
|
|
arameters of type <a href="../Foo.html" title="class in pkg2">Foo</a></span></\
|
|
div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest1.html" title="class in pkg2">ClassUseTest1</a><T extends <a\
|
|
href="../Foo.html" title="class in pkg2">Foo</a> & <a href="../Foo2.html"\
|
|
title="interface in pkg2">Foo2</a>></span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo.html" title="class in pkg2">Foo<\
|
|
/a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest1.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest1.html#metho\
|
|
d(T)">method</a></span>​(T t)</code></div>""",
|
|
"""
|
|
<div class="caption"><span>Fields in <a href="../package-summary.html">pkg2</a>\
|
|
with type parameters of type <a href="../Foo.html" title="class in pkg2">Foo</a\
|
|
></span></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><a href="../ParamTest.html" title="class\
|
|
in pkg2">ParamTest</a><<a href="../Foo.html" title="class in pkg2">Foo</a>&g\
|
|
t;</code></div>"""
|
|
);
|
|
|
|
checkOutput("pkg2/class-use/ParamTest.html", true,
|
|
"""
|
|
<div class="caption"><span>Fields in <a href="../package-summary.html">pkg2</a>\
|
|
declared as <a href="../ParamTest.html" title="class in pkg2">ParamTest</a></s\
|
|
pan></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><a href="../ParamTest.html" title="class\
|
|
in pkg2">ParamTest</a><<a href="../Foo.html" title="class in pkg2">Foo</a>&\
|
|
gt;</code></div>"""
|
|
);
|
|
|
|
checkOutput("pkg2/class-use/Foo2.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo2.html" title="interface in pkg2"\
|
|
>Foo2</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest1.html" title="class in pkg2">ClassUseTest1</a><T extends <a\
|
|
href="../Foo.html" title="class in pkg2">Foo</a> & <a href="../Foo2.html"\
|
|
title="interface in pkg2">Foo2</a>></span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo2.html" title="interface in pkg2"\
|
|
>Foo2</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest1.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest1.html#metho\
|
|
d(T)">method</a></span>​(T t)</code></div>"""
|
|
);
|
|
|
|
// ClassUseTest2: <T extends ParamTest<Foo3>>
|
|
checkOutput("pkg2/class-use/ParamTest.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../ParamTest.html" title="class in pkg2\
|
|
">ParamTest</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest2.html" title="class in pkg2">ClassUseTest2</a><T extends <a\
|
|
href="../ParamTest.html" title="class in pkg2">ParamTest</a><<a href="../Fo\
|
|
o3.html" title="class in pkg2">Foo3</a>>></span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../ParamTest.html" title="class in pkg2\
|
|
">ParamTest</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest2.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest2.html#metho\
|
|
d(T)">method</a></span>​(T t)</code></div>""",
|
|
"""
|
|
<div class="caption"><span>Fields in <a href="../package-summary.html">pkg2</a>\
|
|
declared as <a href="../ParamTest.html" title="class in pkg2">ParamTest</a></s\
|
|
pan></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><a href="../ParamTest.html" title="class\
|
|
in pkg2">ParamTest</a><<a href="../Foo.html" title="class in pkg2">Foo</a>&\
|
|
gt;</code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../ParamTest.html" title="class in pkg2\
|
|
">ParamTest</a></span></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><T extends <a href="../ParamTest.html\
|
|
" title="class in pkg2">ParamTest</a><<a href="../Foo3.html" title="class in\
|
|
pkg2">Foo3</a>>><br><a href="../ParamTest.html" title="class in pkg2">Pa\
|
|
ramTest</a><<a href="../Foo3.html" title="class in pkg2">Foo3</a>></code>\
|
|
</div>"""
|
|
);
|
|
|
|
checkOutput("pkg2/class-use/Foo3.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo3.html" title="class in pkg2">Foo\
|
|
3</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest2.html" title="class in pkg2">ClassUseTest2</a><T extends <a\
|
|
href="../ParamTest.html" title="class in pkg2">ParamTest</a><<a href="../Fo\
|
|
o3.html" title="class in pkg2">Foo3</a>>></span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo3.html" title="class in pkg2">Foo\
|
|
3</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest2.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest2.html#metho\
|
|
d(T)">method</a></span>​(T t)</code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> that return types with arguments of type <a href="../Foo3.html" title="class\
|
|
in pkg2">Foo3</a></span></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><T extends <a href="../ParamTest.html\
|
|
" title="class in pkg2">ParamTest</a><<a href="../Foo3.html" title="class in\
|
|
pkg2">Foo3</a>>><br><a href="../ParamTest.html" title="class in pkg2">Pa\
|
|
ramTest</a><<a href="../Foo3.html" title="class in pkg2">Foo3</a>></code>\
|
|
</div>"""
|
|
);
|
|
|
|
// ClassUseTest3: <T extends ParamTest2<List<? extends Foo4>>>
|
|
checkOutput("pkg2/class-use/ParamTest2.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../ParamTest2.html" title="class in pkg\
|
|
2">ParamTest2</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest3.html" title="class in pkg2">ClassUseTest3</a><T extends <a\
|
|
href="../ParamTest2.html" title="class in pkg2">ParamTest2</a><java.util.Li\
|
|
st<? extends <a href="../Foo4.html" title="class in pkg2">Foo4</a>>>&g\
|
|
t;</span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../ParamTest2.html" title="class in pkg\
|
|
2">ParamTest2</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest3.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest3.html#metho\
|
|
d(T)">method</a></span>​(T t)</code></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><T extends <a href="../ParamTest2.htm\
|
|
l" title="class in pkg2">ParamTest2</a><java.util.List<? extends <a href=\
|
|
"../Foo4.html" title="class in pkg2">Foo4</a>>>><br><a href="../ParamT\
|
|
est2.html" title="class in pkg2">ParamTest2</a><java.util.List<? extends\
|
|
<a href="../Foo4.html" title="class in pkg2">Foo4</a>>></code></div>"""
|
|
);
|
|
|
|
checkOutput("pkg2/class-use/Foo4.html", true,
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo4.html" title="class in pkg2">Foo\
|
|
4</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><code><span class="member-name-link"><a href=\
|
|
"../ClassUseTest3.html" title="class in pkg2">ClassUseTest3</a><T extends <a\
|
|
href="../ParamTest2.html" title="class in pkg2">ParamTest2</a><java.util.Li\
|
|
st<? extends <a href="../Foo4.html" title="class in pkg2">Foo4</a>>>&g\
|
|
t;</span></code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> with type parameters of type <a href="../Foo4.html" title="class in pkg2">Foo\
|
|
4</a></span></div>""",
|
|
"""
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest3.\
|
|
</span><code><span class="member-name-link"><a href="../ClassUseTest3.html#met\
|
|
hod(T)">method</a></span>​(T t)</code></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg2</a\
|
|
> that return types with arguments of type <a href="../Foo4.html" title="class\
|
|
in pkg2">Foo4</a></span></div>""",
|
|
"""
|
|
<div class="col-first even-row-color"><code><T extends <a href="../ParamTest2.html" title="class in pkg2">ParamTest2</a><java.util.List<? extends <a href="../Foo4.html" title="class in pkg2">Foo4</a>>>><br><a href="../ParamTest2.html" title="class in pkg2">ParamTest2</a><java.util.List<? extends <a href="../Foo4.html" title="class in pkg2">Foo4</a>>></code></div>"""
|
|
);
|
|
|
|
// Type parameters in constructor and method args
|
|
checkOutput("pkg2/class-use/Foo4.html", true,
|
|
"""
|
|
<div class="caption"><span>Method parameters in <a href="../package-summary.htm\
|
|
l">pkg2</a> with type arguments of type <a href="../Foo4.html" title="class in\
|
|
pkg2">Foo4</a></span></div>
|
|
<div class="summary-table three-column-summary">
|
|
<div class="table-header col-first">Modifier and Type</div>
|
|
<div class="table-header col-second">Method</div>
|
|
<div class="table-header col-last">Description</div>
|
|
<div class="col-first even-row-color"><code>void</code></div>
|
|
<div class="col-second even-row-color"><span class="type-name-label">ClassUseTest3.<\
|
|
/span><code><span class="member-name-link"><a href="../ClassUseTest3.html#metho\
|
|
d(java.util.Set)">method</a></span>​(java.util.Set<<a href="../Foo4.ht\
|
|
ml" title="class in pkg2">Foo4</a>> p)</code></div>
|
|
<div class="col-last even-row-color"> </div>""",
|
|
"""
|
|
<div class="caption"><span>Constructor parameters in <a href="../package-summary.html">pkg2<\
|
|
/a> with type arguments of type <a href="../Foo4.html" title="class in pkg2">Foo\
|
|
4</a></span></div>"""
|
|
);
|
|
|
|
//=================================
|
|
// TYPE PARAMETER IN INDEX
|
|
//=================================
|
|
checkOutput("index-all.html", true,
|
|
"""
|
|
<span class="member-name-link"><a href="pkg2/Foo.html#method(java.util.Vector)">method(Vector<Object>)</a></span>"""
|
|
);
|
|
|
|
// TODO: duplicate of previous case; left in delibarately for now to simplify comparison testing
|
|
//=================================
|
|
// TYPE PARAMETER IN INDEX
|
|
//=================================
|
|
checkOutput("index-all.html", true,
|
|
"""
|
|
<span class="member-name-link"><a href="pkg2/Foo.html#method(java.util.Vector)">method(Vector<Object>)</a></span>"""
|
|
);
|
|
|
|
}
|
|
|
|
//=================================
|
|
// VAR ARG TESTING
|
|
//=================================
|
|
void checkVarArgs() {
|
|
checkOutput("pkg/VarArgs.html", true,
|
|
"(int... i)",
|
|
"(int[][]... i)",
|
|
"(int[]...)",
|
|
"""
|
|
<a href="TypeParameters.html" title="class in pkg">TypeParameters</a>... t""");
|
|
}
|
|
|
|
//=================================
|
|
// ANNOTATION TYPE TESTING
|
|
//=================================
|
|
void checkAnnotationTypes() {
|
|
checkOutput("pkg/AnnotationType.html", true,
|
|
// Make sure the summary links are correct.
|
|
"""
|
|
<li>Summary: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#annotation.type.required.element.summary">Required</a> | </li>
|
|
<li><a href="#annotation.type.optional.element.summary">Optional</a></li>""",
|
|
// Make sure the detail links are correct.
|
|
"""
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#annotation.type.element.detail">Element</a></li>""",
|
|
// Make sure the heading is correct.
|
|
"Annotation Type AnnotationType</h2>",
|
|
// Make sure the signature is correct.
|
|
"""
|
|
public @interface <span class="member-name-label">AnnotationType</span>""",
|
|
// Make sure member summary headings are correct.
|
|
"<h3>Required Element Summary</h3>",
|
|
"<h3>Optional Element Summary</h3>",
|
|
// Make sure element detail heading is correct
|
|
"Element Detail",
|
|
// Make sure default annotation type value is printed when necessary.
|
|
"""
|
|
<dl>
|
|
<dt>Default:</dt>
|
|
<dd>"unknown"</dd>
|
|
</dl>""");
|
|
}
|
|
|
|
//=================================
|
|
// ANNOTATION TYPE USAGE TESTING
|
|
//=================================
|
|
void checkAnnotationTypeUsage() {
|
|
checkOutput("pkg/package-summary.html", true,
|
|
// PACKAGE
|
|
"""
|
|
<a href="AnnotationType.html" title="annotation in pkg">@AnnotationType</a>(<a h\
|
|
ref="AnnotationType.html#optional()">optional</a>="Package Annotation",
|
|
<a href="AnnotationType.html#required()">required</a>=1994)""");
|
|
|
|
checkOutput("pkg/AnnotationTypeUsage.html", true,
|
|
// CLASS
|
|
"""
|
|
<div class="type-signature"><span class="annotations"><a href="AnnotationType.ht\
|
|
ml" title="annotation in pkg">@AnnotationType</a>(<a href="AnnotationType.html#o\
|
|
ptional()">optional</a>="Class Annotation",
|
|
<a href="AnnotationType.html#required()">required</a>=1994)
|
|
</span><span class="modifiers">public class </span><span class="element-name type-name-l\
|
|
abel">AnnotationTypeUsage</span>
|
|
<span class="extends-implements">extends java.lang.Object</span></div>""",
|
|
// FIELD
|
|
"""
|
|
<div class="member-signature"><span class="annotations"><a href="AnnotationType.\
|
|
html" title="annotation in pkg">@AnnotationType</a>(<a href="AnnotationType.html\
|
|
#optional()">optional</a>="Field Annotation",
|
|
<a href="AnnotationType.html#required()">required</a>=1994)
|
|
</span><span class="modifiers">public</span> <span class="return-type">int<\
|
|
/span> <span class="element-name">field</span></div>""",
|
|
// CONSTRUCTOR
|
|
"""
|
|
<div class="member-signature"><span class="annotations"><a href="AnnotationType.\
|
|
html" title="annotation in pkg">@AnnotationType</a>(<a href="AnnotationType.html\
|
|
#optional()">optional</a>="Constructor Annotation",
|
|
<a href="AnnotationType.html#required()">required</a>=1994)
|
|
</span><span class="modifiers">public</span> <span class="element-name">AnnotationTypeUsage</span>()</div>""",
|
|
// METHOD
|
|
"""
|
|
<div class="member-signature"><span class="annotations"><a href="AnnotationType.\
|
|
html" title="annotation in pkg">@AnnotationType</a>(<a href="AnnotationType.html\
|
|
#optional()">optional</a>="Method Annotation",
|
|
<a href="AnnotationType.html#required()">required</a>=1994)
|
|
</span><span class="modifiers">public</span> <span class="return-type">void\
|
|
</span> <span class="element-name">method</span>()</div>""",
|
|
// METHOD PARAMS
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public</span> <span c\
|
|
lass="return-type">void</span> <span class="element-name">methodWithParams</span>&#\
|
|
8203;<span class="parameters">(<a href="AnnotationType.html" title="annotation i\
|
|
n pkg">@AnnotationType</a>(<a href="AnnotationType.html#optional()">optional</a>\
|
|
="Parameter Annotation",<a href="AnnotationType.html#required()">required</a>=19\
|
|
94)
|
|
int documented,
|
|
int undocmented)</span></div>""",
|
|
// CONSTRUCTOR PARAMS
|
|
"""
|
|
<div class="member-signature"><span class="modifiers">public</span> <span c\
|
|
lass="element-name">AnnotationTypeUsage</span>​<span class="parameters">(<\
|
|
a href="AnnotationType.html" title="annotation in pkg">@AnnotationType</a>(<a hr\
|
|
ef="AnnotationType.html#optional()">optional</a>="Constructor Param Annotation",\
|
|
<a href="AnnotationType.html#required()">required</a>=1994)
|
|
int documented,
|
|
int undocmented)</span></div>""");
|
|
|
|
//=================================
|
|
// Annotatation Type Usage
|
|
//=================================
|
|
checkOutput("pkg/class-use/AnnotationType.html", true,
|
|
"""
|
|
<div class="caption"><span>Packages with annotations of type <a href="../Annotat\
|
|
ionType.html" title="annotation in pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Classes in <a href="../package-summary.html">pkg</a>\
|
|
with annotations of type <a href="../AnnotationType.html" title="annotation in\
|
|
pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Fields in <a href="../package-summary.html">pkg</a>\
|
|
with annotations of type <a href="../AnnotationType.html" title="annotation in\
|
|
pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Methods in <a href="../package-summary.html">pkg</a>\
|
|
with annotations of type <a href="../AnnotationType.html" title="annotation in\
|
|
pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Method parameters in <a href="../package-summary.htm\
|
|
l">pkg</a> with annotations of type <a href="../AnnotationType.html" title="ann\
|
|
otation in pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Constructors in <a href="../package-summary.html">pk\
|
|
g</a> with annotations of type <a href="../AnnotationType.html" title="annotati\
|
|
on in pkg">AnnotationType</a></span></div>""",
|
|
"""
|
|
<div class="caption"><span>Constructor parameters in <a href="../package-summar\
|
|
y.html">pkg</a> with annotations of type <a href="../AnnotationType.html" title\
|
|
="annotation in pkg">AnnotationType</a></span></div>"""
|
|
);
|
|
|
|
//==============================================================
|
|
// ANNOTATION TYPE USAGE TESTING (When @Documented is omitted)
|
|
//===============================================================
|
|
checkOutput("pkg/AnnotationTypeUsage.html", false,
|
|
// CLASS
|
|
"""
|
|
<a href="AnnotationTypeUndocumented.html" title="annotation in pkg">@AnnotationT\
|
|
ypeUndocumented</a>(<a href="AnnotationType.html#optional">optional</a>="Class A\
|
|
nnotation",
|
|
<a href="AnnotationType.html#required">required</a>=1994)
|
|
public class <span class="type-name-label">AnnotationTypeUsage</span></dt><dt>extends java.lang.Object</dt>""",
|
|
// FIELD
|
|
"""
|
|
<a href="AnnotationTypeUndocumented.html" title="annotation in pkg">@AnnotationT\
|
|
ypeUndocumented</a>(<a href="AnnotationType.html#optional">optional</a>="Field A\
|
|
nnotation",
|
|
<a href="AnnotationType.html#required">required</a>=1994)
|
|
public int <span class="member-name-label">field</span>""",
|
|
// CONSTRUCTOR
|
|
"""
|
|
<a href="AnnotationTypeUndocumented.html" title="annotation in pkg">@AnnotationT\
|
|
ypeUndocumented</a>(<a href="AnnotationType.html#optional">optional</a>="Constru\
|
|
ctor Annotation",
|
|
<a href="AnnotationType.html#required">required</a>=1994)
|
|
public <span class="type-name-label">AnnotationTypeUsage</span>()""",
|
|
// METHOD
|
|
"""
|
|
<a href="AnnotationTypeUndocumented.html" title="annotation in pkg">@AnnotationT\
|
|
ypeUndocumented</a>(<a href="AnnotationType.html#optional">optional</a>="Method \
|
|
Annotation",
|
|
<a href="AnnotationType.html#required">required</a>=1994)
|
|
public void <span class="member-name-label">method</span>()""");
|
|
|
|
//=================================
|
|
// Make sure annotation types do not
|
|
// trigger this warning.
|
|
//=================================
|
|
checkOutput(Output.OUT, false,
|
|
"Internal error: package sets don't match: [] with: null");
|
|
|
|
//=================================
|
|
// ANNOTATION TYPE USAGE TESTING (All Different Types).
|
|
//=================================
|
|
checkOutput("pkg1/B.html", true,
|
|
// Integer
|
|
"<a href=\"A.html#d()\">d</a>=3.14,",
|
|
// Double
|
|
"<a href=\"A.html#d()\">d</a>=3.14,",
|
|
// Boolean
|
|
"<a href=\"A.html#b()\">b</a>=true,",
|
|
// String
|
|
"""
|
|
<a href="A.html#s()">s</a>="sigh",""",
|
|
// Class
|
|
"""
|
|
<a href="A.html#c()">c</a>=<a href="../pkg2/Foo.html" title="class in pkg2">Foo.class</a>,""",
|
|
// Bounded Class
|
|
"""
|
|
<a href="A.html#w()">w</a>=<a href="../pkg/TypeParameterSubClass.html" title="cl\
|
|
ass in pkg">TypeParameterSubClass.class</a>,""",
|
|
// Enum
|
|
"""
|
|
<a href="A.html#e()">e</a>=<a href="../pkg/Coin.html#Penny">Penny</a>,""",
|
|
// Annotation Type
|
|
"""
|
|
<a href="A.html#a()">a</a>=<a href="../pkg/AnnotationType.html" title="annotatio\
|
|
n in pkg">@AnnotationType</a>(<a href="../pkg/AnnotationType.html#optional()">op\
|
|
tional</a>="foo",<a href="../pkg/AnnotationType.html#required()">required</a>=19\
|
|
94),""",
|
|
// String Array
|
|
"""
|
|
<a href="A.html#sa()">sa</a>={"up","down"},""",
|
|
// Primitive
|
|
"""
|
|
<a href="A.html#primitiveClassTest()">primitiveClassTest</a>=boolean.class,""");
|
|
|
|
// XXX: Add array test case after this if fixed:
|
|
//5020899: Incorrect internal representation of class-valued annotation elements
|
|
checkOutput("pkg1/B.html", true,
|
|
"""
|
|
<div class="type-signature"><span class="annotations"><a href="A.html" title="annotation in pkg1">@A</a>""",
|
|
"""
|
|
<span class="modifiers">public interface </span><span class="element-name type-name-label">B</span></div>""");
|
|
|
|
}
|
|
}
|