/* * Copyright (c) 2010, 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 6851834 * @summary This test verifies the HTML document generation for javadoc output. * @library ../../lib * @modules jdk.javadoc/jdk.javadoc.internal.doclets.formats.html.markup * jdk.javadoc/jdk.javadoc.internal.doclets.toolkit.util * jdk.javadoc/jdk.javadoc.internal.tool * @build javadoc.tester.* * @run main TestHtmlDocument */ import jdk.javadoc.internal.doclets.formats.html.markup.*; /** * The class reads each file, complete with newlines, into a string to easily * compare the existing markup with the generated markup. */ import javadoc.tester.JavadocTester; public class TestHtmlDocument extends JavadocTester { // Entry point public static void main(String... args) throws Exception { var tester = new TestHtmlDocument(); tester.runTests(); } @Test public void test() { checking("markup"); // Check whether the generated markup is same as the existing markup. String expected = readFile(testSrc, "testMarkup.html"); String actual = generateHtmlTree(); if (actual.equals(expected)) { passed(""); } else { failed("expected content in " + testSrc("testMarkup.html") + "\n" + "Actual output:\n" + actual); } } // Generate the HTML output using the HTML document generation within doclet. public static String generateHtmlTree() { // Document type for the HTML document HtmlTree html = new HtmlTree(TagName.HTML); HtmlTree head = new HtmlTree(TagName.HEAD); HtmlTree title = new HtmlTree(TagName.TITLE); // String content within the document TextBuilder titleContent = new TextBuilder("Markup test"); title.add(titleContent); head.add(title); // Test META tag HtmlTree meta = new HtmlTree(TagName.META); meta.put(HtmlAttr.NAME, "keywords"); meta.put(HtmlAttr.CONTENT, "testContent"); head.add(meta); HtmlTree link = new HtmlTree(TagName.LINK); link.put(HtmlAttr.REL, "testRel"); link.put(HtmlAttr.HREF, "testLink.html"); head.add(link); html.add(head); // Comment within the document Comment bodyMarker = new Comment("======== START OF BODY ========"); html.add(bodyMarker); HtmlTree body = new HtmlTree(TagName.BODY); Comment pMarker = new Comment("======== START OF PARAGRAPH ========"); body.add(pMarker); HtmlTree p = new HtmlTree(TagName.P); TextBuilder bodyContent = new TextBuilder( "This document is generated from sample source code and HTML " + "files with examples of a wide variety of Java language constructs: packages, " + "subclasses, subinterfaces, nested classes, nested interfaces," + "inheriting from other packages, constructors, fields," + "methods, and so forth. "); p.add(bodyContent); TextBuilder anchorContent = new TextBuilder("Click Here"); p.add(HtmlTree.A("testLink.html", anchorContent)); TextBuilder pContent = new TextBuilder(" to out a link."); p.add(pContent); body.add(p); HtmlTree p1 = new HtmlTree(TagName.P); // Test another version of A tag. HtmlTree anchor = new HtmlTree(TagName.A); anchor.put(HtmlAttr.HREF, "testLink.html"); anchor.put(HtmlAttr.ID, "Another version of a tag"); p1.add(anchor); body.add(p1); // Test for empty tags. HtmlTree dl = new HtmlTree(TagName.DL); html.add(dl); // Test for empty nested tags. HtmlTree dlTree = new HtmlTree(TagName.DL); dlTree.add(new HtmlTree(TagName.DT)); dlTree.add(new HtmlTree (TagName.DD)); html.add(dlTree); HtmlTree dlDisplay = new HtmlTree(TagName.DL); dlDisplay.add(new HtmlTree(TagName.DT)); HtmlTree dd = new HtmlTree (TagName.DD); TextBuilder ddContent = new TextBuilder("Test DD"); dd.add(ddContent); dlDisplay.add(dd); body.add(dlDisplay); TextBuilder emptyString = new TextBuilder(""); body.add(emptyString); Comment emptyComment = new Comment(""); body.add(emptyComment); HtmlTree hr = new HtmlTree(TagName.HR); body.add(hr); html.add(body); HtmlDocument htmlDoc = new HtmlDocument(html); return htmlDoc.toString(); } }