com.sun.tools.doclets.formats.html
Class AbstractPackageIndexWriter

java.lang.Object
  java.io.Writer
      java.io.PrintWriter
          com.sun.tools.doclets.formats.html.markup.HtmlWriter
              com.sun.tools.doclets.formats.html.markup.HtmlDocWriter
                  com.sun.tools.doclets.formats.html.HtmlDocletWriter
                      com.sun.tools.doclets.formats.html.AbstractPackageIndexWriter

All Implemented Interfaces:

java.io.Closeable, java.io.Flushable, java.lang.Appendable

Direct Known Subclasses:

PackageIndexFrameWriter, PackageIndexWriter

public abstract class AbstractPackageIndexWriter
extends HtmlDocletWriter

Abstract class to generate the overview files in Frame and Non-Frame format. This will be sub-classed by to generate overview-frame.html as well as overview-summary.html.

Field Summary

protected PackageDoc[]

packages Array of Packages to be documented.

Fields inherited from class com.sun.tools.doclets.formats.html.HtmlDocletWriter

configuration, displayLength, filename, path, relativePath, relativepathNoSlash

Fields inherited from class com.sun.tools.doclets.formats.html.markup.HtmlWriter

fileseparator, htmlFilename, winTitle

Fields inherited from class java.io.PrintWriter

out

Fields inherited from class java.io.Writer

lock

Constructor Summary

AbstractPackageIndexWriter(ConfigurationImpl configuration, java.lang.String filename)
Constructor.

Method Summary

protected void	generateIndex() Generate the frame or non-frame package index.
protected void	generatePackageIndexFile(java.lang.String title, boolean includeScript) Generate the contants in the package index file.
protected void	navLinkContents() Highlight "Overview" in the strong format, in the navigation bar as this is the overview page.
protected void	printAllClassesPackagesLink() Do nothing.
protected void	printConfigurationTitle() Print the doctitle, if it is specified on the command line.
protected void	printIndexContents(PackageDoc[] packages, java.lang.String text) Generate code for package index contents.
protected abstract void	printIndexFooter()
protected abstract void	printIndexHeader(java.lang.String text)
protected abstract void	printIndexRow(PackageDoc pkg)
protected abstract void	printNavigationBarFooter()
protected abstract void	printNavigationBarHeader()
protected void	printOverview() Default to no overview, overwrite to add overview.
protected abstract void	printOverviewHeader()

Methods inherited from class com.sun.tools.doclets.formats.html.HtmlDocletWriter

anchor, commentTagsToString, configuration, frame, frameEnd, frameSet, frameSetEnd, getAnchor, getCrossClassLink, getCrossPackageLink, getDocLink, getDocLink, getLink, getPackageLink, getPackageLink, getPreQualifiedClassLink, getTagletWriterInstance, getTypeParameterLinks, isClassLinkable, isCoreClass, italicsClassName, navCellEnd, navCellRevStart, navCellStart, navDetail, navHideLists, navLinkClass, navLinkClassIndex, navLinkClassUse, navLinkDeprecated, navLinkHelp, navLinkIndex, navLinkMainTree, navLinkNext, navLinkNext, navLinkPackage, navLinkPackage, navLinkPrevious, navLinkPrevious, navLinks, navLinkTree, navShowLists, navShowLists, navSummary, pathString, pathString, pathToClass, printBottom, printDocLink, printDocLink, printHtmlHeader, printIndexHeading, printInlineComment, printInlineComment, printInlineDeprecatedComment, printInlineDeprecatedComment, printLink, printNoFramesTargetHyperLink, printPackageLink, printPackageLink, printPreQualifiedClassLink, printPreQualifiedStrongClassLink, printQualifiedClassLink, printSrcLink, printStyleSheetProperties, printSummaryComment, printSummaryComment, printSummaryDeprecatedComment, printSummaryDeprecatedComment, printSummaryDetailLinks, printTags, printTagsInfoFooter, printTagsInfoHeader, printTargetPackageLink, printText, printText, printText, printTop, printUserHeaderFooter, removeNonInlineHtmlTags, replace, replaceDocRootDir, seeTagToString, strongText, strongText, strongText, summaryRow, summaryRowEnd, tableHeaderEnd, tableHeaderStart, tableHeaderStart, tableHeaderStart, tableHeaderStart, tableIndexDetail, tableIndexSummary, tableInheritedHeaderEnd, tableInheritedHeaderStart, tableUseInfoHeaderStart, tdIndex, writeAnnotationInfo, writeAnnotationInfo, writeAnnotationInfo

