モジュール jdk.compiler
パッケージ com.sun.source.util

クラスDocTrees

  • public abstract class DocTrees
extends Trees
    ドキュメンテーション・コメントの構文ツリーへのアクセスを提供します。
    導入されたバージョン:
    1.8

    • コンストラクタの詳細

      • DocTrees

        public DocTrees()

    • メソッドの詳細

      • instance

        public static DocTrees instance​(JavaCompiler.CompilationTask task)
        指定されたCompilationTaskのDocTreesオブジェクトを返します。
        パラメータ:
        task - Treesオブジェクトを取得するコンパイル・タスク
        戻り値:
        DocTreesオブジェクト
        例外:
        IllegalArgumentException - タスクがTrees APIをサポートしていない場合。

      • instance

        public static DocTrees instance​(ProcessingEnvironment env)
        指定されたProcessingEnvironmentのDocTreesオブジェクトを返します。
        パラメータ:
        env - Treesオブジェクトを取得する処理環境
        戻り値:
        DocTreesオブジェクト
        例外:
        IllegalArgumentException - envがTrees APIをサポートしていない場合。

      • getBreakIterator

        public abstract BreakIterator getBreakIterator()
        ドキュメント・コメントの最初の文を計算するために使用されるブレーク・イテレータを返します。 何も指定されていない場合は、nullを返します。
        戻り値:
        breakイテレータ
        導入されたバージョン:
        9

      • getDocCommentTree

        public abstract DocCommentTree getDocCommentTree​(TreePath path)
        指定されたTreePathで識別されるツリー・ノードのドキュメント・コメント・ツリー(ある場合)を返します。 ドキュメント・コメントが見つからなかった場合はnullを返します。
        パラメータ:
        path - ツリー・ノードのパス
        戻り値:
        ドキュメント・コメント・ツリー

      • getDocCommentTree

        public abstract DocCommentTree getDocCommentTree​(Element e)
        指定された要素のdocコメント・ツリーを返します。 ドキュメント・コメントが見つからなかった場合はnullを返します。
        パラメータ:
        e - ドキュメントが必要な要素
        戻り値:
        ドキュメント・コメント・ツリー
        導入されたバージョン:
        9

      • getDocCommentTree

        public abstract DocCommentTree getDocCommentTree​(FileObject fileObject)
        指定されたファイルのdocコメント・ツリーを返します。 ファイルはHTMLファイルである必要があります。この場合、docコメント・ツリーはファイルのコンテンツ全体を表します。 ドキュメント・コメントが見つからなかった場合はnullを返します。 今後のリリースでは、追加のファイル・タイプがサポートされる場合があります。
        パラメータ:
        fileObject - コンテンツ・コンテナ
        戻り値:
        ドキュメント・コメント・ツリー
        導入されたバージョン:
        9

      • getDocCommentTree

        public abstract DocCommentTree getDocCommentTree​(Element e,
                                                 String relativePath)
                                          throws IOException
        指定された要素に対して相対的にパスが指定されている、指定されたファイルのdocコメント・ツリーを返します。 ファイルはHTMLファイルである必要があります。この場合、docコメント・ツリーは<body>タグの内容を表し、囲んでいるタグは無視されます。 ドキュメント・コメントが見つからなかった場合はnullを返します。 今後のリリースでは、追加のファイル・タイプがサポートされる場合があります。
        パラメータ:
        e - パスが参照として使用される要素
        relativePath - 要素からの相対パス
        戻り値:
        ドキュメント・コメント・ツリー
        例外:
        IOException - 例外が発生した場合
        導入されたバージョン:
        9

      • getDocTreePath

        public abstract DocTreePath getDocTreePath​(FileObject fileObject,
                                           PackageElement packageElement)
        指定されたファイルのdocコメント・ツリーを含むdocツリー・パスを返します。 ファイルはHTMLファイルである必要があります。この場合、ドキュメント・コメント・ツリーは<body>タグの内容を表し、囲んでいるタグは無視されます。 ドキュメント・コメント・ツリーの@seeタグおよび{@link}タグに含まれるソース・コード要素への参照は、指定されたパッケージ要素のコンテキストで評価されます。 ドキュメント・コメントが見つからなかった場合はnullを返します。
        パラメータ:
        fileObject - HTMLコンテンツをカプセル化するファイル・オブジェクト
        packageElement - 従来のpackage.htmlを表す指定されたファイル・オブジェクトに関連付けるパッケージ要素。それ以外の場合はnull
        戻り値:
        指定されたファイルから解析されたdocコメントを含むdocツリー・パス
        例外:
        IllegalArgumentException - fileObjectがHTMLファイルではない場合
        導入されたバージョン:
        9

      • getElement

        public abstract Element getElement​(DocTreePath path)
        指定されたDocTreePathのリーフ・ノードによって参照される言語モデル要素、または不明な場合はnullを返します。
        パラメータ:
        path - ツリー・ノードのパス
        戻り値:
        要素

      • getFirstSentence

        public abstract List<DocTree> getFirstSentence​(List<? extends DocTree> list)
        コメントの最初の文を表すDocTreeのリストを返します。
        パラメータ:
        list - 問い合せるDocTreeリスト
        戻り値:
        最初の文
        導入されたバージョン:
        9

      • getSourcePositions

        public abstract DocSourcePositions getSourcePositions()
        ドキュメント・ツリー・ノードのソース位置にアクセスするためのユーティリティ・オブジェクトを返します。
        定義:
        getSourcePositions、クラスTrees
        戻り値:
        ユーティリティ・オブジェクト

      • printMessage

        public abstract void printMessage​(Diagnostic.Kind kind,
                                  CharSequence msg,
                                  DocTree t,
                                  DocCommentTree c,
                                  CompilationUnitTree root)
        指定されたコンパイル単位内のツリーの位置に、指定された種類のメッセージを出力します
        パラメータ:
        kind - メッセージの種類
        msg - メッセージ、ない場合は空の文字列
        t - 位置のヒントとして使用するツリー
        c - 位置ヒントとして使用するドキュメント・コメント・ツリー
        root - ツリーを格納するコンパイル・ユニット

      • setBreakIterator

        public abstract void setBreakIterator​(BreakIterator breakiterator)
        ブレーク・イテレータを設定して、ドキュメント・コメントの最初の文を計算します。
        パラメータ:
        breakiterator - ブレーク・イテレータまたはデフォルトの文ブレーカを指定するnull
        導入されたバージョン:
        9

      • getDocTreeFactory

        public abstract DocTreeFactory getDocTreeFactory()
        DocTreeオブジェクトを作成するためのユーティリティ・オブジェクトを返します。
        戻り値:
        DocTreeオブジェクトを作成するためのユーティリティ・オブジェクト
        導入されたバージョン:
        9