Top Description Fields Constructors Methods
jdk.javadoc.internal.doclets.toolkit

public abstract Class AbstractDoclet

extends Object
implements Doclet
Class Inheritance
All Implemented Interfaces
jdk.javadoc.doclet.Doclet
Known Direct Subclasses
jdk.javadoc.internal.doclets.formats.html.HtmlDoclet
Imports
java.util.SortedSet, .TreeSet, java.util.function.Function, javax.lang.model.SourceVersion, javax.lang.model.element.PackageElement, .TypeElement, jdk.javadoc.doclet.Doclet, .DocletEnvironment, jdk.javadoc.internal.doclets.toolkit.util.ClassTree, .DocFileIOException, .UncheckedDocletException, .InternalException, .ElementListWriter, .ResourceIOException, .SimpleDocletException, .Utils

An abstract implementation of a Doclet.

Field Summary

Modifier and TypeField and Description
private BaseConfiguration
configuration

The global configuration information for this run.

protected Messages
protected Utils

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
private void
dumpStack(boolean enabled, Throwable t)

protected abstract void
generateClassFiles(SortedSet<TypeElement>
the set of types to be documented
arr
,
ClassTree
the data structure representing the class tree
classTree
)

Generate the class documentation.

protected void
generateClassFiles(ClassTree
the data structure representing the class tree
classTree
)

Iterate through all classes and construct documentation for them.

protected void
generateFiles()

Start the generation of files.

protected abstract void
generateModuleFiles()

Generate the module documentation.

protected void
generateOtherFiles(ClassTree
the data structure representing the class tree
classTree
)

Generate additional documentation that is added to the API documentation.

protected abstract void
generatePackageFiles(ClassTree
the data structure representing the class tree
classTree
)

Generate the package documentation.

public abstract BaseConfiguration

Returns:

the configuration of the doclet.
getConfiguration
()

Create the configuration instance and returns it.

protected Function<String, String>
public SourceVersion

Returns:

SourceVersion
getSupportedSourceVersion
()

Implements jdk.javadoc.doclet.Doclet.getSupportedSourceVersion.

Returns the SourceVersion indicating the features supported by this doclet.
private void
public boolean

Returns:

true if the doclet executed without error. False otherwise.
run
(DocletEnvironment docEnv)

Implements jdk.javadoc.doclet.Doclet.run.

The method that starts the execution of the doclet.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

configurationback to summary
private BaseConfiguration configuration

The global configuration information for this run.

messagesback to summary
protected Messages messages
utilsback to summary
protected Utils utils

Constructor Detail

AbstractDocletback to summary
public AbstractDoclet()

Method Detail

dumpStackback to summary
private void dumpStack(boolean enabled, Throwable t)
generateClassFilesback to summary
protected abstract void generateClassFiles(SortedSet<TypeElement> arr, ClassTree classTree) throws DocletException

Generate the class documentation.

Parameters
arr:SortedSet<TypeElement>

the set of types to be documented

classTree:ClassTree

the data structure representing the class tree

Exceptions
DocletException:
if there is a problem while generating the documentation
generateClassFilesback to summary
protected void generateClassFiles(ClassTree classTree) throws DocletException

Iterate through all classes and construct documentation for them.

Parameters
classTree:ClassTree

the data structure representing the class tree

Exceptions
DocletException:
if there is a problem while generating the documentation
generateFilesback to summary
protected void generateFiles() throws DocletException

Start the generation of files. Call generate methods in the individual writers, which will in turn generate the documentation files. Call the TreeWriter generation first to ensure the Class Hierarchy is built first and then can be used in the later generation.

Exceptions
DocletException:
if there is a problem while generating the documentation
generateModuleFilesback to summary
protected abstract void generateModuleFiles() throws DocletException

Generate the module documentation.

Exceptions
DocletException:
if there is a problem while generating the documentation
generateOtherFilesback to summary
protected void generateOtherFiles(ClassTree classTree) throws DocletException

Generate additional documentation that is added to the API documentation.

Parameters
classTree:ClassTree

the data structure representing the class tree

Exceptions
DocletException:
if there is a problem while generating the documentation
generatePackageFilesback to summary
protected abstract void generatePackageFiles(ClassTree classTree) throws DocletException

Generate the package documentation.

Parameters
classTree:ClassTree

the data structure representing the class tree

Exceptions
DocletException:
if there is a problem while generating the documentation
getConfigurationback to summary
public abstract BaseConfiguration getConfiguration()

Create the configuration instance and returns it.

Returns:BaseConfiguration

the configuration of the doclet.

getResourceKeyMapperback to summary
protected Function<String, String> getResourceKeyMapper(DocletEnvironment docEnv)
getSupportedSourceVersionback to summary
public SourceVersion getSupportedSourceVersion()

Implements jdk.javadoc.doclet.Doclet.getSupportedSourceVersion.

Returns the SourceVersion indicating the features supported by this doclet.

Returns:SourceVersion

SourceVersion

Annotations
@Override
reportInternalErrorback to summary
private void reportInternalError(Throwable t)
runback to summary
public boolean run(DocletEnvironment docEnv)

Implements jdk.javadoc.doclet.Doclet.run.

The method that starts the execution of the doclet.

Parameters
docEnv:DocletEnvironment

the DocletEnvironment.

Returns:boolean

true if the doclet executed without error. False otherwise.

Annotations
@Override