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

public abstract Class AbstractOverviewIndexWriter

extends HtmlDocletWriter
Class Inheritance
Known Direct Subclasses
jdk.javadoc.internal.doclets.formats.html.PackageIndexWriter, jdk.javadoc.internal.doclets.formats.html.ModuleIndexWriter
Imports
jdk.javadoc.internal.doclets.formats.html.Navigation.PageMode, jdk.javadoc.internal.doclets.formats.html.markup.BodyContents, .HtmlStyles, jdk.javadoc.internal.doclets.toolkit.util.DocFileIOException, .DocPath, jdk.javadoc.internal.html.Content, .ContentBuilder, .HtmlTree, .RawHtml

Abstract class to generate the top-level "overview" files.

Field Summary

Inherited from jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter:
comparatorsconfigurationcontentsdocPathshtmlIdsindexAnchorTablelinksmainBodyScriptmessagesoptionspathpathToRootresourcestableOfContentsutilswinTitle

Constructor Summary

AccessConstructor and Description
public
AbstractOverviewIndexWriter(HtmlConfiguration
The current configuration
configuration
,
DocPath
Name of the module index file to be generated.
filename
)

Constructs the AbstractOverviewIndexWriter.

Method Summary

Modifier and TypeMethod and Description
protected void
addConfigurationTitle(Content
the content to which the title will be added
target
)

Adds the doctitle to the documentation, if it is specified on the command line.

protected abstract void
addIndex(Content
the content to which the packages/modules list will be added
target
)

Adds the index to the documentation.

protected void
addOverviewComment(Content
the content to which the overview comment will be added
content
)

Adds the overview comment as provided in the file specified by the "-overview" option on the command line.

protected void
addOverviewHeader(Content
the content to which the overview header will be added
target
)

Adds the overview summary comment for this documentation.

protected void
addOverviewTags(Content
the content to which the tags will be added
content
)

Adds the block tags provided in the file specified by the "-overview" option.

public void
buildPage()

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

The top-level method to generate and write the page represented by this writer.

protected abstract String

Returns:

the page description, for the <meta> element
getDescription
()

Returns the page description, for the <meta> element.

protected abstract String

Returns:

the title for the page
getTitleKey
()

Returns the title for the page.

public boolean
isIndexable()

Overrides jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.isIndexable.

Returns true if the page written by this writer should be indexed, false otherwise.

Inherited from jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter:
addInlineCommentaddInlineCommentaddInlineDeprecatedCommentaddPreQualifiedClassLinkaddPreQualifiedClassLinkaddPreQualifiedStrongClassLinkaddPreviewCommentaddPreviewInfoaddPreviewSummaryaddRestrictedInfoaddRestrictedSummaryaddSrcLinkaddSummaryCommentaddSummaryCommentaddSummaryDeprecatedCommentaddTagsInfocommentTagsToContentcommentTagsToContentcommentTagsToContentcreateTableOfContentsgetAnnotationInfogetAnnotationInfogetAnnotationsgetBlockTagOutputgetBlockTagOutputgetBodygetBodyStylegetCrossClassLinkgetCrossModuleLinkgetCrossPackageLinkgetCurrentTypeElementgetDeprecatedPhrasegetDescriptiongetDocLinkgetDocLinkgetDocLinkgetDocLinkgetDocLinkgetEnclosingPackageNamegetFileTitlegetFootergetGeneratorgetHeadergetHeadergetLinkgetLocalizedPackageNamegetLocalStylesheetsgetModuleLinkgetModuleLinkgetNavBargetNavLinkToOverviewTreegetPackageLabelgetPackageLinkgetPackageLinkgetPackageTableHeadergetPreQualifiedClassLinkgetQualifiedClassLinkgetTagletWriterInstancegetTagletWriterInstancegetTypeParameterLinksgetWindowTitlehasSerializationOverviewTagsignoreNonInlineTaginvalidTagOutputpathStringpathStringprintHtmlDocumentprintHtmlDocumentprintHtmlDocumentreplaceDocRootDirresolveExternalSpecURIwriteGenerating

Constructor Detail

AbstractOverviewIndexWriterback to summary
public AbstractOverviewIndexWriter(HtmlConfiguration configuration, DocPath filename)

Constructs the AbstractOverviewIndexWriter.

Parameters
configuration:HtmlConfiguration

The current configuration

filename:DocPath

Name of the module index file to be generated.

Method Detail

addConfigurationTitleback to summary
protected void addConfigurationTitle(Content target)

Adds the doctitle to the documentation, if it is specified on the command line.

Parameters
target:Content

the content to which the title will be added

addIndexback to summary
protected abstract void addIndex(Content target)

Adds the index to the documentation.

Parameters
target:Content

the content to which the packages/modules list will be added

addOverviewCommentback to summary
protected void addOverviewComment(Content content)

Adds the overview comment as provided in the file specified by the "-overview" option on the command line.

Parameters
content:Content

the content to which the overview comment will be added

addOverviewHeaderback to summary
protected void addOverviewHeader(Content target)

Adds the overview summary comment for this documentation. Add one line summary at the top of the page and generate a link to the description, which is added at the end of this page.

Parameters
target:Content

the content to which the overview header will be added

addOverviewTagsback to summary
protected void addOverviewTags(Content content)

Adds the block tags provided in the file specified by the "-overview" option.

Parameters
content:Content

the content to which the tags will be added

buildPageback to summary
public void buildPage() throws DocFileIOException

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

Doc from jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.buildPage.

The top-level method to generate and write the page represented by this writer.

Annotations
@Override
getDescriptionback to summary
protected abstract String getDescription()

Returns the page description, for the <meta> element.

Returns:String

the page description, for the <meta> element

getTitleKeyback to summary
protected abstract String getTitleKey()

Returns the title for the page.

Returns:String

the title for the page

isIndexableback to summary
public boolean isIndexable()

Overrides jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.isIndexable.

Doc from jdk.javadoc.internal.doclets.formats.html.HtmlDocletWriter.isIndexable.

Returns true if the page written by this writer should be indexed, false otherwise. Some pages merely aggregate filtered information available on other pages and, thus, have no indexing value. In fact, if indexed, they would clutter the index and mislead the reader.

Annotations
@Override