javax.help
Interface TreeItemFactory

All Known Implementing Classes:

FavoritesView.DefaultFavoritesFactory, IndexView.DefaultIndexFactory, TOCView.DefaultTOCFactory

public interface TreeItemFactory

A factory for creating TreeItems. This can be used to reuse the parsers.

Method Summary

TreeItem	createItem() Creates a default TreeItem.
TreeItem	createItem(java.lang.String tagName, java.util.Hashtable attributes, HelpSet hs, java.util.Locale locale) Creates a TreeItem from the given data.
java.util.Enumeration	listMessages() Lists all the error messages.
javax.swing.tree.DefaultMutableTreeNode	parsingEnded(javax.swing.tree.DefaultMutableTreeNode node) Ends parsing.
void	parsingStarted(java.net.URL source) Starts parsing.
void	processDOCTYPE(java.lang.String root, java.lang.String publicID, java.lang.String systemID) Processes a DOCTYPE.
void	processPI(HelpSet hs, java.lang.String target, java.lang.String data) A Processing Instruction.
void	reportMessage(java.lang.String msg, boolean validParse) Reports a parsing error.

Method Detail

parsingStarted

public void parsingStarted(java.net.URL source)

Starts parsing.

Parameters:

source - The URL of the document being parsed.

processDOCTYPE

public void processDOCTYPE(java.lang.String root,
                           java.lang.String publicID,
                           java.lang.String systemID)

Processes a DOCTYPE.

Parameters:

root - The root tag of the document.

publicID - PublicID from the DOCTYPE.

systemID - SystemID from the DOCTYPE.

processPI

public void processPI(HelpSet hs,
                      java.lang.String target,
                      java.lang.String data)

A Processing Instruction.

Parameters:

target - The target of the PI.

data - A String for the data in the PI.

createItem

public TreeItem createItem(java.lang.String tagName,
                           java.util.Hashtable attributes,
                           HelpSet hs,
                           java.util.Locale locale)

Creates a TreeItem from the given data.

Parameters:

tagName - The name of the tag (for example, treeItem, or tocItem)

attributes - A hashtable with all the attributes. Null is a valid value.

hs - A HelpSet that provides context.

Returns:

A TreeItem.

createItem

public TreeItem createItem()

Creates a default TreeItem.

Returns:

A TreeItem

reportMessage

public void reportMessage(java.lang.String msg,
                          boolean validParse)

Reports a parsing error.

Parameters:

msg - The message to report.

validParse - Whether the result of the parse is still valid.

listMessages

public java.util.Enumeration listMessages()

Lists all the error messages.

parsingEnded

public javax.swing.tree.DefaultMutableTreeNode parsingEnded(javax.swing.tree.DefaultMutableTreeNode node)

Ends parsing. Last chance to do something to the node. Return null to be sure the result is discarded.