APIdia Launch Partner
Top Description Fields Constructors Methods
jdk.javadoc.internal.doclets.formats.html

public Class ClassUseWriter

extends SubWriterHolderWriter
Class Inheritance
Imports
java.util.ArrayList, .HashMap, .List, .Map, .Set, .SortedSet, .TreeSet, javax.lang.model.element.Element, .PackageElement, .TypeElement, javax.tools.Diagnostic, jdk.javadoc.internal.doclets.formats.html.Navigation.PageMode, jdk.javadoc.internal.doclets.formats.html.markup.HtmlStyles, jdk.javadoc.internal.doclets.toolkit.DocletException, jdk.javadoc.internal.doclets.toolkit.util.ClassTree, .ClassUseMapper, .DocFileIOException, .DocPath, .DocPaths, .Utils, jdk.javadoc.internal.html.Content, .ContentBuilder, .HtmlTag, .HtmlTree

Generate class usage information.

Field Summary

Modifier and TypeField and Description
pack-priv final NestedClassWriter
pack-priv final ConstructorWriter
pack-priv final FieldWriter
pack-priv final MethodWriter
pack-priv final SortedSet<PackageElement>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv Set<PackageElement>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final Map<PackageElement, List<Element>>
pack-priv final TypeElement
Inherited from jdk.javadoc.internal.doclets.formats.html.SubWriterHolderWriter:
bodyContents

Constructor Summary

AccessConstructor and Description
public
ClassUseWriter(HtmlConfiguration
the configuration
configuration
,
ClassUseMapper
a "mapper" containing the usage information
mapper
,
TypeElement
the type element
typeElement
)

Creates a writer for a page listing the uses of a type element.

Method Summary

Modifier and TypeMethod and Description
protected void
addClassList(Content
the content to which the class elements will be added
content
)

Add the class elements that use the given class.

protected void
addClassUse(Content
the content to which the class use information will be added
content
)

Add the class use documentation.

protected void
addClassUse(PackageElement
the package that uses the given class
pkg
,
Content
the content to which the class use information will be added
content
)

Add the class use information.

protected void
addPackageAnnotationList(Content
the content to which the package annotation elements will be added
content
)

Add the package annotation elements.

protected void
addPackageList(Content
the content to which the packages elements will be added
content
)

Add the packages elements that use the given class.

protected void
addPackageUse(PackageElement
the package that uses the given class
pkg
,
Table<?>
the table to which the package use information will be added
table
)

Add the package use information.

public void
buildPage()

Implements abstract jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.buildPage.

Generate the class use elements.

public static void
generate(HtmlConfiguration
the configuration for this doclet
configuration
,
ClassTree
the class tree hierarchy
classTree
)

Write out class use and package use pages.

protected HtmlTree

Returns:

the class use header
getClassUseHeader
()

Get the header for the class use listing.

private static DocPath
pathFor(HtmlConfiguration configuration, TypeElement typeElement)

private Map<PackageElement, List<Element>>
pkgDivide(Map<TypeElement, ? extends List<? extends Element>> classMap)

Inherited from jdk.javadoc.internal.doclets.formats.html.SubWriterHolderWriter:
addClassContentaddIndexCommentaddIndexCommentaddInheritedMemberSummaryaddInheritedSummaryHeaderaddSummaryaddSummaryHeaderaddSummaryLinkCommentaddSummaryLinkCommentgetContentHeadergetDetailsListgetDetailsListItemgetMembergetMembergetMemberInheritedgetMemberListgetMemberListItemgetMemberSummarygetPropertyHelpergetSummariesListgetSummariesListItem

Field Detail

