Spec-Zone .ru
спецификации, руководства, описания, API
|
См.: Описание
Интерфейс | Описание |
---|---|
AnnotationDesc |
Представляет аннотацию.
|
AnnotationDesc. ElementValuePair |
Представляет ассоциацию между элементом типа аннотации и одним из его значений.
|
AnnotationTypeDoc |
Представляет тип аннотации.
|
AnnotationTypeElementDoc |
Представляет элемент типа аннотации.
|
AnnotationValue |
Представляет значение элемента типа аннотации.
|
ClassDoc |
Представляет класс java или интерфейс и обеспечивает доступ к информации о классе, комментарии класса и тегах, и элементах класса.
|
ConstructorDoc |
Представляет конструктора класса java.
|
Документ |
Представляет конструкции языка Java (пакет, класс, конструктор, метод, поле), которые имеют комментарии и были обработаны этим выполнением javadoc.
|
DocErrorReporter |
Этот интерфейс обеспечивает ошибку, предупреждая и печать уведомления.
|
ExecutableMemberDoc |
Представляет метод или конструктора класса java.
|
FieldDoc |
Представляет поле в классе java.
|
MemberDoc |
Представляет элемент класса java: поле, конструктор, или метод.
|
MethodDoc |
Представляет метод класса java.
|
PackageDoc |
Представляет пакет java.
|
Параметр |
Информация о параметре.
|
ParameterizedType |
Представляет вызов универсального класса или интерфейса.
|
ParamTag |
Представляет @param тег документации.
|
ProgramElementDoc |
Представляет элемент программы java: класс, интерфейс, поле, конструктор, или метод.
|
RootDoc |
Представляет корень информации о структуре программы для одного выполнения javadoc.
|
SeeTag |
Представляет определяемую пользователем перекрестную ссылку на связанную документацию.
|
SerialFieldTag |
Документирует поле Serializable, определенное ObjectStreamField.
|
SourcePosition |
Этот интерфейс описывает исходную позицию: имя файла, номер строки, и номер столбца.
|
Тег |
Представляет простой тег документации, такой как @since, @author, @version.
|
ThrowsTag |
Представляет @throws или @exception тег документации.
|
Ввести |
Представляет тип.
|
TypeVariable |
Представляет переменную типа.
|
WildcardType |
Представляет подстановочный параметр типа.
|
Класс | Описание |
---|---|
Doclet |
Это - пример запускающегося класса для doclet, показывая методы точки входа.
|
Перечисление | Описание |
---|---|
LanguageVersion |
Версия Языка программирования Java.
|
Doclets вызываются javadoc и используют этот API, чтобы выписать информацию о программе к файлам. Например, стандарт doclet вызывают по умолчанию и выписывает документацию к файлам HTML.
Вызов определяется кратким обзором Doclet
класс - точка входа start
метод:
public static boolean start(RootDoc root)
RootDoc
экземпляр содержит корень информации о структуре программы. От этого корня может быть извлечена вся другая информация о структуре программы. -public
, -protected
, -package
, и -private
) элементы программы фильтра, производя набор результатов, названный включенным набором, или "задокументированным" набором. (Нефильтруемый набор также доступен через allClasses(false)
.)
Всюду по этому API термин класс обычно является сокращением для "класса или интерфейса", как в: ClassDoc
, allClasses()
, и findClass(String)
. Только в нескольких других местах это означает "класс, в противоположность интерфейсу", как в: Doc.isClass()
. Во втором смысле, это вызовы API четыре вида классов: обычные классы, перечисления, ошибки и исключения. Всюду по API подробное описание каждого элемента программы описывает явно, какое значение используется.
Квалифицированный класс или интерфейсное имя являются тем, которому предварительно ожидали его имя пакета к этому, такой как java.lang.String
. У неполностью определенного имени нет никакого имени пакета, такой как String
.
@param
теги обработанных классов: import com.sun.javadoc.*; public class ListParams extends Doclet { public static boolean start(RootDoc root) { ClassDoc[] classes = root.classes(); for (int i = 0; i < classes.length; ++i) { ClassDoc cd = classes[i]; printMembers(cd.constructors()); printMembers(cd.methods()); } return true; } static void printMembers(ExecutableMemberDoc[] mems) { for (int i = 0; i < mems.length; ++i) { ParamTag[] params = mems[i].paramTags(); System.out.println(mems[i].qualifiedName()); for (int j = 0; j < params.length; ++j) { System.out.println(" " + params[j].parameterName() + " - " + params[j].parameterComment()); } } } }Interfaces and methods from the Javadoc API are marked in red.
Doclet
is an abstract class that specifies the invocation interface for doclets, Doclet
holds class or interface information, ExecutableMemberDoc
is a superinterface of MethodDoc
and ConstructorDoc
, and ParamTag
holds information from "@param
" tags. This doclet when invoked with a command line like:
javadoc -doclet ListParams -sourcepath <source-location> java.utilproducing output like:
... java.util.ArrayList.add index - index at which the specified element is to be inserted. element - element to be inserted. java.util.ArrayList.remove index - the index of the element to removed. ...
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2011, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.