Methods inherited from class com.sun.tools.doclets.formats.html.markup.HtmlDocWriter

getHyperLink, getHyperLink, getHyperLink, getHyperLink, getPkgName, printBodyHtmlEnd, printFooter, printFrameFooter, printFramesetHeader, printFramesetHeader, printHyperLink, printHyperLink, printHyperLink, printHyperLink, printNbsps, printPkgName, spaces, today

Methods inherited from class com.sun.tools.doclets.formats.html.markup.HtmlWriter

address, addressEnd, aEnd, aName, anchor, anchor, blockquote, blockquoteEnd, body, bodyEnd, br, center, centerEnd, code, codeEnd, codeText, commentEnd, commentStart, dd, ddEnd, dl, dlEnd, dt, em, emEnd, font, fontEnd, fontNoNewLine, fontSizeStyle, fontStyle, getCode, getCodeEnd, getFontColor, getFontEnd, getStrong, getStrongEnd, getWindowTitleOnload, h1, h1, h1End, h2, h2, h2End, h3, h3, h3End, h4, h4, h4End, h5, h5End, head, headEnd, hr, hr, hr, html, htmlEnd, img, italic, italicEnd, italics, italicsText, li, li, link, menu, menuEnd, noFrames, noFramesEnd, noScript, noScriptEnd, p, pEnd, pre, preEnd, preNoNewLine, printWinTitleScript, script, scriptEnd, space, strong, strong, strongEnd, sup, supEnd, table, table, table, table, tableEnd, td, tdAlign, tdAlignRowspan, tdAlignVAlign, tdAlignVAlignRowspan, tdBgcolorStyle, tdColspan, tdColspanBgcolorStyle, tdEnd, tdNowrap, tdVAlign, tdVAlignClass, tdWidth, thAlign, thAlignColspan, thAlignNowrap, thEnd, title, title, titleEnd, tr, trAlignVAlign, trBgcolor, trBgcolorStyle, trEnd, ul, ulEnd

Methods inherited from class java.io.PrintWriter

append, append, append, checkError, close, flush, format, format, print, print, print, print, print, print, print, print, print, printf, printf, println, println, println, println, println, println, println, println, println, println, setError, write, write, write, write, write

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

packages

protected PackageDoc[] packages

Array of Packages to be documented.

Constructor Detail

AbstractPackageIndexWriter

public AbstractPackageIndexWriter(ConfigurationImpl configuration,
                                  java.lang.String filename)
                           throws java.io.IOException

Constructor. Also initialises the packages variable.

Parameters:

filename - Name of the package index file to be generated.

Throws:

java.io.IOException

Method Detail

printNavigationBarHeader

protected abstract void printNavigationBarHeader()

printNavigationBarFooter

protected abstract void printNavigationBarFooter()

printOverviewHeader

protected abstract void printOverviewHeader()

printIndexHeader

protected abstract void printIndexHeader(java.lang.String text)

printIndexRow

protected abstract void printIndexRow(PackageDoc pkg)

printIndexFooter

protected abstract void printIndexFooter()

generatePackageIndexFile

protected void generatePackageIndexFile(java.lang.String title,
                                        boolean includeScript)
                                 throws java.io.IOException

Generate the contants in the package index file. Call appropriate methods from the sub-class in order to generate Frame or Non Frame format.

Parameters:

title - the title of the window.

includeScript - boolean set true if windowtitle script is to be included

Throws:

java.io.IOException

printOverview

protected void printOverview()
                      throws java.io.IOException

Default to no overview, overwrite to add overview.

Throws:

java.io.IOException

generateIndex

protected void generateIndex()

Generate the frame or non-frame package index.

printIndexContents

protected void printIndexContents(PackageDoc[] packages,
                                  java.lang.String text)

Generate code for package index contents. Call appropriate methods from the sub-classes.

Parameters:

packages - Array of packages to be documented.

text - String which will be used as the heading.

printConfigurationTitle

protected void printConfigurationTitle()

Print the doctitle, if it is specified on the command line.

navLinkContents

protected void navLinkContents()

Highlight "Overview" in the strong format, in the navigation bar as this is the overview page.

Overrides:

navLinkContents in class HtmlDocletWriter

printAllClassesPackagesLink

protected void printAllClassesPackagesLink()

Do nothing. This will be overridden in PackageIndexFrameWriter.