classSubWriterback to summary
pack-priv final NestedClassWriter classSubWriter
constrSubWriterback to summary
pack-priv final ConstructorWriter constrSubWriter
fieldSubWriterback to summary
pack-priv final FieldWriter fieldSubWriter
methodSubWriterback to summary
pack-priv final MethodWriter methodSubWriter
pkgSetback to summary
pack-priv final SortedSet<PackageElement> pkgSet
pkgToClassAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToClassAnnotations
pkgToClassTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToClassTypeParameter
pkgToConstructorAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToConstructorAnnotations
pkgToConstructorArgsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToConstructorArgs
pkgToConstructorArgTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToConstructorArgTypeParameter
pkgToConstructorParameterAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToConstructorParameterAnnotations
pkgToConstructorThrowsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToConstructorThrows
pkgToFieldback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToField
pkgToFieldAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToFieldAnnotations
pkgToFieldTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToFieldTypeParameter
pkgToImplementingClassback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToImplementingClass
pkgToImplementsTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToImplementsTypeParameter
pkgToMethodAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodAnnotations
pkgToMethodArgsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodArgs
pkgToMethodArgTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodArgTypeParameter
pkgToMethodParameterAnnotationsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodParameterAnnotations
pkgToMethodReturnback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodReturn
pkgToMethodReturnTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodReturnTypeParameter
pkgToMethodThrowsback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodThrows
pkgToMethodTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToMethodTypeParameter
pkgToPackageAnnotationsback to summary
pack-priv Set<PackageElement> pkgToPackageAnnotations
pkgToSubclassback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToSubclass
pkgToSubclassTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToSubclassTypeParameter
pkgToSubinterfaceback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToSubinterface
pkgToSubinterfaceTypeParameterback to summary
pack-priv final Map<PackageElement, List<Element>> pkgToSubinterfaceTypeParameter
typeElementback to summary
pack-priv final TypeElement typeElement

Constructor Detail

ClassUseWriterback to summary
public ClassUseWriter(HtmlConfiguration configuration, ClassUseMapper mapper, TypeElement typeElement)

Creates a writer for a page listing the uses of a type element.

Parameters
configuration:HtmlConfiguration

the configuration

mapper:ClassUseMapper

a "mapper" containing the usage information

typeElement:TypeElement

the type element

Method Detail

addClassListback to summary
protected void addClassList(Content content)

Add the class elements that use the given class.

Parameters
content:Content

the content to which the class elements will be added

addClassUseback to summary
protected void addClassUse(Content content)

Add the class use documentation.

Parameters
content:Content

the content to which the class use information will be added

addClassUseback to summary
protected void addClassUse(PackageElement pkg, Content content)

Add the class use information.

Parameters
pkg:PackageElement

the package that uses the given class

content:Content

the content to which the class use information will be added

addPackageAnnotationListback to summary
protected void addPackageAnnotationList(Content content)

Add the package annotation elements.

Parameters
content:Content

the content to which the package annotation elements will be added

addPackageListback to summary
protected void addPackageList(Content content)

Add the packages elements that use the given class.

Parameters
content:Content

the content to which the packages elements will be added

addPackageUseback to summary
protected void addPackageUse(PackageElement pkg, Table<?> table)

Add the package use information.

Parameters
pkg:PackageElement

the package that uses the given class

table:Table<?>

the table to which the package use information will be added

buildPageback to summary
public void buildPage() throws DocFileIOException

Implements abstract jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.buildPage.

Generate the class use elements.

Annotations
@Override
Exceptions
DocFileIOException:
if there is a problem while generating the documentation
generateback to summary
public static void generate(HtmlConfiguration configuration, ClassTree classTree) throws DocletException

Write out class use and package use pages.

Parameters
configuration:HtmlConfiguration

the configuration for this doclet

classTree:ClassTree

the class tree hierarchy

Exceptions
DocletException:
if there is an error while generating the documentation
getClassUseHeaderback to summary
protected HtmlTree getClassUseHeader()

Get the header for the class use listing.

Returns:HtmlTree

the class use header

pathForback to summary
private static DocPath pathFor(HtmlConfiguration configuration, TypeElement typeElement)
pkgDivideback to summary
private Map<PackageElement, List<Element>> pkgDivide(Map<TypeElement, ? extends List<? extends Element>> classMap)