net.sourceforge.htmlunit.cyberneko

Class HTMLConfiguration

java.lang.Object

net.sourceforge.htmlunit.xerces.util.ParserConfigurationSettings

net.sourceforge.htmlunit.cyberneko.HTMLConfiguration

All Implemented Interfaces:

XMLComponentManager, XMLParserConfiguration

public class HTMLConfiguration
extends ParserConfigurationSettings
implements XMLParserConfiguration

An XNI-based parser configuration that can be used to parse HTML documents. This configuration can be used directly in order to parse HTML documents or can be used in conjunction with any XNI based tools, such as the Xerces2 implementation.

This configuration recognizes the following features:

• http://cyberneko.org/html/features/augmentations
• http://cyberneko.org/html/features/report-errors
• http://cyberneko.org/html/features/report-errors/simple
• and
• the features supported by the scanner and tag balancer components.

This configuration recognizes the following properties:

• http://cyberneko.org/html/properties/names/elems
• http://cyberneko.org/html/properties/names/attrs
• http://cyberneko.org/html/properties/filters
• http://cyberneko.org/html/properties/error-reporter
• and
• the properties supported by the scanner and tag balancer.

For complete usage information, refer to the documentation.

Author:

Andy Clark

See Also:

HTMLScanner, HTMLTagBalancer, HTMLErrorReporter

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	HTMLConfiguration.ErrorReporter Defines an error reporter for reporting HTML errors.

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	AUGMENTATIONS Include infoset augmentations.
protected static String	ERROR_DOMAIN Error domain.
protected static String	ERROR_REPORTER Error reporter.
protected boolean	fCloseStream Stream opened by parser.
protected XMLDocumentHandler	fDocumentHandler Document handler.
protected HTMLScanner	fDocumentScanner Document scanner.
protected XMLErrorHandler	fErrorHandler Error handler.
protected HTMLErrorReporter	fErrorReporter Error reporter.
protected List<HTMLComponent>	fHTMLComponents Components.
protected static String	FILTERS Pipeline filters.
protected NamespaceBinder	fNamespaceBinder Namespace binder.
protected HTMLTagBalancer	fTagBalancer HTML tag balancer.
HTMLElements	htmlElements_
protected static String	NAMES_ATTRS Modify HTML attribute names: { "upper", "lower", "default" }.
protected static String	NAMES_ELEMS Modify HTML element names: { "upper", "lower", "default" }.
protected static String	NAMESPACES Namespaces.
protected static String	REPORT_ERRORS Report errors.
protected static String	SIMPLE_ERROR_FORMAT Simple report format.

Fields inherited from class net.sourceforge.htmlunit.xerces.util.ParserConfigurationSettings

fFeatures, fProperties, fRecognizedFeatures, fRecognizedProperties

Constructor Summary

Constructors

Constructor and Description
HTMLConfiguration() Default constructor.
HTMLConfiguration(HTMLElements htmlElements)

Method Summary

