Class HtmlDocumentBuilder
By default, when using the constructor without arguments, the
this parser coerces XML 1.0-incompatible infosets into XML 1.0-compatible
infosets. This corresponds to ALTER_INFOSET
as the general
XML violation policy. To make the parser support non-conforming HTML fully
per the HTML 5 spec while on the other hand potentially violating the SAX2
API contract, set the general XML violation policy to ALLOW
.
This does not work with a standard DOM implementation.
It is possible to treat XML 1.0 infoset violations as fatal by setting
the general XML violation policy to FATAL
.
The doctype is not represented in the tree.
The document mode is represented as user data DocumentMode
object with the key nu.validator.document-mode
on the document
node.
The form pointer is also stored as user data with the key
nu.validator.form-pointer
.
- Version:
- $Id$
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final List
<CharacterHandler> private boolean
private XmlViolationPolicy
private XmlViolationPolicy
private XmlViolationPolicy
private DoctypeExpectation
private DocumentModeHandler
private Driver
The tokenizer.private EntityResolver
The entity resolver.private ErrorHandler
private Heuristics
private boolean
private final DOMImplementation
The DOM impl.private boolean
private XmlViolationPolicy
private boolean
private boolean
private XmlViolationPolicy
private TransitionHandler
private final DOMTreeBuilder
The tree builder.private ErrorHandler
private XmlViolationPolicy
-
Constructor Summary
ConstructorsConstructorDescriptionInstantiates the document builder with the JAXP DOM implementation and the infoset-altering XML violation policy.HtmlDocumentBuilder
(XmlViolationPolicy xmlPolicy) Instantiates the document builder with the JAXP DOM implementation and a specific XML violation policy.HtmlDocumentBuilder
(DOMImplementation implementation) Instantiates the document builder with a specific DOM implementation and the infoset-altering XML violation policy.HtmlDocumentBuilder
(DOMImplementation implementation, XmlViolationPolicy xmlPolicy) Instantiates the document builder with a specific DOM implementation and XML violation policy. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addCharacterHandler
(CharacterHandler characterHandler) Deprecated.Returns the commentPolicy.Returns the contentNonXmlCharPolicy.Returns the contentSpacePolicy.Returns the doctype expectation.Returns theLocator
during parse.Returns the document mode handler.Returns the DOM implementationThe policy for non-NCName element and attribute names.Returns the streamabilityViolationPolicy.Returns the xmlnsPolicy.boolean
Indicates whether NFC normalization of source is being checked.boolean
Whether the HTML 4 mode reports boolean attributes in a way that repeats the name in the value.boolean
Whetherlang
is mapped toxml:lang
.boolean
Returnstrue
.boolean
Returns the reportingDoctype.boolean
Whether the parser considers scripting to be enabled for noscript treatment.boolean
Returnsfalse
private static DOMImplementation
Returns the JAXP DOM implementation.private void
lazyInit()
This class wraps different tree builders depending on configuration.For API compatibility.private Tokenizer
newTokenizer
(TokenHandler handler, boolean newAttributesEachTime) parse
(InputSource is) Parses a document from a SAXInputSource
.parseFragment
(InputSource is, String context) Parses a document fragment from a SAXInputSource
.void
setBogusXmlnsPolicy
(XmlViolationPolicy bogusXmlnsPolicy) Deprecated.void
setCheckingNormalization
(boolean enable) Toggles the checking of the NFC normalization of source.void
setCommentPolicy
(XmlViolationPolicy commentPolicy) Sets the policy for consecutive hyphens in comments.void
setContentNonXmlCharPolicy
(XmlViolationPolicy contentNonXmlCharPolicy) Sets the policy for non-XML characters except white space.void
setContentSpacePolicy
(XmlViolationPolicy contentSpacePolicy) Sets the policy for non-XML white space.void
setDoctypeExpectation
(DoctypeExpectation doctypeExpectation) Sets the doctype expectation.void
setDocumentModeHandler
(DocumentModeHandler documentModeHandler) Sets the document mode handler.void
setEntityResolver
(EntityResolver resolver) Sets the entity resolver for URI-only inputs.void
setErrorHandler
(ErrorHandler errorHandler) Sets the error handler.void
setHeuristics
(Heuristics heuristics) Sets the encoding sniffing heuristics.void
setHtml4ModeCompatibleWithXhtml1Schemata
(boolean html4ModeCompatibleWithXhtml1Schemata) Whether the HTML 4 mode reports boolean attributes in a way that repeats the name in the value.void
setIgnoringComments
(boolean ignoreComments) Sets whether comment nodes appear in the tree.void
setMappingLangToXmlLang
(boolean mappingLangToXmlLang) Whetherlang
is mapped toxml:lang
.void
setNamePolicy
(XmlViolationPolicy namePolicy) The policy for non-NCName element and attribute names.void
setReportingDoctype
(boolean reportingDoctype) void
setScriptingEnabled
(boolean scriptingEnabled) Sets whether the parser considers scripting to be enabled for noscript treatment.void
setStreamabilityViolationPolicy
(XmlViolationPolicy streamabilityViolationPolicy) Sets the streamabilityViolationPolicy.void
setTransitionHander
(TransitionHandler handler) void
setXmlnsPolicy
(XmlViolationPolicy xmlnsPolicy) Whether thexmlns
attribute on the root element is passed to through.void
setXmlPolicy
(XmlViolationPolicy xmlPolicy) This is a catch-all convenience method for setting name, xmlns, content space, content non-XML char and comment policies in one go.private void
tokenize
(InputSource is) Tokenizes the input source.Methods inherited from class javax.xml.parsers.DocumentBuilder
getSchema, isXIncludeAware, parse, parse, parse, parse, reset
-
Field Details
-
driver
The tokenizer. -
treeBuilder
The tree builder. -
implementation
The DOM impl. -
entityResolver
The entity resolver. -
errorHandler
-
documentModeHandler
-
doctypeExpectation
-
checkingNormalization
private boolean checkingNormalization -
scriptingEnabled
private boolean scriptingEnabled -
characterHandlers
-
contentSpacePolicy
-
contentNonXmlCharPolicy
-
commentPolicy
-
namePolicy
-
streamabilityViolationPolicy
-
html4ModeCompatibleWithXhtml1Schemata
private boolean html4ModeCompatibleWithXhtml1Schemata -
mappingLangToXmlLang
private boolean mappingLangToXmlLang -
xmlnsPolicy
-
reportingDoctype
private boolean reportingDoctype -
treeBuilderErrorHandler
-
heuristics
-
transitionHandler
-
-
Constructor Details
-
HtmlDocumentBuilder
Instantiates the document builder with a specific DOM implementation and XML violation policy.- Parameters:
implementation
- the DOM implementationxmlPolicy
- the policy
-
HtmlDocumentBuilder
Instantiates the document builder with a specific DOM implementation and the infoset-altering XML violation policy.- Parameters:
implementation
- the DOM implementation
-
HtmlDocumentBuilder
public HtmlDocumentBuilder()Instantiates the document builder with the JAXP DOM implementation and the infoset-altering XML violation policy. -
HtmlDocumentBuilder
Instantiates the document builder with the JAXP DOM implementation and a specific XML violation policy.- Parameters:
xmlPolicy
- the policy
-
-
Method Details
-
jaxpDOMImplementation
Returns the JAXP DOM implementation.- Returns:
- the JAXP DOM implementation
-
newTokenizer
-
lazyInit
private void lazyInit()This class wraps different tree builders depending on configuration. This method does the work of hiding this from the user of the class. -
tokenize
Tokenizes the input source.- Parameters:
is
- the source- Throws:
SAXException
- if stuff goes wrongIOException
- if IO goes wrongMalformedURLException
- if the system ID is malformed and the entity resolver isnull
-
getDOMImplementation
Returns the DOM implementation- Specified by:
getDOMImplementation
in classDocumentBuilder
- Returns:
- the DOM implementation
- See Also:
-
isNamespaceAware
public boolean isNamespaceAware()Returnstrue
.- Specified by:
isNamespaceAware
in classDocumentBuilder
- Returns:
true
- See Also:
-
isValidating
public boolean isValidating()Returnsfalse
- Specified by:
isValidating
in classDocumentBuilder
- Returns:
false
- See Also:
-
newDocument
For API compatibility.- Specified by:
newDocument
in classDocumentBuilder
- See Also:
-
parse
Parses a document from a SAXInputSource
.- Specified by:
parse
in classDocumentBuilder
- Parameters:
is
- the source- Returns:
- the doc
- Throws:
SAXException
- if stuff goes wrongIOException
- if IO goes wrong- See Also:
-
parseFragment
public DocumentFragment parseFragment(InputSource is, String context) throws IOException, SAXException Parses a document fragment from a SAXInputSource
.- Parameters:
is
- the sourcecontext
- the context element name- Returns:
- the doc
- Throws:
SAXException
- if stuff goes wrongIOException
- if IO goes wrong
-
setEntityResolver
Sets the entity resolver for URI-only inputs.- Specified by:
setEntityResolver
in classDocumentBuilder
- Parameters:
resolver
- the resolver- See Also:
-
setErrorHandler
Sets the error handler.- Specified by:
setErrorHandler
in classDocumentBuilder
- Parameters:
errorHandler
- the handler- See Also:
-
setTransitionHander
-
isCheckingNormalization
public boolean isCheckingNormalization()Indicates whether NFC normalization of source is being checked.- Returns:
true
if NFC normalization of source is being checked.- See Also:
-
setCheckingNormalization
public void setCheckingNormalization(boolean enable) Toggles the checking of the NFC normalization of source.- Parameters:
enable
-true
to check normalization- See Also:
-
setCommentPolicy
Sets the policy for consecutive hyphens in comments.- Parameters:
commentPolicy
- the policy- See Also:
-
setContentNonXmlCharPolicy
Sets the policy for non-XML characters except white space.- Parameters:
contentNonXmlCharPolicy
- the policy- See Also:
-
setContentSpacePolicy
Sets the policy for non-XML white space.- Parameters:
contentSpacePolicy
- the policy- See Also:
-
isScriptingEnabled
public boolean isScriptingEnabled()Whether the parser considers scripting to be enabled for noscript treatment.- Returns:
true
if enabled- See Also:
-
setScriptingEnabled
public void setScriptingEnabled(boolean scriptingEnabled) Sets whether the parser considers scripting to be enabled for noscript treatment.- Parameters:
scriptingEnabled
-true
to enable- See Also:
-
getDoctypeExpectation
Returns the doctype expectation.- Returns:
- the doctypeExpectation
-
setDoctypeExpectation
Sets the doctype expectation.- Parameters:
doctypeExpectation
- the doctypeExpectation to set- See Also:
-
getDocumentModeHandler
Returns the document mode handler.- Returns:
- the documentModeHandler
-
setDocumentModeHandler
Sets the document mode handler.- Parameters:
documentModeHandler
- the documentModeHandler to set- See Also:
-
getStreamabilityViolationPolicy
Returns the streamabilityViolationPolicy.- Returns:
- the streamabilityViolationPolicy
-
setStreamabilityViolationPolicy
Sets the streamabilityViolationPolicy.- Parameters:
streamabilityViolationPolicy
- the streamabilityViolationPolicy to set
-
setHtml4ModeCompatibleWithXhtml1Schemata
public void setHtml4ModeCompatibleWithXhtml1Schemata(boolean html4ModeCompatibleWithXhtml1Schemata) Whether the HTML 4 mode reports boolean attributes in a way that repeats the name in the value.- Parameters:
html4ModeCompatibleWithXhtml1Schemata
-
-
getDocumentLocator
Returns theLocator
during parse.- Returns:
- the
Locator
-
isHtml4ModeCompatibleWithXhtml1Schemata
public boolean isHtml4ModeCompatibleWithXhtml1Schemata()Whether the HTML 4 mode reports boolean attributes in a way that repeats the name in the value.- Returns:
- the html4ModeCompatibleWithXhtml1Schemata
-
setMappingLangToXmlLang
public void setMappingLangToXmlLang(boolean mappingLangToXmlLang) Whetherlang
is mapped toxml:lang
.- Parameters:
mappingLangToXmlLang
-- See Also:
-
isMappingLangToXmlLang
public boolean isMappingLangToXmlLang()Whetherlang
is mapped toxml:lang
.- Returns:
- the mappingLangToXmlLang
-
setXmlnsPolicy
Whether thexmlns
attribute on the root element is passed to through. (FATAL not allowed.)- Parameters:
xmlnsPolicy
-- See Also:
-
getXmlnsPolicy
Returns the xmlnsPolicy.- Returns:
- the xmlnsPolicy
-
getCommentPolicy
Returns the commentPolicy.- Returns:
- the commentPolicy
-
getContentNonXmlCharPolicy
Returns the contentNonXmlCharPolicy.- Returns:
- the contentNonXmlCharPolicy
-
getContentSpacePolicy
Returns the contentSpacePolicy.- Returns:
- the contentSpacePolicy
-
setReportingDoctype
public void setReportingDoctype(boolean reportingDoctype) - Parameters:
reportingDoctype
-- See Also:
-
isReportingDoctype
public boolean isReportingDoctype()Returns the reportingDoctype.- Returns:
- the reportingDoctype
-
setNamePolicy
The policy for non-NCName element and attribute names.- Parameters:
namePolicy
-- See Also:
-
setHeuristics
Sets the encoding sniffing heuristics.- Parameters:
heuristics
- the heuristics to set- See Also:
-
getHeuristics
-
setXmlPolicy
This is a catch-all convenience method for setting name, xmlns, content space, content non-XML char and comment policies in one go. This does not affect the streamability policy or doctype reporting.- Parameters:
xmlPolicy
-
-
getNamePolicy
The policy for non-NCName element and attribute names.- Returns:
- the namePolicy
-
setBogusXmlnsPolicy
Deprecated.Does nothing. -
getBogusXmlnsPolicy
Deprecated.ReturnsXmlViolationPolicy.ALTER_INFOSET
.- Returns:
XmlViolationPolicy.ALTER_INFOSET
-
addCharacterHandler
-
setIgnoringComments
public void setIgnoringComments(boolean ignoreComments) Sets whether comment nodes appear in the tree.- Parameters:
ignoreComments
-true
to ignore comments- See Also:
-