Module  jdk.compiler
软件包  com.sun.source.util

Interface DocTreeFactory


  • public interface DocTreeFactory
    创建 DocTree节点的工厂。
    Implementation Note:
    该接口的实现中的方法只能接受由同一实现创建的 DocTree节点。
    从以下版本开始：
    9

    • 方法详细信息

      • newAttributeTree

        AttributeTree newAttributeTree​(Name name,
                               AttributeTree.ValueKind vkind,
                               List<? extends DocTree> value)
        创建一个新的 AttributeTree对象，以在HTML标签中表示HTML属性。
        参数
        name - 属性的名称
        vkind - 属性值的种类
        value - 属性的值（如果有）
        结果
        一个 AttributeTree对象

      • newAuthorTree

        AuthorTree newAuthorTree​(List<? extends DocTree> name)
        创建一个新的 AuthorTree对象，以表示一个 {@author }标签。
        参数
        name - 作者的名字
        结果
        一个 AuthorTree对象

      • newCodeTree

        LiteralTree newCodeTree​(TextTree text)
        创建一个新的 CodeTree对象，以表示一个 {@code }标签。
        参数
        text - 标签的内容
        结果
        一个 CodeTree对象

      • newCommentTree

        CommentTree newCommentTree​(String text)
        创建一个新的 CommentTree ，以表示HTML注释。
        参数
        text - 评论的内容
        结果
        一个 CommentTree对象

      • newDeprecatedTree

        DeprecatedTree newDeprecatedTree​(List<? extends DocTree> text)
        创建一个新的 DeprecatedTree对象，以表示一个 {@deprecated }标签。
        参数
        text - 标签的内容
        结果
        一个 DeprecatedTree对象

      • newDocCommentTree

        DocCommentTree newDocCommentTree​(List<? extends DocTree> fullBody,
                                 List<? extends DocTree> tags)
        创建一个新的 DocCommentTree对象，以表示完整的文档注释。
        参数
        fullBody - 整个身体的文档评论
        tags - 文档注释中的块标记
        结果
        一个 DocCommentTree对象

      • newDocRootTree

        DocRootTree newDocRootTree​()
        创建一个新的 DocRootTree对象，以表示一个 {@docroot}标签。
        结果
        一个 DocRootTree对象

      • newEndElementTree

        EndElementTree newEndElementTree​(Name name)
        创建一个新的 EndElement对象，以表示HTML元素的结尾。
        参数
        name - HTML元素的名称
        结果
        一个 EndElementTree对象

      • newEntityTree

        EntityTree newEntityTree​(Name name)
        创建一个新的 EntityTree对象，以表示一个HTML实体。
        参数
        name - 实体的名称，代表'<'和'之间的字符;' 在HTML文档中表示实体
        结果
        一个 EntityTree对象

      • newErroneousTree

        ErroneousTree newErroneousTree​(String text,
                               Diagnostic<JavaFileObject> diag)
        创建一个新的 ErroneousTree对象，以表示一些不可 ErroneousTree输入。
        参数
        text - 不可 text的文字
        diag - 与不可 diag文本关联的诊断，或null
        结果
        一个 ErroneousTree对象

      • newExceptionTree

        ThrowsTree newExceptionTree​(ReferenceTree name,
                            List<? extends DocTree> description)
        创建一个新的 ExceptionTree对象，以表示一个 @exception标签。
        参数
        name - 异常的名称
        description - 说明为什么可能抛出异常
        结果
        一个 ExceptionTree对象

      • newHiddenTree

        HiddenTree newHiddenTree​(List<? extends DocTree> text)
        创建一个新的 HiddenTree对象，以表示一个 {@hidden }标签。
        参数
        text - 标签的内容
        结果
        一个 HiddenTree对象

      • newIdentifierTree

        IdentifierTree newIdentifierTree​(Name name)
        创建一个新的 IdentifierTree对象，以表示一个标识符，如 @param标签。
        参数
        name - 标识符的名称
        结果
        一个 IdentifierTree对象

      • newIndexTree

        IndexTree newIndexTree​(DocTree term,
                       List<? extends DocTree> description)
        创建一个新的 IndexTree对象，以表示一个 {@index }标签。
        参数
        term - 搜索词
        description - 搜索项的可选描述
        结果
        一个 IndexTree对象

      • newInheritDocTree

        InheritDocTree newInheritDocTree​()
        创建一个新的 InheritDocTree对象，以表示一个 {@inheritDoc}标签。
        结果
        一个 InheritDocTree对象

      • newLinkTree

        LinkTree newLinkTree​(ReferenceTree ref,
                     List<? extends DocTree> label)
        创建一个新的 LinkTree对象，以表示一个 {@link }标签。
        参数
        ref - 引用的API元素
        label - 链接的可选标签
        结果
        一个 LinkTree对象

      • newLinkPlainTree

        LinkTree newLinkPlainTree​(ReferenceTree ref,
                          List<? extends DocTree> label)
        创建一个新的 LinkPlainTree对象，以表示一个 {@linkplain }标签。
        参数
        ref - 引用的API元素
        label - 链接的可选标签
        结果
        一个 LinkPlainTree对象

      • newLiteralTree

        LiteralTree newLiteralTree​(TextTree text)
        创建一个新的 LiteralTree对象，以表示一个 {@literal }标签。
        参数
        text - 标签的内容
        结果
        LiteralTree

      • newParamTree

        ParamTree newParamTree​(boolean isTypeParameter,
                       IdentifierTree name,
                       List<? extends DocTree> description)
        创建一个新的 ParamTree对象，以表示一个 @param标签。
        参数
        isTypeParameter - 如果这是一个类型参数， isTypeParameter true，否则为false
        name - 正在描述的参数
        description - 参数说明
        结果
        一个 ParamTree对象

      • newProvidesTree

        ProvidesTree newProvidesTree​(ReferenceTree name,
                             List<? extends DocTree> description)
        创建一个新的 ProvidesTree对象，以表示一个 @provides标签。
        参数
        name - 服务类型的名称
        description - 正在提供的服务的描述
        结果
        一个 ProvidesTree对象

      • newReferenceTree

        ReferenceTree newReferenceTree​(String signature)
        创建一个新的 ReferenceTree对象，以表示对API元素的引用。
        参数
        signature - 参考的文档注释签名
        结果
        一个 ReferenceTree对象

      • newReturnTree

        ReturnTree newReturnTree​(List<? extends DocTree> description)
        创建一个新的 ReturnTree对象，以表示一个 @return标签。
        参数
        description - 方法的返回值的描述
        结果
        一个 ReturnTree对象

      • newSeeTree

        SeeTree newSeeTree​(List<? extends DocTree> reference)
        创建一个新的 SeeTree对象，以表示一个 @see标签。
        参数
        reference - 参考
        结果
        一个 SeeTree对象

      • newSerialTree

        SerialTree newSerialTree​(List<? extends DocTree> description)
        创建一个新的 SerialTree对象，以表示一个 @serial标签。
        参数
        description - 标签的描述
        结果
        一个 SerialTree对象

      • newSerialDataTree

        SerialDataTree newSerialDataTree​(List<? extends DocTree> description)
        创建一个新的 SerialDataTree对象，以表示一个 @serialData标签。
        参数
        description - 标签的描述
        结果
        一个 SerialDataTree对象

      • newSerialFieldTree

        SerialFieldTree newSerialFieldTree​(IdentifierTree name,
                                   ReferenceTree type,
                                   List<? extends DocTree> description)
        创建一个新的 SerialFieldTree对象，以表示一个 @serialField标签。
        参数
        name - 字段的名称
        type - 字段的类型
        description - 该字段的描述
        结果
        一个 SerialFieldTree对象

      • newSinceTree

        SinceTree newSinceTree​(List<? extends DocTree> text)
        创建一个新的 SinceTree对象，以表示一个 @since标签。
        参数
        text - 标签的内容
        结果
        一个 SinceTree对象

      • newStartElementTree

        StartElementTree newStartElementTree​(Name name,
                                     List<? extends DocTree> attrs,
                                     boolean selfClosing)
        创建一个新的 StartElementTree对象，以表示HTML元素的开始。
        参数
        name - HTML元素的名称
        attrs - 属性
        selfClosing - 如果start元素被标记为自动关闭， selfClosing true; 否则为虚假
        结果
        一个 StartElementTree对象

      • newTextTree

        TextTree newTextTree​(String text)
        创建一个新的 TextTree对象，来表示一些纯文本。
        参数
        text - 文字
        结果
        一个 TextTree对象

      • newThrowsTree

        ThrowsTree newThrowsTree​(ReferenceTree name,
                         List<? extends DocTree> description)
        创建一个新的 ThrowsTree对象，以表示一个 @throws标签。
        参数
        name - 异常的名称
        description - 为什么可能抛出异常的描述
        结果
        一个 ThrowsTree对象

      • newUnknownBlockTagTree

        UnknownBlockTagTree newUnknownBlockTagTree​(Name name,
                                           List<? extends DocTree> content)
        创建一个新的 UnknownBlockTagTree对象，以表示无法识别的块标签。
        参数
        name - 块标签的名称
        content - 内容
        结果
        一个 UnknownBlockTagTree对象

      • newUnknownInlineTagTree

        UnknownInlineTagTree newUnknownInlineTagTree​(Name name,
                                             List<? extends DocTree> content)
        创建一个新的 UnknownInlineTagTree对象，以表示无法识别的内联标签。
        参数
        name - 内联标签的名称
        content - 内容
        结果
        一个 UnknownInlineTagTree对象

      • newUsesTree

        UsesTree newUsesTree​(ReferenceTree name,
                     List<? extends DocTree> description)
        创建一个新的 UsesTree对象，以表示一个 @uses标签。
        参数
        name - 服务类型的名称
        description - 如何使用服务的说明
        结果
        一个 UsesTree对象

      • newValueTree

        ValueTree newValueTree​(ReferenceTree ref)
        创建一个新的 ValueTree对象，以表示一个 {@value }标签。
        参数
        ref - 对该值的引用
        结果
        一个 ValueTree对象

      • newVersionTree

        VersionTree newVersionTree​(List<? extends DocTree> text)
        创建一个新的 VersionTree对象，以表示一个 {@version }标签。
        参数
        text - 标签的内容
        结果
        一个 VersionTree对象

      • at

        DocTreeFactory at​(int pos)
        设置要在此工厂创建的后续树节点中记录的位置。 位置应该是相对于源文件开头的字符偏移量，或NOPOS 。
        参数
        pos - 的位置
        结果
        这个对象，方便链接方便

      • getFirstSentence

        List<DocTree> getFirstSentence​(List<? extends DocTree> list)
        获取内容列表中的第一个句子。 第一句的确定是具体的实现，可能涉及使用特定于区域的BreakIterator等启发式。 结果列表可以与输入列表共享一组共同的初始项目。
        参数
        list - 列表
        结果
        包含列表第一句的列表。