Modifier and Type	Method and Description
protected void	addComponent(HTMLComponent component)
void	cleanup() If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing.
protected HTMLScanner	createDocumentScanner()
void	evaluateInputSource(XMLInputSource inputSource) EXPERIMENTAL: may change in next release Immediately evaluates an input source and add the new content (e.g.
XMLDocumentHandler	getDocumentHandler()
XMLErrorHandler	getErrorHandler()
boolean	parse(boolean complete) Parses the document in a pull parsing fashion.
void	parse(XMLInputSource source) Parses a document.
void	pushInputSource(XMLInputSource inputSource) Pushes an input source onto the current entity stack.
protected void	reset() Resets the parser configuration.
void	setDocumentHandler(XMLDocumentHandler handler) Sets the document handler to receive information about the document.
void	setErrorHandler(XMLErrorHandler handler) Sets the error handler.
void	setFeature(String featureId, boolean state) Set the state of a feature.
void	setInputSource(XMLInputSource inputSource) Sets the input source for the document to parse.
void	setProperty(String propertyId, Object value) setProperty

Methods inherited from class net.sourceforge.htmlunit.xerces.util.ParserConfigurationSettings

addRecognizedFeatures, addRecognizedProperties, checkFeature, checkProperty, getFeature, getProperty

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sourceforge.htmlunit.xerces.xni.parser.XMLParserConfiguration

addRecognizedFeatures, addRecognizedProperties, getFeature, getProperty

Field Detail

NAMESPACES

protected static final String NAMESPACES

Namespaces.

See Also:

Constant Field Values

AUGMENTATIONS

protected static final String AUGMENTATIONS

Include infoset augmentations.

See Also:

Constant Field Values

REPORT_ERRORS

protected static final String REPORT_ERRORS

Report errors.

See Also:

Constant Field Values

SIMPLE_ERROR_FORMAT

protected static final String SIMPLE_ERROR_FORMAT

Simple report format.

See Also:

Constant Field Values

NAMES_ELEMS

protected static final String NAMES_ELEMS

Modify HTML element names: { "upper", "lower", "default" }.

See Also:

Constant Field Values

NAMES_ATTRS

protected static final String NAMES_ATTRS

Modify HTML attribute names: { "upper", "lower", "default" }.

See Also:

Constant Field Values

FILTERS

protected static final String FILTERS

Pipeline filters.

See Also:

Constant Field Values

ERROR_REPORTER

protected static final String ERROR_REPORTER

Error reporter.

See Also:

Constant Field Values

ERROR_DOMAIN

protected static final String ERROR_DOMAIN

Error domain.

See Also:

Constant Field Values

fDocumentHandler

protected XMLDocumentHandler fDocumentHandler

Document handler.

fErrorHandler

protected XMLErrorHandler fErrorHandler

Error handler.

fCloseStream

protected boolean fCloseStream

Stream opened by parser. Therefore, must close stream manually upon termination of parsing.

fHTMLComponents

protected final List<HTMLComponent> fHTMLComponents

Components.

fDocumentScanner

protected final HTMLScanner fDocumentScanner

Document scanner.

fTagBalancer

protected final HTMLTagBalancer fTagBalancer

HTML tag balancer.

fNamespaceBinder

protected final NamespaceBinder fNamespaceBinder

Namespace binder.

fErrorReporter

protected final HTMLErrorReporter fErrorReporter

Error reporter.

htmlElements_

public final HTMLElements htmlElements_

Constructor Detail

HTMLConfiguration

public HTMLConfiguration()

Default constructor.

HTMLConfiguration

public HTMLConfiguration(HTMLElements htmlElements)

Method Detail

createDocumentScanner

protected HTMLScanner createDocumentScanner()

pushInputSource

public void pushInputSource(XMLInputSource inputSource)

Pushes an input source onto the current entity stack. This enables the scanner to transparently scan new content (e.g. the output written by an embedded script). At the end of the current entity, the scanner returns where it left off at the time this entity source was pushed.

Hint: To use this feature to insert the output of <SCRIPT> tags, remember to buffer the entire output of the processed instructions before pushing a new input source. Otherwise, events may appear out of sequence.

Parameters:

inputSource - The new input source to start scanning.

See Also:

evaluateInputSource(XMLInputSource)

evaluateInputSource

public void evaluateInputSource(XMLInputSource inputSource)

EXPERIMENTAL: may change in next release
Immediately evaluates an input source and add the new content (e.g. the output written by an embedded script).

Parameters:

inputSource - The new input source to start scanning.

See Also:

pushInputSource(XMLInputSource)

setFeature

public void setFeature(String featureId,
                       boolean state)
                throws XMLConfigurationException

Description copied from class: ParserConfigurationSettings

Set the state of a feature.

Set the state of any feature in a SAX2 parser. The parser might not recognize the feature, and if it does recognize it, it might not be able to fulfill the request.

Specified by:

setFeature in interface XMLParserConfiguration

Overrides:

setFeature in class ParserConfigurationSettings

Parameters:

featureId - The unique identifier (URI) of the feature.

state - The requested state of the feature (true or false).

Throws:

XMLConfigurationException - Thrown if there is a configuration error.

setProperty

public void setProperty(String propertyId,
                        Object value)
                 throws XMLConfigurationException

Description copied from class: ParserConfigurationSettings

setProperty

Specified by:

setProperty in interface XMLParserConfiguration

Overrides:

setProperty in class ParserConfigurationSettings

Parameters:

propertyId - the property id

value - the value

Throws:

XMLConfigurationException - Thrown if there is a configuration error.

setDocumentHandler

public void setDocumentHandler(XMLDocumentHandler handler)

Description copied from interface: XMLParserConfiguration

Sets the document handler to receive information about the document.

Specified by:

setDocumentHandler in interface XMLParserConfiguration

Parameters:

handler - The document handler.

getDocumentHandler

public XMLDocumentHandler getDocumentHandler()

Specified by:

getDocumentHandler in interface XMLParserConfiguration

Returns:

the document handler.

setErrorHandler

public void setErrorHandler(XMLErrorHandler handler)

Description copied from interface: XMLParserConfiguration

Sets the error handler.

Specified by:

setErrorHandler in interface XMLParserConfiguration

Parameters:

handler - The error resolver.

getErrorHandler

public XMLErrorHandler getErrorHandler()

Specified by:

getErrorHandler in interface XMLParserConfiguration

Returns:

the error handler.

parse

public void parse(XMLInputSource source)
           throws XNIException,
                  IOException

Parses a document.

Specified by:

parse in interface XMLParserConfiguration

Parameters:

source - The input source for the top-level of the XML document.

Throws:

XNIException - Any XNI exception, possibly wrapping another exception.

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.

setInputSource

public void setInputSource(XMLInputSource inputSource)
                    throws XMLConfigurationException,
                           IOException

Sets the input source for the document to parse.

Specified by:

setInputSource in interface XMLParserConfiguration

Parameters:

inputSource - The document's input source.

Throws:

XMLConfigurationException - Thrown if there is a configuration error when initializing the parser.

IOException - Thrown on I/O error.

See Also:

parse(boolean)

parse

public boolean parse(boolean complete)
              throws XNIException,
                     IOException

Parses the document in a pull parsing fashion.

Specified by:

parse in interface XMLParserConfiguration

Parameters:

complete - True if the pull parser should parse the remaining document completely.

Returns:

True if there is more document to parse.

Throws:

XNIException - Any XNI exception, possibly wrapping another exception.

IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.

See Also:

setInputSource(net.sourceforge.htmlunit.xerces.xni.parser.XMLInputSource)

cleanup

public void cleanup()

If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing. For example, close all opened streams.

Specified by:

cleanup in interface XMLParserConfiguration

addComponent

protected void addComponent(HTMLComponent component)

reset

protected void reset()
              throws XMLConfigurationException

Resets the parser configuration.

Throws:

XMLConfigurationException