/* * Copyright (c) 2003, 2022, 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 8250768 8261976 8277300 8282452 * @summary test generated docs for items declared using preview * @library ../../lib * @modules jdk.javadoc/jdk.javadoc.internal.tool * jdk.javadoc/jdk.javadoc.internal.doclets.formats.html.resources:+open * @build javadoc.tester.* * @run main TestPreview */ import java.nio.file.Paths; import javadoc.tester.JavadocTester; public class TestPreview extends JavadocTester { public static void main(String... args) throws Exception { TestPreview tester = new TestPreview(); tester.runTests(); } @Test public void testUserJavadoc() { String doc = Paths.get(testSrc, "doc").toUri().toString(); javadoc("-d", "out-user-javadoc", "-XDforcePreview", "--enable-preview", "-source", System.getProperty("java.specification.version"), "--patch-module", "java.base=" + Paths.get(testSrc, "api").toAbsolutePath().toString(), "--add-exports", "java.base/preview=m", "--module-source-path", testSrc, "-linkoffline", doc, doc, "m/pkg"); checkExit(Exit.OK); checkOutput("m/pkg/TestPreviewDeclarationUse.html", true, "TestPreviewDeclaration"); checkOutput("m/pkg/TestPreviewAPIUse.html", true, "CorePREVIEW"); checkOutput("m/pkg/DocAnnotation.html", true, "public @interface DocAnnotation"); checkOutput("m/pkg/DocAnnotationUse1.html", true, "
pkg.DocAnnotationUse1
"); checkOutput("m/pkg/DocAnnotationUse2.html", true, "
pkg.DocAnnotationUse2
"); } @Test public void testPreviewAPIJavadoc() { javadoc("-d", "out-preview-api", "--patch-module", "java.base=" + Paths.get(testSrc, "api").toAbsolutePath().toString(), "--add-exports", "java.base/preview=m", "--source-path", Paths.get(testSrc, "api").toAbsolutePath().toString(), "--show-packages=all", "preview"); checkExit(Exit.OK); checkOutput("preview-list.html", true, """
Record Classes
Record Class
Description
""", """
Methods
Method
Description
Returns the value of the i record component.
"""); } @Test public void test8277300() { javadoc("-d", "out-8277300", "--add-exports", "java.base/jdk.internal.javac=api2", "--source-path", Paths.get(testSrc, "api2").toAbsolutePath().toString(), "--show-packages=all", "api2/api"); checkExit(Exit.OK); checkOutput("api2/api/API.html", true, "

test()

", "

testNoPreviewInSig()

", "title=\"class or interface in java.util\" class=\"external-link\">List<APIPREVIEW>"); checkOutput("api2/api/API2.html", true, "API.test()PREVIEW", "API.testNoPreviewInSig()PREVIEW", "API3.test()PREVIEW"); checkOutput("api2/api/API3.html", true, ""); } @Test public void test8282452() { javadoc("-d", "out-8282452", "--patch-module", "java.base=" + Paths.get(testSrc, "api").toAbsolutePath().toString(), "--add-exports", "java.base/preview=m", "--source-path", Paths.get(testSrc, "api").toAbsolutePath().toString(), "--show-packages=all", "preview"); checkExit(Exit.OK); checkOutput("java.base/preview/NoPreview.html", false, "refers to one or more preview"); } }