Класс DocTrees

public DocTrees()

public static DocTrees instance(JavaCompiler.CompilationTask task)

Параметры:

task — задача компиляции, для которой требуется получить объект Trees

Возвращает:

объект DocTrees

Выбрасывает:

IllegalArgumentException — если задача не поддерживает API Trees.

public static DocTrees instance(ProcessingEnvironment env)

Параметры:

env — среда обработки, для которой требуется получить объект Trees

Возвращает:

объект DocTrees

Выбрасывает:

IllegalArgumentException — если среда не поддерживает API Trees.

public abstract BreakIterator getBreakIterator()

Возвращает:

итератор разбиения

Начиная с:

9

public abstract Elements.DocCommentKind getDocCommentKind(TreePath path)

Параметры:

path — путь к узлу дерева

Возвращает:

стиль комментария документации, связанного с узлом дерева

Начиная с:

23

См. также:

• Trees.getPath(Element)

public abstract DocCommentTree getDocCommentTree(TreePath path)

Примечание по реализации:

Реализация этого метода по умолчанию возвращает один и тот же экземпляр DocCommentTree при повторных вызовах с одинаковым аргументом.

Параметры:

path — путь к узлу дерева

Возвращает:

дерево комментария документации

public abstract DocCommentTree getDocCommentTree(Element e)

Примечание по реализации:

Реализация этого метода по умолчанию возвращает один и тот же экземпляр DocCommentTree при повторных вызовах с одинаковым аргументом.

Параметры:

e — элемент, документация которого требуется

Возвращает:

дерево комментария документации

Начиная с:

9

public abstract DocCommentTree getDocCommentTree(FileObject fileObject)

Примечание по реализации:

Реализация этого метода по умолчанию возвращает новый экземпляр DocCommentTree при каждом вызове.

Параметры:

fileObject — контейнер содержимого

Возвращает:

дерево комментария документации

Выбрасывает:

IllegalArgumentException — если тип файла не поддерживается

Начиная с:

9

public abstract DocCommentTree getDocCommentTree(Element e, String relativePath) throws IOException

Примечание по реализации:

Реализация этого метода по умолчанию возвращает новый экземпляр DocCommentTree при каждом вызове.

Параметры:

e — элемент, путь к которому используется в качестве опорного

relativePath — относительный путь от элемента

Возвращает:

дерево комментария документации

Выбрасывает:

IOException — если происходит исключение

IllegalArgumentException — если тип файла не поддерживается

Начиная с:

9

public abstract DocTreePath getDocTreePath(FileObject fileObject, PackageElement packageElement)

Параметры:

fileObject — объект файла, содержащий HTML-контент

packageElement — элемент пакета, связываемый с заданным объектом файла, представляющим устаревший package.html; в противном случае — null

Возвращает:

путь дерева документации, содержащий комментарий документации, разобранный из заданного файла

Выбрасывает:

IllegalArgumentException — если тип файла не поддерживается

Начиная с:

9

public abstract Element getElement(DocTreePath path)

Параметры:

path — путь к узлу дерева

Возвращает:

элемент

public abstract TypeMirror getType(DocTreePath path)

Параметры:

path — путь к узлу дерева

Возвращает:

ссылочный тип или null

Начиная с:

15

public abstract List<DocTree> getFirstSentence(List<? extends DocTree> list)

Параметры:

list — список DocTree для проверки

Возвращает:

первое предложение

Начиная с:

9

public abstract DocSourcePositions getSourcePositions()

Указано в:

getSourcePositions в классе Trees

Возвращает:

вспомогательный объект

public abstract void printMessage(Diagnostic.Kind kind, CharSequence msg, DocTree t, DocCommentTree c, CompilationUnitTree root)

Параметры:

kind — тип сообщения

msg — сообщение или пустая строка, если сообщения нет

t — дерево, используемое как указатель на позицию

c — дерево комментария документации, используемое как указатель на позицию

root — единица компиляции, содержащая дерево

public abstract void setBreakIterator(BreakIterator breakIterator)

Параметры:

breakIterator — итератор разбиения или null для задания используемого по умолчанию разделителя предложений

Начиная с:

9

public abstract DocTreeFactory getDocTreeFactory()

Возвращает:

вспомогательный объект для создания объектов DocTree

Начиная с:

9

public abstract String getCharacters(EntityTree tree)

Параметры:

tree — дерево, содержащее сущность

Возвращает:

строка, содержащая символы

Начиная с:

16

Внешние спецификации

• Стандарт HTML