Class HtmlDocletWriter

    • Field Detail

      • pathToRoot

        public final DocPath pathToRoot
        Deprecated.
        Relative path from the file getting generated to the destination directory. For example, if the file getting generated is "java/lang/Object.html", then the path to the root is "../..". This string can be empty if the file getting generated is in the destination directory.
      • path

        public final DocPath path
        Deprecated.
        Platform-independent path from the current or the destination directory to the file getting generated. Used when creating the file.
      • filename

        public final DocPath filename
        Deprecated.
        Name of the file getting generated. If the file getting generated is "java/lang/Object.html", then the filename is "Object.html".
      • configuration

        public final ConfigurationImpl configuration
        Deprecated.
        The global configuration information for this run.
      • utils

        protected final Utils utils
        Deprecated.
      • printedAnnotationHeading

        protected boolean printedAnnotationHeading
        Deprecated.
        To check whether annotation heading is printed or not.
      • printedAnnotationFieldHeading

        protected boolean printedAnnotationFieldHeading
        Deprecated.
        To check whether annotation field heading is printed or not.
    • Constructor Detail

      • HtmlDocletWriter

        public HtmlDocletWriter​(ConfigurationImpl configuration,
                                DocPath path)
                         throws IOException
        Deprecated.
        Constructor to construct the HtmlStandardWriter object.
        Parameters:
        path - File to be generated.
        Throws:
        IOException
    • Method Detail

      • replaceDocRootDir

        public String replaceDocRootDir​(String htmlstr)
        Deprecated.
        Replace {@docRoot} tag used in options that accept HTML text, such as -header, -footer, -top and -bottom, and when converting a relative HREF where commentTagsToString inserts a {@docRoot} where one was missing. (Also see DocRootTaglet for {@docRoot} tags in doc comments.)

        Replace {@docRoot} tag in htmlstr with the relative path to the destination directory from the directory where the file is being written, looping to handle all such tags in htmlstr.

        For example, for "-d docs" and -header containing {@docRoot}, when the HTML page for source file p/C1.java is being generated, the {@docRoot} tag would be inserted into the header as "../", the relative path from docs/p/ to docs/ (the document root).

        Note: This doc comment was written with '@' representing '@' to prevent the inline tag from being interpreted.

      • getAllClassesLinkScript

        public Content getAllClassesLinkScript​(String id)
        Deprecated.
        Get the script to show or hide the All classes link.
        Parameters:
        id - id of the element to show or hide
        Returns:
        a content tree for the script
      • addTagsInfo

        protected void addTagsInfo​(Doc doc,
                                   Content htmltree)
        Deprecated.
        Adds the tags information.
        Parameters:
        doc - the doc for which the tags will be generated
        htmltree - the documentation tree to which the tags will be added
      • hasSerializationOverviewTags

        protected boolean hasSerializationOverviewTags​(FieldDoc field)
        Deprecated.
        Check whether there are any tags for Serialization Overview section to be printed.
        Parameters:
        field - the FieldDoc object to check for tags.
        Returns:
        true if there are tags to be printed else return false.
      • getTagletWriterInstance

        public TagletWriter getTagletWriterInstance​(boolean isFirstSentence)
        Deprecated.
        Returns a TagletWriter that knows how to write HTML.
        Returns:
        a TagletWriter that knows how to write HTML.
      • getTargetPackageLink

        public Content getTargetPackageLink​(PackageDoc pd,
                                            String target,
                                            Content label)
        Deprecated.
        Get Package link, with target frame.
        Parameters:
        pd - The link will be to the "package-summary.html" page for this package
        target - name of the target frame
        label - tag for the link
        Returns:
        a content for the target package link
      • printHtmlDocument

        public void printHtmlDocument​(String[] metakeywords,
                                      boolean includeScript,
                                      Content body)
                               throws IOException
        Deprecated.
        Generates the HTML document tree and prints it out.
        Parameters:
        metakeywords - Array of String keywords for META tag. Each element of the array is assigned to a separate META tag. Pass in null for no array
        includeScript - true if printing windowtitle script false for files that appear in the left-hand frames
        body - the body htmltree to be included in the document
        Throws:
        IOException
      • getWindowTitle

        public String getWindowTitle​(String title)
        Deprecated.
        Get the window title.
        Parameters:
        title - the title string to construct the complete window title
        Returns:
        the window title string
      • getUserHeaderFooter

        public Content getUserHeaderFooter​(boolean header)
        Deprecated.
        Get user specified header and the footer.
        Parameters:
        header - if true print the user provided header else print the user provided footer.
      • addTop

        public void addTop​(Content htmlTree)
        Deprecated.
        Adds the user specified top.
        Parameters:
        htmlTree - the content tree to which user specified top will be added
      • addBottom

        public void addBottom​(Content htmlTree)
        Deprecated.
        Adds the user specified bottom.
        Parameters:
        htmlTree - the content tree to which user specified bottom will be added
      • addNavLinks

        protected void addNavLinks​(boolean header,
                                   Content htmlTree)
        Deprecated.
        Adds the navigation bar for the Html page at the top and and the bottom.
        Parameters:
        header - If true print navigation bar at the top of the page else
        htmlTree - the HtmlTree to which the nav links will be added
      • getNavLinkNext

        protected Content getNavLinkNext()
        Deprecated.
        Get the word "NEXT" to indicate that no link is available. Override this method to customize next link.
        Returns:
        a content tree for the link
      • getNavLinkPrevious

        protected Content getNavLinkPrevious()
        Deprecated.
        Get the word "PREV" to indicate that no link is available. Override this method to customize prev link.
        Returns:
        a content tree for the link
      • addSummaryDetailLinks

        protected void addSummaryDetailLinks​(Content navDiv)
        Deprecated.
        Do nothing. This is the default method.
      • getNavLinkContents

        protected Content getNavLinkContents()
        Deprecated.
        Get link to the "overview-summary.html" page.
        Returns:
        a content tree for the link
      • getNavLinkPackage

        protected Content getNavLinkPackage​(PackageDoc pkg)
        Deprecated.
        Get link to the "package-summary.html" page for the package passed.
        Parameters:
        pkg - Package to which link will be generated
        Returns:
        a content tree for the link
      • getNavLinkPackage

        protected Content getNavLinkPackage()
        Deprecated.
        Get the word "Package" , to indicate that link is not available here.
        Returns:
        a content tree for the link
      • getNavLinkClassUse

        protected Content getNavLinkClassUse()
        Deprecated.
        Get the word "Use", to indicate that link is not available.
        Returns:
        a content tree for the link
      • getNavLinkPrevious

        public Content getNavLinkPrevious​(DocPath prev)
        Deprecated.
        Get link for previous file.
        Parameters:
        prev - File name for the prev link
        Returns:
        a content tree for the link
      • getNavLinkNext

        public Content getNavLinkNext​(DocPath next)
        Deprecated.
        Get link for next file. If next is null, just print the label without linking it anywhere.
        Parameters:
        next - File name for the next link
        Returns:
        a content tree for the link
      • getNavShowLists

        protected Content getNavShowLists​(DocPath link)
        Deprecated.
        Get "FRAMES" link, to switch to the frame version of the output.
        Parameters:
        link - File to be linked, "index.html"
        Returns:
        a content tree for the link
      • getNavShowLists

        protected Content getNavShowLists()
        Deprecated.
        Get "FRAMES" link, to switch to the frame version of the output.
        Returns:
        a content tree for the link
      • getNavHideLists

        protected Content getNavHideLists​(DocPath link)
        Deprecated.
        Get "NO FRAMES" link, to switch to the non-frame version of the output.
        Parameters:
        link - File to be linked
        Returns:
        a content tree for the link
      • getNavLinkTree

        protected Content getNavLinkTree()
        Deprecated.
        Get "Tree" link in the navigation bar. If there is only one package specified on the command line, then the "Tree" link will be to the only "package-tree.html" file otherwise it will be to the "overview-tree.html" file.
        Returns:
        a content tree for the link
      • getNavLinkMainTree

        protected Content getNavLinkMainTree​(String label)
        Deprecated.
        Get the overview tree link for the main tree.
        Parameters:
        label - the label for the link
        Returns:
        a content tree for the link
      • getNavLinkClass

        protected Content getNavLinkClass()
        Deprecated.
        Get the word "Class", to indicate that class link is not available.
        Returns:
        a content tree for the link
      • getNavLinkDeprecated

        protected Content getNavLinkDeprecated()
        Deprecated.
        Get "Deprecated" API link in the navigation bar.
        Returns:
        a content tree for the link
      • getNavLinkClassIndex

        protected Content getNavLinkClassIndex()
        Deprecated.
        Get link for generated index. If the user has used "-splitindex" command line option, then link to file "index-files/index-1.html" is generated otherwise link to file "index-all.html" is generated.
        Returns:
        a content tree for the link
      • getNavLinkIndex

        protected Content getNavLinkIndex()
        Deprecated.
        Get link for generated class index.
        Returns:
        a content tree for the link
      • getNavLinkHelp

        protected Content getNavLinkHelp()
        Deprecated.
        Get help file link. If user has provided a help file, then generate a link to the user given file, which is already copied to current or destination directory.
        Returns:
        a content tree for the link
      • getSummaryTableHeader

        public Content getSummaryTableHeader​(String[] header,
                                             String scope)
        Deprecated.
        Get summary table header.
        Parameters:
        header - the header for the table
        scope - the scope of the headers
        Returns:
        a content tree for the header
      • getTableCaption

        public Content getTableCaption​(Content title)
        Deprecated.
        Get table caption.
        Parameters:
        rawText - the caption for the table which could be raw Html
        Returns:
        a content tree for the caption
      • getMarkerAnchor

        public Content getMarkerAnchor​(String anchorName)
        Deprecated.
        Get the marker anchor which will be added to the documentation tree.
        Parameters:
        anchorName - the anchor name attribute
        Returns:
        a content tree for the marker anchor
      • getMarkerAnchor

        public Content getMarkerAnchor​(SectionName sectionName)
        Deprecated.
        Get the marker anchor which will be added to the documentation tree.
        Parameters:
        sectionName - the section name anchor attribute for page
        Returns:
        a content tree for the marker anchor
      • getMarkerAnchor

        public Content getMarkerAnchor​(SectionName sectionName,
                                       String anchorName)
        Deprecated.
        Get the marker anchor which will be added to the documentation tree.
        Parameters:
        sectionName - the section name anchor attribute for page
        anchorName - the anchor name combined with section name attribute for the page
        Returns:
        a content tree for the marker anchor
      • getMarkerAnchor

        public Content getMarkerAnchor​(String anchorName,
                                       Content anchorContent)
        Deprecated.
        Get the marker anchor which will be added to the documentation tree.
        Parameters:
        anchorName - the anchor name or id attribute
        anchorContent - the content that should be added to the anchor
        Returns:
        a content tree for the marker anchor
      • getPackageName

        public Content getPackageName​(PackageDoc packageDoc)
        Deprecated.
        Returns a packagename content.
        Parameters:
        packageDoc - the package to check
        Returns:
        package name content
      • getPackageLabel

        public Content getPackageLabel​(String packageName)
        Deprecated.
        Returns a package name label.
        Parameters:
        packageName - the package name
        Returns:
        the package name content
      • addPackageDeprecatedAPI

        protected void addPackageDeprecatedAPI​(List<Doc> deprPkgs,
                                               String headingKey,
                                               String tableSummary,
                                               String[] tableHeader,
                                               Content contentTree)
        Deprecated.
        Add package deprecation information to the documentation tree
        Parameters:
        deprPkgs - list of deprecated packages
        headingKey - the caption for the deprecated package table
        tableSummary - the summary for the deprecated package table
        tableHeader - table headers for the deprecated package table
        contentTree - the content tree to which the deprecated package table will be added
      • pathString

        protected DocPath pathString​(ClassDoc cd,
                                     DocPath name)
        Deprecated.
        Return the path to the class page for a classdoc.
        Parameters:
        cd - Class to which the path is requested.
        name - Name of the file(doesn't include path).
      • pathString

        protected DocPath pathString​(PackageDoc pd,
                                     DocPath name)
        Deprecated.
        Return path to the given file name in the given package. So if the name passed is "Object.html" and the name of the package is "java.lang", and if the relative path is "../.." then returned string will be "../../java/lang/Object.html"
        Parameters:
        pd - Package in which the file name is assumed to be.
        name - File name, to which path string is.
      • getPackageAnchorName

        public String getPackageAnchorName​(PackageDoc packageDoc)
        Deprecated.
        Given a package, return the name to be used in HTML anchor tag.
        Parameters:
        packageDoc - the package.
        Returns:
        the name to be used in HTML anchor tag.
      • getPackageLink

        public Content getPackageLink​(PackageDoc pkg,
                                      String label)
        Deprecated.
        Return the link to the given package.
        Parameters:
        pkg - the package to link to.
        label - the label for the link.
        Returns:
        a content tree for the package link.
      • getPackageLink

        public Content getPackageLink​(PackageDoc pkg,
                                      Content label)
        Deprecated.
        Return the link to the given package.
        Parameters:
        pkg - the package to link to.
        label - the label for the link.
        Returns:
        a content tree for the package link.
      • italicsClassName

        public Content italicsClassName​(ClassDoc cd,
                                        boolean qual)
        Deprecated.
      • addSrcLink

        public void addSrcLink​(ProgramElementDoc doc,
                               Content label,
                               Content htmltree)
        Deprecated.
        Add the link to the content tree.
        Parameters:
        doc - program element doc for which the link will be added
        label - label for the link
        htmltree - the content tree to which the link will be added
      • getLink

        public Content getLink​(LinkInfoImpl linkInfo)
        Deprecated.
        Return the link to the given class.
        Parameters:
        linkInfo - the information about the link.
        Returns:
        the link for the given class.
      • getTypeParameterLinks

        public Content getTypeParameterLinks​(LinkInfoImpl linkInfo)
        Deprecated.
        Return the type parameters for the given class.
        Parameters:
        linkInfo - the information about the link.
        Returns:
        the type for the given class.
      • getCrossClassLink

        public Content getCrossClassLink​(String qualifiedClassName,
                                         String refMemName,
                                         Content label,
                                         boolean strong,
                                         String style,
                                         boolean code)
        Deprecated.
        Return a class cross link to external class documentation. The name must be fully qualified to determine which package the class is in. The -link option does not allow users to link to external classes in the "default" package.
        Parameters:
        qualifiedClassName - the qualified name of the external class.
        refMemName - the name of the member being referenced. This should be null or empty string if no member is being referenced.
        label - the label for the external link.
        strong - true if the link should be strong.
        style - the style of the link.
        code - true if the label should be code font.
      • isClassLinkable

        public boolean isClassLinkable​(ClassDoc cd)
        Deprecated.
      • getCrossPackageLink

        public DocLink getCrossPackageLink​(String pkgName)
        Deprecated.
      • getQualifiedClassLink

        public Content getQualifiedClassLink​(LinkInfoImpl.Kind context,
                                             ClassDoc cd)
        Deprecated.
        Get the class link.
        Parameters:
        context - the id of the context where the link will be added
        cd - the class doc to link to
        Returns:
        a content tree for the link
      • addPreQualifiedClassLink

        public void addPreQualifiedClassLink​(LinkInfoImpl.Kind context,
                                             ClassDoc cd,
                                             Content contentTree)
        Deprecated.
        Add the class link.
        Parameters:
        context - the id of the context where the link will be added
        cd - the class doc to link to
        contentTree - the content tree to which the link will be added
      • getPreQualifiedClassLink

        public Content getPreQualifiedClassLink​(LinkInfoImpl.Kind context,
                                                ClassDoc cd,
                                                boolean isStrong)
        Deprecated.
        Retrieve the class link with the package portion of the label in plain text. If the qualifier is excluded, it will not be included in the link label.
        Parameters:
        cd - the class to link to.
        isStrong - true if the link should be strong.
        Returns:
        the link with the package portion of the label in plain text.
      • addPreQualifiedClassLink

        public void addPreQualifiedClassLink​(LinkInfoImpl.Kind context,
                                             ClassDoc cd,
                                             boolean isStrong,
                                             Content contentTree)
        Deprecated.
        Add the class link with the package portion of the label in plain text. If the qualifier is excluded, it will not be included in the link label.
        Parameters:
        context - the id of the context where the link will be added
        cd - the class to link to
        isStrong - true if the link should be strong
        contentTree - the content tree to which the link with be added
      • addPreQualifiedStrongClassLink

        public void addPreQualifiedStrongClassLink​(LinkInfoImpl.Kind context,
                                                   ClassDoc cd,
                                                   Content contentTree)
        Deprecated.
        Add the class link, with only class name as the strong link and prefixing plain package name.
        Parameters:
        context - the id of the context where the link will be added
        cd - the class to link to
        contentTree - the content tree to which the link with be added
      • getDocLink

        public Content getDocLink​(LinkInfoImpl.Kind context,
                                  MemberDoc doc,
                                  String label)
        Deprecated.
        Get the link for the given member.
        Parameters:
        context - the id of the context where the link will be added
        doc - the member being linked to
        label - the label for the link
        Returns:
        a content tree for the doc link
      • getDocLink

        public Content getDocLink​(LinkInfoImpl.Kind context,
                                  MemberDoc doc,
                                  String label,
                                  boolean strong)
        Deprecated.
        Return the link for the given member.
        Parameters:
        context - the id of the context where the link will be printed.
        doc - the member being linked to.
        label - the label for the link.
        strong - true if the link should be strong.
        Returns:
        the link for the given member.
      • getDocLink

        public Content getDocLink​(LinkInfoImpl.Kind context,
                                  ClassDoc classDoc,
                                  MemberDoc doc,
                                  String label,
                                  boolean strong)
        Deprecated.
        Return the link for the given member.
        Parameters:
        context - the id of the context where the link will be printed.
        classDoc - the classDoc that we should link to. This is not necessarily equal to doc.containingClass(). We may be inheriting comments.
        doc - the member being linked to.
        label - the label for the link.
        strong - true if the link should be strong.
        Returns:
        the link for the given member.
      • getDocLink

        public Content getDocLink​(LinkInfoImpl.Kind context,
                                  ClassDoc classDoc,
                                  MemberDoc doc,
                                  String label,
                                  boolean strong,
                                  boolean isProperty)
        Deprecated.
        Return the link for the given member.
        Parameters:
        context - the id of the context where the link will be printed.
        classDoc - the classDoc that we should link to. This is not necessarily equal to doc.containingClass(). We may be inheriting comments.
        doc - the member being linked to.
        label - the label for the link.
        strong - true if the link should be strong.
        isProperty - true if the doc parameter is a JavaFX property.
        Returns:
        the link for the given member.
      • getDocLink

        public Content getDocLink​(LinkInfoImpl.Kind context,
                                  ClassDoc classDoc,
                                  MemberDoc doc,
                                  Content label)
        Deprecated.
        Return the link for the given member.
        Parameters:
        context - the id of the context where the link will be added
        classDoc - the classDoc that we should link to. This is not necessarily equal to doc.containingClass(). We may be inheriting comments
        doc - the member being linked to
        label - the label for the link
        Returns:
        the link for the given member
      • seeTagToContent

        public Content seeTagToContent​(SeeTag see)
        Deprecated.
      • addInlineComment

        public void addInlineComment​(Doc doc,
                                     Tag tag,
                                     Content htmltree)
        Deprecated.
        Add the inline comment.
        Parameters:
        doc - the doc for which the inline comment will be added
        tag - the inline tag to be added
        htmltree - the content tree to which the comment will be added
      • addInlineDeprecatedComment

        public void addInlineDeprecatedComment​(Doc doc,
                                               Tag tag,
                                               Content htmltree)
        Deprecated.
        Add the inline deprecated comment.
        Parameters:
        doc - the doc for which the inline deprecated comment will be added
        tag - the inline tag to be added
        htmltree - the content tree to which the comment will be added
      • addSummaryComment

        public void addSummaryComment​(Doc doc,
                                      Content htmltree)
        Deprecated.
        Adds the summary content.
        Parameters:
        doc - the doc for which the summary will be generated
        htmltree - the documentation tree to which the summary will be added
      • addSummaryComment

        public void addSummaryComment​(Doc doc,
                                      Tag[] firstSentenceTags,
                                      Content htmltree)
        Deprecated.
        Adds the summary content.
        Parameters:
        doc - the doc for which the summary will be generated
        firstSentenceTags - the first sentence tags for the doc
        htmltree - the documentation tree to which the summary will be added
      • addSummaryDeprecatedComment

        public void addSummaryDeprecatedComment​(Doc doc,
                                                Tag tag,
                                                Content htmltree)
        Deprecated.
      • addInlineComment

        public void addInlineComment​(Doc doc,
                                     Content htmltree)
        Deprecated.
        Adds the inline comment.
        Parameters:
        doc - the doc for which the inline comments will be generated
        htmltree - the documentation tree to which the inline comments will be added
      • commentTagsToContent

        public Content commentTagsToContent​(Tag holderTag,
                                            Doc doc,
                                            Tag[] tags,
                                            boolean isFirstSentence)
        Deprecated.
        Converts inline tags and text to text strings, expanding the inline tags along the way. Called wherever text can contain an inline tag, such as in comments or in free-form text arguments to non-inline tags.
        Parameters:
        holderTag - specific tag where comment resides
        doc - specific doc where comment resides
        tags - array of text tags and inline tags (often alternating) present in the text of interest for this doc
        isFirstSentence - true if text is first sentence
      • removeNonInlineHtmlTags

        public static String removeNonInlineHtmlTags​(String text)
        Deprecated.
      • addStyleSheetProperties

        public void addStyleSheetProperties​(Content head)
        Deprecated.
        Add a link to the stylesheet file.
        Parameters:
        head - the content tree to which the files will be added
      • addScriptProperties

        public void addScriptProperties​(Content head)
        Deprecated.
        Add a link to the JavaScript file.
        Parameters:
        head - the content tree to which the files will be added
      • isCoreClass

        public boolean isCoreClass​(ClassDoc cd)
        Deprecated.
        According to The Java™ Language Specification, all the outer classes and static nested classes are core classes.
      • addAnnotationInfo

        public void addAnnotationInfo​(PackageDoc packageDoc,
                                      Content htmltree)
        Deprecated.
        Adds the annotatation types for the given packageDoc.
        Parameters:
        packageDoc - the package to write annotations for.
        htmltree - the documentation tree to which the annotation info will be added
      • addReceiverAnnotationInfo

        public void addReceiverAnnotationInfo​(ExecutableMemberDoc method,
                                              AnnotationDesc[] descList,
                                              Content htmltree)
        Deprecated.
        Add the annotation types of the executable receiver.
        Parameters:
        method - the executable to write the receiver annotations for.
        descList - list of annotation description.
        htmltree - the documentation tree to which the annotation info will be added
      • addAnnotationInfo

        public void addAnnotationInfo​(ProgramElementDoc doc,
                                      Content htmltree)
        Deprecated.
        Adds the annotatation types for the given doc.
        Parameters:
        doc - the package to write annotations for
        htmltree - the content tree to which the annotation types will be added
      • addAnnotationInfo

        public boolean addAnnotationInfo​(int indent,
                                         Doc doc,
                                         Parameter param,
                                         Content tree)
        Deprecated.
        Add the annotatation types for the given doc and parameter.
        Parameters:
        indent - the number of spaces to indent the parameters.
        doc - the doc to write annotations for.
        param - the parameter to write annotations for.
        tree - the content tree to which the annotation types will be added
      • getAnnotations

        public List<Content> getAnnotations​(int indent,
                                            AnnotationDesc[] descList,
                                            boolean linkBreak,
                                            boolean isJava5DeclarationLocation)
        Deprecated.
        Return the string representations of the annotation types for the given doc. A null elementType indicates that all the annotations should be returned without any filtering.
        Parameters:
        indent - the number of extra spaces to indent the annotations.
        descList - the array of AnnotationDesc.
        linkBreak - if true, add new line between each member value.
        elementType - the type of targeted element (used for filtering type annotations from declaration annotations)
        Returns:
        an array of strings representing the annotations being documented.
      • configuration

        public Configuration configuration()
        Deprecated.
        Return the configuation for this doclet.
        Specified by:
        configuration in class HtmlDocWriter
        Returns:
        the configuration for this doclet.