APIdia Launch Partner
Top Description Inners Methods
jdk.javadoc.doclet

public Interface DocletEnvironment

Known Direct Implementers
jdk.javadoc.internal.tool.DocEnvImpl
Imports
java.util.Set, javax.lang.model.SourceVersion, javax.lang.model.element.Element, .TypeElement, javax.lang.model.util.Elements, .Types, javax.tools.JavaFileManager, .JavaFileObject.Kind, com.sun.source.util.DocTrees

Represents the operating environment of a single invocation of the doclet. This object can be used to access the program structures, various utilities and the user specified elements on the command line.
Since
9

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static enum
DocletEnvironment.ModuleMode

The mode specifying the level of detail of module documentation.

Method Summary

Modifier and TypeMethod and Description
public DocTrees

Returns:

a utility class to operate on doc trees
getDocTrees
()

Returns an instance of the DocTrees utility class.

public Elements

Returns:

a utility class to operate on elements
getElementUtils
()

Returns an instance of the Elements utility class.

public JavaFileObject.Kind

Returns:

the file kind
getFileKind
(TypeElement
the type element
type
)

Returns the file kind of a type element.

public Set<? extends Element>

Returns:

the set of included elements
getIncludedElements
()

Returns the module, package and type elements that should be included in the documentation.

public JavaFileManager

Returns:

the file manager used to read and write files
getJavaFileManager
()

Returns the file manager used to read and write files.

public DocletEnvironment.ModuleMode

Returns:

the required level of module documentation
getModuleMode
()

Returns the required level of module documentation.

public SourceVersion

Returns:

the source version
getSourceVersion
()

Returns the source version of the source files that were read.

public Set<? extends Element>

Returns:

the set of specified elements
getSpecifiedElements
()

Returns the elements specified when the tool is invoked.

public Types

Returns:

a utility class to operate on type mirrors
getTypeUtils
()

Returns an instance of the Types utility class.

public boolean

Returns:

true if included, false otherwise
isIncluded
(Element
the element
e
)

Returns true if an element should be included in the documentation.

public boolean

Returns:

true if selected, false otherwise
isSelected
(Element
the element
e
)

Returns true if the element is selected.

Method Detail

getDocTreesback to summary
public DocTrees getDocTrees()

Returns an instance of the DocTrees utility class. This class provides methods to access TreePaths, DocCommentTrees and so on.

Returns:DocTrees

a utility class to operate on doc trees

getElementUtilsback to summary
public Elements getElementUtils()

Returns an instance of the Elements utility class. This class provides methods for operating on elements.

Returns:Elements

a utility class to operate on elements

getFileKindback to summary
public JavaFileObject.Kind getFileKind(TypeElement type)

Returns the file kind of a type element.

Parameters
type:TypeElement

the type element

Returns:JavaFileObject.Kind

the file kind

getIncludedElementsback to summary
public Set<? extends Element> getIncludedElements()

Returns the module, package and type elements that should be included in the documentation.

Returns:Set<? extends Element>

the set of included elements

getJavaFileManagerback to summary
public JavaFileManager getJavaFileManager()

Returns the file manager used to read and write files.

Returns:JavaFileManager

the file manager used to read and write files

getModuleModeback to summary
public DocletEnvironment.ModuleMode getModuleMode()

Returns the required level of module documentation.

Returns:DocletEnvironment.ModuleMode

the required level of module documentation

getSourceVersionback to summary
public SourceVersion getSourceVersion()

Returns the source version of the source files that were read.

Returns:SourceVersion

the source version

getSpecifiedElementsback to summary
public Set<? extends Element> getSpecifiedElements()

Returns the elements specified when the tool is invoked.

Returns:Set<? extends Element>

the set of specified elements

getTypeUtilsback to summary
public Types getTypeUtils()

Returns an instance of the Types utility class. This class provides methods for operating on type mirrors.

Returns:Types

a utility class to operate on type mirrors

isIncludedback to summary
public boolean isIncluded(Element e)

Returns true if an element should be included in the documentation.

Parameters
e:Element

the element

Returns:boolean

true if included, false otherwise

isSelectedback to summary
public boolean isSelected(Element e)

Returns true if the element is selected.

Parameters
e:Element

the element

Returns:boolean

true if selected, false otherwise

jdk.javadoc.doclet back to summary

public final Enum DocletEnvironment.ModuleMode

extends Enum<DocletEnvironment.ModuleMode>
Class Inheritance

The mode specifying the level of detail of module documentation.

Field Summary

Modifier and TypeField and Description
public static final DocletEnvironment.ModuleMode
ALL

Indicate Detailed documentation is required

public static final DocletEnvironment.ModuleMode
API

Indicate API level documentation is required

Constructor Summary

AccessConstructor and Description
private

Method Summary

Modifier and TypeMethod and Description
public static DocletEnvironment.ModuleMode
public static DocletEnvironment.ModuleMode[]
Inherited from java.lang.Enum:
clonecompareTodescribeConstableequalsfinalizegetDeclaringClasshashCodenameordinaltoStringvalueOf

Field Detail

ALLback to summary
public static final DocletEnvironment.ModuleMode ALL

Indicate Detailed documentation is required

APIback to summary
public static final DocletEnvironment.ModuleMode API

Indicate API level documentation is required

Constructor Detail

ModuleModeback to summary
private ModuleMode()

Method Detail

valueOfback to summary
public static DocletEnvironment.ModuleMode valueOf(String name)
valuesback to summary
public static DocletEnvironment.ModuleMode[] values()