329 lines
18 KiB
Java
329 lines
18 KiB
Java
/*
|
|
* Copyright (c) 2012, 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 7112427 8012295 8025633 8026567 8061305 8081854 8150130 8162363
|
|
* 8167967 8172528 8175200 8178830 8182257 8186332 8182765 8025091
|
|
* 8203791 8184205
|
|
* @summary Test of the JavaFX doclet features.
|
|
* @library ../../lib
|
|
* @modules jdk.javadoc/jdk.javadoc.internal.tool
|
|
* @build javadoc.tester.*
|
|
* @run main TestJavaFX
|
|
*/
|
|
|
|
import javadoc.tester.JavadocTester;
|
|
|
|
public class TestJavaFX extends JavadocTester {
|
|
|
|
public static void main(String... args) throws Exception {
|
|
TestJavaFX tester = new TestJavaFX();
|
|
tester.runTests();
|
|
}
|
|
|
|
@Test
|
|
public void test1() {
|
|
javadoc("-d", "out1",
|
|
"-sourcepath", testSrc,
|
|
"-javafx",
|
|
"--disable-javafx-strict-checks",
|
|
"-package",
|
|
"pkg1");
|
|
checkExit(Exit.OK);
|
|
|
|
checkOutput("pkg1/C.html", true,
|
|
"<dt>See Also:</dt>\n"
|
|
+ "<dd><a href=\"#getRate()\"><code>getRate()</code></a>, \n"
|
|
+ "<a href=\"#setRate(double)\"><code>setRate(double)</code></a></dd>",
|
|
"<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">void</span> <span class=\"memberName\">setRate</span>​"
|
|
+ "(<span class=\"arguments\">double value)</span></div>\n"
|
|
+ "<div class=\"block\">Sets the value of the property rate.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>",
|
|
"<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">double</span> <span class=\"memberName\">getRate</span>()</div>\n"
|
|
+ "<div class=\"block\">Gets the value of the property rate.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>",
|
|
"<td class=\"colFirst\"><code><a href=\"C.DoubleProperty.html\" "
|
|
+ "title=\"class in pkg1\">C.DoubleProperty</a></code></td>\n"
|
|
+ "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#rateProperty\">rate</a></span></code></th>\n"
|
|
+ "<td class=\"colLast\">\n"
|
|
+ "<div class=\"block\">Defines the direction/speed at which the "
|
|
+ "<code>Timeline</code> is expected to\n"
|
|
+ " be played.</div>\n</td>",
|
|
"<dt>Default value:</dt>",
|
|
"<dt>Since:</dt>\n"
|
|
+ "<dd>JavaFX 8.0</dd>",
|
|
"<p>Sets the value of the property <code>Property</code>",
|
|
"<p>Gets the value of the property <code>Property</code>",
|
|
"<dt>Property description:</dt>",
|
|
"<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#setTestMethodProperty()\">"
|
|
+ "setTestMethodProperty</a></span>()</code></th>",
|
|
"<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#pausedProperty\">paused</a></span></code></th>\n"
|
|
+ "<td class=\"colLast\">\n"
|
|
+ "<div class=\"block\">Defines if paused.</div>",
|
|
"<section class=\"detail\" id=\"pausedProperty\">\n"
|
|
+ "<h3>paused</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\"><a href=\"C.BooleanProperty.html\" title=\"class in pkg1\">"
|
|
+ "C.BooleanProperty</a></span> <span class=\"memberName\">pausedProperty</span></div>\n"
|
|
+ "<div class=\"block\">Defines if paused. The second line.</div>",
|
|
"<section class=\"detail\" id=\"isPaused()\">\n"
|
|
+ "<h3>isPaused</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">double</span> <span class=\"memberName\">isPaused</span>()</div>\n"
|
|
+ "<div class=\"block\">Gets the value of the property paused.</div>",
|
|
"<section class=\"detail\" id=\"setPaused(boolean)\">\n"
|
|
+ "<h3>setPaused</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">void</span> <span class=\"memberName\">setPaused</span>​"
|
|
+ "(<span class=\"arguments\">boolean value)</span></div>\n"
|
|
+ "<div class=\"block\">Sets the value of the property paused.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>\n"
|
|
+ "<dd>Defines if paused. The second line.</dd>\n"
|
|
+ "<dt>Default value:</dt>\n"
|
|
+ "<dd>false</dd>",
|
|
"<section class=\"detail\" id=\"isPaused()\">\n"
|
|
+ "<h3>isPaused</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">double</span> <span class=\"memberName\">isPaused</span>()</div>\n"
|
|
+ "<div class=\"block\">Gets the value of the property paused.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>\n"
|
|
+ "<dd>Defines if paused. The second line.</dd>\n"
|
|
+ "<dt>Default value:</dt>\n"
|
|
+ "<dd>false</dd>",
|
|
"<section class=\"detail\" id=\"rateProperty\">\n"
|
|
+ "<h3>rate</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\"><a href=\"C.DoubleProperty.html\" title=\"class in pkg1\">"
|
|
+ "C.DoubleProperty</a></span> <span class=\"memberName\">rateProperty</span></div>\n"
|
|
+ "<div class=\"block\">Defines the direction/speed at which the "
|
|
+ "<code>Timeline</code> is expected to\n"
|
|
+ " be played. This is the second line.</div>",
|
|
"<section class=\"detail\" id=\"setRate(double)\">\n"
|
|
+ "<h3>setRate</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">void</span> <span class=\"memberName\">setRate</span>​"
|
|
+ "(<span class=\"arguments\">double value)</span></div>\n"
|
|
+ "<div class=\"block\">Sets the value of the property rate.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>\n"
|
|
+ "<dd>Defines the direction/speed at which the <code>Timeline</code> is expected to\n"
|
|
+ " be played. This is the second line.</dd>\n"
|
|
+ "<dt>Default value:</dt>\n"
|
|
+ "<dd>11</dd>\n"
|
|
+ "<dt>Since:</dt>\n"
|
|
+ "<dd>JavaFX 8.0</dd>",
|
|
"<section class=\"detail\" id=\"getRate()\">\n"
|
|
+ "<h3>getRate</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">double</span> <span class=\"memberName\">getRate</span>()</div>\n"
|
|
+ "<div class=\"block\">Gets the value of the property rate.</div>\n"
|
|
+ "<dl class=\"notes\">\n"
|
|
+ "<dt>Property description:</dt>\n"
|
|
+ "<dd>Defines the direction/speed at which the <code>Timeline</code> is expected to\n"
|
|
+ " be played. This is the second line.</dd>\n"
|
|
+ "<dt>Default value:</dt>\n"
|
|
+ "<dd>11</dd>\n"
|
|
+ "<dt>Since:</dt>\n"
|
|
+ "<dd>JavaFX 8.0</dd>",
|
|
"<section class=\"propertySummary\" id=\"property.summary\">\n"
|
|
+ "<h2>Property Summary</h2>\n"
|
|
+ "<div class=\"memberSummary\">\n<table>\n"
|
|
+ "<caption><span>Properties</span><span class=\"tabEnd\"> </span></caption>",
|
|
"<tr class=\"altColor\">\n"
|
|
+ "<td class=\"colFirst\"><code><a href=\"C.BooleanProperty.html\" title=\"class in pkg1\">C.BooleanProperty</a></code></td>\n",
|
|
"<tr class=\"rowColor\">\n"
|
|
+ "<td class=\"colFirst\"><code><a href=\"C.DoubleProperty.html\" title=\"class in pkg1\">C.DoubleProperty</a></code></td>\n");
|
|
|
|
checkOutput("pkg1/C.html", false,
|
|
"A()",
|
|
"<h2 id=\"property.summary\">Property Summary</h2>\n"
|
|
+ "<div class=\"memberSummary\">\n"
|
|
+ "<div role=\"tablist\" aria-orientation=\"horizontal\"><button role=\"tab\""
|
|
+ " aria-selected=\"true\" aria-controls=\"memberSummary_tabpanel\" tabindex=\"0\""
|
|
+ " onkeydown=\"switchTab(event)\" id=\"t0\" class=\"activeTableTab\">All Methods"
|
|
+ "</button><button role=\"tab\" aria-selected=\"false\""
|
|
+ " aria-controls=\"memberSummary_tabpanel\" tabindex=\"-1\" onkeydown=\"switchTab(event)\""
|
|
+ " id=\"t2\" class=\"tableTab\" onclick=\"show(2);\">Instance Methods</button>"
|
|
+ "<button role=\"tab\" aria-selected=\"false\" aria-controls=\"memberSummary_tabpanel\""
|
|
+ " tabindex=\"-1\" onkeydown=\"switchTab(event)\" id=\"t4\" class=\"tableTab\""
|
|
+ " onclick=\"show(8);\">Concrete Methods</button></div>",
|
|
"<tr id=\"i0\" class=\"altColor\">\n"
|
|
+ "<td class=\"colFirst\"><code><a href=\"C.BooleanProperty.html\" title=\"class in pkg1\">C.BooleanProperty</a></code></td>\n",
|
|
"<tr id=\"i1\" class=\"rowColor\">\n"
|
|
+ "<td class=\"colFirst\"><code><a href=\"C.DoubleProperty.html\" title=\"class in pkg1\">C.DoubleProperty</a></code></td>\n");
|
|
|
|
checkOutput("index-all.html", true,
|
|
"<div class=\"block\">Gets the value of the property paused.</div>",
|
|
"<div class=\"block\">Defines if paused.</div>");
|
|
|
|
checkOutput("pkg1/D.html", true,
|
|
"<h3 id=\"properties.inherited.from.class.pkg1.C\">Properties inherited from class pkg1."
|
|
+ "<a href=\"C.html\" title=\"class in pkg1\">C</a></h3>\n"
|
|
+ "<code><a href=\"C.html#pausedProperty\">"
|
|
+ "paused</a>, <a href=\"C.html#rateProperty\">rate</a></code></div>");
|
|
|
|
checkOutput("pkg1/D.html", false, "shouldNotAppear");
|
|
}
|
|
|
|
/*
|
|
* Test with -javafx option enabled, to ensure property getters and setters
|
|
* are treated correctly.
|
|
*/
|
|
@Test
|
|
public void test2() {
|
|
javadoc("-d", "out2a",
|
|
"-sourcepath", testSrc,
|
|
"-javafx",
|
|
"--disable-javafx-strict-checks",
|
|
"-package",
|
|
"pkg2");
|
|
checkExit(Exit.OK);
|
|
checkOutput("pkg2/Test.html", true,
|
|
"<section class=\"propertyDetails\" id=\"property.detail\">\n"
|
|
+ "<h2>Property Details</h2>\n"
|
|
+ "<ul class=\"blockList\">\n"
|
|
+ "<li class=\"blockList\">\n"
|
|
+ "<section class=\"detail\" id=\"betaProperty\">\n"
|
|
+ "<h3>beta</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public</span> "
|
|
+ "<span class=\"returnType\">java.lang.Object</span>"
|
|
+ " <span class=\"memberName\">betaProperty</span></div>\n"
|
|
+ "</section>\n"
|
|
+ "</li>\n"
|
|
+ "<li class=\"blockList\">\n"
|
|
+ "<section class=\"detail\" id=\"gammaProperty\">\n"
|
|
+ "<h3>gamma</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">java.util.List<java.lang.String></span>"
|
|
+ " <span class=\"memberName\">gammaProperty</span></div>\n"
|
|
+ "</section>\n"
|
|
+ "</li>\n"
|
|
+ "<li class=\"blockList\">\n"
|
|
+ "<section class=\"detail\" id=\"deltaProperty\">\n"
|
|
+ "<h3>delta</h3>\n"
|
|
+ "<div class=\"memberSignature\"><span class=\"modifiers\">public final</span> "
|
|
+ "<span class=\"returnType\">java.util.List<java.util.Set<? super java.lang.Object>>"
|
|
+ "</span> <span class=\"memberName\">deltaProperty</span></div>\n"
|
|
+ "</section>\n"
|
|
+ "</li>\n"
|
|
+ "</ul>\n"
|
|
+ "</section>",
|
|
"<section class=\"propertySummary\" id=\"property.summary\">\n"
|
|
+ "<h2>Property Summary</h2>\n"
|
|
+ "<div class=\"memberSummary\">\n<table>\n"
|
|
+ "<caption><span>Properties</span><span class=\"tabEnd\"> </span></caption>");
|
|
|
|
checkOutput("pkg2/Test.html", false,
|
|
"<h2>Property Summary</h2>\n"
|
|
+ "<div class=\"memberSummary\">\n"
|
|
+ "<div role=\"tablist\" aria-orientation=\"horizontal\"><button role=\"tab\""
|
|
+ " aria-selected=\"true\" aria-controls=\"memberSummary_tabpanel\" tabindex=\"0\""
|
|
+ " onkeydown=\"switchTab(event)\" id=\"t0\" class=\"activeTableTab\">All Methods"
|
|
+ "</button><button role=\"tab\" aria-selected=\"false\""
|
|
+ " aria-controls=\"memberSummary_tabpanel\" tabindex=\"-1\" onkeydown=\"switchTab(event)\""
|
|
+ " id=\"t2\" class=\"tableTab\" onclick=\"show(2);\">Instance Methods</button>"
|
|
+ "<button role=\"tab\" aria-selected=\"false\" aria-controls=\"memberSummary_tabpanel\""
|
|
+ " tabindex=\"-1\" onkeydown=\"switchTab(event)\" id=\"t4\" class=\"tableTab\""
|
|
+ " onclick=\"show(8);\">Concrete Methods</button></div>");
|
|
}
|
|
|
|
/*
|
|
* Test without -javafx option, to ensure property getters and setters
|
|
* are treated just like any other java method.
|
|
*/
|
|
@Test
|
|
public void test3() {
|
|
javadoc("-d", "out2b",
|
|
"-sourcepath", testSrc,
|
|
"-package",
|
|
"pkg2");
|
|
checkExit(Exit.OK);
|
|
checkOutput("pkg2/Test.html", false, "<h2>Property Summary</h2>");
|
|
checkOutput("pkg2/Test.html", true,
|
|
"<thead>\n"
|
|
+ "<tr>\n"
|
|
+ "<th class=\"colFirst\" scope=\"col\">Modifier and Type</th>\n"
|
|
+ "<th class=\"colSecond\" scope=\"col\">Method</th>\n"
|
|
+ "<th class=\"colLast\" scope=\"col\">Description</th>\n"
|
|
+ "</tr>\n"
|
|
+ "</thead>\n"
|
|
+ "<tbody>\n"
|
|
+ "<tr class=\"altColor\" id=\"i0\">\n"
|
|
+ "<td class=\"colFirst\"><code><T> java.lang.Object</code></td>\n"
|
|
+ "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#alphaProperty(java.util.List)\">alphaProperty</a>"
|
|
+ "</span>​(java.util.List<T> foo)</code></th>\n"
|
|
+ "<td class=\"colLast\"> </td>\n"
|
|
+ "</tr>\n"
|
|
+ "<tr class=\"rowColor\" id=\"i1\">\n"
|
|
+ "<td class=\"colFirst\"><code>java.lang.Object</code></td>\n"
|
|
+ "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#betaProperty()\">betaProperty</a></span>()</code></th>\n"
|
|
+ "<td class=\"colLast\"> </td>\n"
|
|
+ "</tr>\n"
|
|
+ "<tr class=\"altColor\" id=\"i2\">\n"
|
|
+ "<td class=\"colFirst\"><code>java.util.List<java.util.Set<? super java.lang.Object>>"
|
|
+ "</code></td>\n"
|
|
+ "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#deltaProperty()\">deltaProperty</a></span>()</code></th>\n"
|
|
+ "<td class=\"colLast\"> </td>\n"
|
|
+ "</tr>\n"
|
|
+ "<tr class=\"rowColor\" id=\"i3\">\n"
|
|
+ "<td class=\"colFirst\"><code>java.util.List<java.lang.String></code></td>\n"
|
|
+ "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">"
|
|
+ "<a href=\"#gammaProperty()\">gammaProperty</a></span>()</code></th>\n"
|
|
+ "<td class=\"colLast\"> </td>"
|
|
);
|
|
}
|
|
|
|
/*
|
|
* Force the doclet to emit a warning when processing a synthesized,
|
|
* DocComment, and ensure that the run succeeds, using the newer
|
|
* --javafx flag.
|
|
*/
|
|
@Test
|
|
public void test4() {
|
|
javadoc("-d", "out4",
|
|
"--javafx",
|
|
"--disable-javafx-strict-checks",
|
|
"-Xdoclint:none",
|
|
"-sourcepath", testSrc,
|
|
"-package",
|
|
"pkg4");
|
|
checkExit(Exit.OK);
|
|
|
|
// make sure the doclet indeed emits the warning
|
|
checkOutput(Output.OUT, true, "C.java:0: warning - invalid usage of tag >");
|
|
}
|
|
}
|