/* * Copyright (c) 2002, 2018, 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 4638588 4635809 6256068 6270645 8025633 8026567 8162363 8175200 * 8192850 8182765 * @summary Test to make sure that members are inherited properly in the Javadoc. * Verify that inheritance labels are correct. * @author jamieh * @library ../../lib * @modules jdk.javadoc/jdk.javadoc.internal.tool * @build javadoc.tester.* * @run main TestMemberInheritance */ import javadoc.tester.JavadocTester; public class TestMemberInheritance extends JavadocTester { public static void main(String... args) throws Exception { TestMemberInheritance tester = new TestMemberInheritance(); tester.runTests(); } @Test public void test() { javadoc("-d", "out", "-sourcepath", testSrc, "pkg", "diamond", "inheritDist", "pkg1"); checkExit(Exit.OK); checkOutput("pkg/SubClass.html", true, // Public field should be inherited "<a href=\"BaseClass.html#pubField\">", // Public method should be inherited "<a href=\"BaseClass.html#pubMethod()\">", // Public inner class should be inherited. "<a href=\"BaseClass.pubInnerClass.html\" title=\"class in pkg\">", // Protected field should be inherited "<a href=\"BaseClass.html#proField\">", // Protected method should be inherited "<a href=\"BaseClass.html#proMethod()\">", // Protected inner class should be inherited. "<a href=\"BaseClass.proInnerClass.html\" title=\"class in pkg\">", // New labels as of 1.5.0 "Nested classes/interfaces inherited from class pkg." + "<a href=\"BaseClass.html\" title=\"class in pkg\">BaseClass</a>", "Nested classes/interfaces inherited from interface pkg." + "<a href=\"BaseInterface.html\" title=\"interface in pkg\">BaseInterface</a>"); checkOutput("pkg/BaseClass.html", true, // Test overriding/implementing methods with generic parameters. "<dl>\n" + "<dt><span class=\"overrideSpecifyLabel\">Specified by:</span></dt>\n" + "<dd><code><a href=\"BaseInterface.html#getAnnotation(java.lang.Class)\">" + "getAnnotation</a></code> in interface <code>" + "<a href=\"BaseInterface.html\" title=\"interface in pkg\">" + "BaseInterface</a></code></dd>\n" + "</dl>"); checkOutput("diamond/Z.html", true, // Test diamond inheritance member summary (6256068) "<code><a href=\"A.html#aMethod()\">aMethod</a></code>"); checkOutput("inheritDist/C.html", true, // Test that doc is inherited from closed parent (6270645) "<div class=\"block\">m1-B</div>"); checkOutput("pkg/SubClass.html", false, "<a href=\"BaseClass.html#staticMethod()\">staticMethod</a></code>"); checkOutput("pkg1/Implementer.html", true, // ensure the method makes it "<td class=\"colFirst\"><code>static java.time.Period</code></td>\n" + "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">" + "<a href=\"#between(java.time.LocalDate,java.time.LocalDate)\">" + "between</a></span>​(java.time.LocalDate startDateInclusive,\n" + " java.time.LocalDate endDateExclusive)</code></th>"); checkOutput("pkg1/Implementer.html", false, "<h3>Methods inherited from interface pkg1.<a href=\"Interface.html\"" + " title=\"interface in pkg1\">Interface</a></h3>\n" + "<code><a href=\"Interface.html#between(java.time.chrono.ChronoLocalDate" + ",java.time.chrono.ChronoLocalDate)\">between</a></code>" ); } @Test public void test_html4() { javadoc("-d", "out-html4", "-html4", "-sourcepath", testSrc, "pkg", "diamond", "inheritDist", "pkg1"); checkExit(Exit.OK); checkOutput("pkg/SubClass.html", true, // Public method should be inherited "<a href=\"BaseClass.html#pubMethod--\">", // Protected method should be inherited "<a href=\"BaseClass.html#proMethod--\">"); checkOutput("pkg/BaseClass.html", true, // Test overriding/implementing methods with generic parameters. "<dl>\n" + "<dt><span class=\"overrideSpecifyLabel\">Specified by:</span></dt>\n" + "<dd><code><a href=\"BaseInterface.html#getAnnotation-java.lang.Class-\">" + "getAnnotation</a></code> in interface <code>" + "<a href=\"BaseInterface.html\" title=\"interface in pkg\">" + "BaseInterface</a></code></dd>\n" + "</dl>"); checkOutput("diamond/Z.html", true, // Test diamond inheritance member summary (6256068) "<code><a href=\"A.html#aMethod--\">aMethod</a></code>"); checkOutput("pkg/SubClass.html", false, "<a href=\"BaseClass.html#staticMethod--\">staticMethod</a></code>"); checkOutput("pkg1/Implementer.html", true, // ensure the method makes it "<td class=\"colFirst\"><code>static java.time.Period</code></td>\n" + "<th class=\"colSecond\" scope=\"row\"><code><span class=\"memberNameLink\">" + "<a href=\"#between-java.time.LocalDate-java.time.LocalDate-\">" + "between</a></span>​(java.time.LocalDate startDateInclusive,\n" + " java.time.LocalDate endDateExclusive)</code></th>"); checkOutput("pkg1/Implementer.html", false, "<h3>Methods inherited from interface pkg1.<a href=\"Interface.html\"" + " title=\"interface in pkg1\">Interface</a></h3>\n" + "<code><a href=\"Interface.html#between-java.time.chrono.ChronoLocalDate" + "-java.time.chrono.ChronoLocalDate-\">between</a></code>" ); } }