APIdia Launch Partner
Top Description Inners Fields Constructors Methods
jdk.javadoc.internal.doclets.toolkit.util

public abstract Class SummaryAPIListBuilder

extends Object
Class Inheritance
Known Direct Subclasses
jdk.javadoc.internal.doclets.toolkit.util.DeprecatedAPIListBuilder, jdk.javadoc.internal.doclets.toolkit.util.NewAPIBuilder, jdk.javadoc.internal.doclets.toolkit.util.PreviewAPIListBuilder, jdk.javadoc.internal.doclets.toolkit.util.RestrictedAPIListBuilder
Imports
java.util.*, javax.lang.model.element.Element, .ModuleElement, .PackageElement, .RecordComponentElement, .TypeElement, jdk.javadoc.internal.doclets.toolkit.BaseConfiguration

Build list of all the summary packages, classes, constructors, fields and methods.

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static enum

Field Summary

Modifier and TypeField and Description
protected final BaseConfiguration
private final Map<SummaryAPIListBuilder.SummaryElementKind, SortedSet<Element>>
summaryMap

List of summary type Lists.

protected final Utils

Constructor Summary

AccessConstructor and Description
protected
SummaryAPIListBuilder(BaseConfiguration
the current configuration of the doclet
configuration
)

Constructor.

Method Summary

Modifier and TypeMethod and Description
protected abstract boolean

Returns:

true if the element should be included
belongsToSummary
(Element
an element
element
)

This method decides whether Element element should be included in this summary list.

protected void
buildSummaryAPIInfo()

Build the sorted list of all the summary APIs in this run.

private void
composeSummaryList(SortedSet<Element>
set of summary elements
sset
,
List<? extends Element>
members to be added in the list
members
)

Add the members into a single list of summary members.

protected final SortedSet<Element>

Returns:

a summary set
createSummarySet
()

Create a summary set of elements.

public SortedSet<Element>

Returns:

the set
getSet
(SummaryAPIListBuilder.SummaryElementKind
the SummaryElementKind
kind
)

Return the set of summary elements of a given type.

protected void
handleElement(Element
element to process
e
)

Additional extra processing of an included element.

public boolean
hasDocumentation(SummaryAPIListBuilder.SummaryElementKind
the type of list being checked.
kind
)

Return true if the list of a given type has size greater than 0.

public boolean
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

configurationback to summary
protected final BaseConfiguration configuration
summaryMapback to summary
private final Map<SummaryAPIListBuilder.SummaryElementKind, SortedSet<Element>> summaryMap

List of summary type Lists.

utilsback to summary
protected final Utils utils

Constructor Detail

SummaryAPIListBuilderback to summary
protected SummaryAPIListBuilder(BaseConfiguration configuration)

Constructor.

Parameters
configuration:BaseConfiguration

the current configuration of the doclet

Method Detail

belongsToSummaryback to summary
protected abstract boolean belongsToSummary(Element element)

This method decides whether Element element should be included in this summary list.

Parameters
element:Element

an element

Returns:boolean

true if the element should be included

buildSummaryAPIInfoback to summary
protected void buildSummaryAPIInfo()

Build the sorted list of all the summary APIs in this run. Build separate lists for summary modules, packages, classes, constructors, methods and fields.

composeSummaryListback to summary
private void composeSummaryList(SortedSet<Element> sset, List<? extends Element> members)

Add the members into a single list of summary members.

Parameters
sset:SortedSet<Element>

set of summary elements

members:List<? extends Element>

members to be added in the list

createSummarySetback to summary
protected final SortedSet<Element> createSummarySet()

Create a summary set of elements.

Returns:SortedSet<Element>

a summary set

getSetback to summary
public SortedSet<Element> getSet(SummaryAPIListBuilder.SummaryElementKind kind)

Return the set of summary elements of a given type.

Parameters
kind:SummaryAPIListBuilder.SummaryElementKind

the SummaryElementKind

Returns:SortedSet<Element>

the set

handleElementback to summary
protected void handleElement(Element e)

Additional extra processing of an included element.

Parameters
e:Element

element to process

hasDocumentationback to summary
public boolean hasDocumentation(SummaryAPIListBuilder.SummaryElementKind kind)

Return true if the list of a given type has size greater than 0.

Parameters
kind:SummaryAPIListBuilder.SummaryElementKind

the type of list being checked.

isEmptyback to summary
public boolean isEmpty()
jdk.javadoc.internal.doclets.toolkit.util back to summary

public final Enum SummaryAPIListBuilder.SummaryElementKind

extends Enum<SummaryAPIListBuilder.SummaryElementKind>
Class Inheritance

Field Summary

Modifier and TypeField and Description
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind
public static final SummaryAPIListBuilder.SummaryElementKind

Constructor Summary

AccessConstructor and Description
private

Method Summary

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

Field Detail

ANNOTATION_TYPEback to summary
public static final SummaryAPIListBuilder.SummaryElementKind ANNOTATION_TYPE
ANNOTATION_TYPE_MEMBERback to summary
public static final SummaryAPIListBuilder.SummaryElementKind ANNOTATION_TYPE_MEMBER
CLASSback to summary
public static final SummaryAPIListBuilder.SummaryElementKind CLASS
CONSTRUCTORback to summary
public static final SummaryAPIListBuilder.SummaryElementKind CONSTRUCTOR
ENUMback to summary
public static final SummaryAPIListBuilder.SummaryElementKind ENUM
ENUM_CONSTANTback to summary
public static final SummaryAPIListBuilder.SummaryElementKind ENUM_CONSTANT
EXCEPTION_CLASSback to summary
public static final SummaryAPIListBuilder.SummaryElementKind EXCEPTION_CLASS
FIELDback to summary
public static final SummaryAPIListBuilder.SummaryElementKind FIELD
INTERFACEback to summary
public static final SummaryAPIListBuilder.SummaryElementKind INTERFACE
METHODback to summary
public static final SummaryAPIListBuilder.SummaryElementKind METHOD
MODULEback to summary
public static final SummaryAPIListBuilder.SummaryElementKind MODULE
PACKAGEback to summary
public static final SummaryAPIListBuilder.SummaryElementKind PACKAGE
RECORD_CLASSback to summary
public static final SummaryAPIListBuilder.SummaryElementKind RECORD_CLASS

Constructor Detail

SummaryElementKindback to summary
private SummaryElementKind()

Method Detail

valueOfback to summary
public static SummaryAPIListBuilder.SummaryElementKind valueOf(String name)
valuesback to summary
public static SummaryAPIListBuilder.SummaryElementKind[] values()