- All Implemented Interfaces:
DTDConstants
- Direct Known Subclasses:
DocumentParser
Unfortunately there are many badly implemented HTML parsers out there, and as a result there are many badly formatted HTML files. This parser attempts to parse most HTML files. This means that the implementation sometimes deviates from the SGML specification in favor of HTML.
The parser treats \r and \r\n as \n. Newlines after starttags and before end tags are ignored just as specified in the SGML/HTML specification.
The html spec does not specify how spaces are to be coalesced very well. Specifically, the following scenarios are not discussed (note that a space should be used here, but I am using   to force the space to be displayed):
'<b>blah <i> <strike> foo' which can be treated as: '<b>blah <i><strike>foo'
as well as: '<p><a href="xx"> <em>Using</em></a></p>' which appears to be treated as: '<p><a href="xx"><em>Using</em></a></p>'
If strict is false, when a tag that breaks flow,
(TagElement.breaksFlows) or trailing whitespace is
encountered, all whitespace will be ignored until a non whitespace
character is encountered. This appears to give behavior closer to
the popular browsers.
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected DTDThe dtd.protected booleanThis flag determines whether or not the Parser will be strict in enforcing SGML compatibility.Fields declared in interface javax.swing.text.html.parser.DTDConstants
ANY, CDATA, CONREF, CURRENT, DEFAULT, EMPTY, ENDTAG, ENTITIES, ENTITY, FIXED, GENERAL, ID, IDREF, IDREFS, IMPLIED, MD, MODEL, MS, NAME, NAMES, NMTOKEN, NMTOKENS, NOTATION, NUMBER, NUMBERS, NUTOKEN, NUTOKENS, PARAMETER, PI, PUBLIC, RCDATA, REQUIRED, SDATA, STARTTAG, SYSTEM -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected voidendTag(boolean omitted) Handle an end tag.protected voidInvokes the error handler with the 1st, 2nd and 3rd error message argument "?".protected voidInvokes the error handler with the 2nd and 3rd error message argument "?".protected voidInvokes the error handler with the 3rd error message argument "?".protected voidInvokes the error handler.protected voidRemoves the current attributes.protected SimpleAttributeSetReturns attributes for the current tag.protected intReturns the line number of the line currently being parsed.protected intReturns the current position.protected voidhandleComment(char[] text) Called when an HTML comment is encountered.protected voidhandleEmptyTag(TagElement tag) Called when an empty tag is encountered.protected voidhandleEndTag(TagElement tag) Called when an end tag is encountered.protected voidCalled when the content terminates without closing the HTML comment.protected voidhandleError(int ln, String msg) An error has occurred.protected voidhandleStartTag(TagElement tag) Called when a start tag is encountered.protected voidhandleText(char[] text) Called when PCDATA is encountered.protected voidhandleTitle(char[] text) Called when an HTML title tag is encountered.protected TagElementMakes a TagElement.protected TagElementMakes a TagElement.protected voidmarkFirstTime(Element elem) Marks the first time a tag has been seen in a documentvoidParse an HTML stream, given a DTD.Parses the Document Type Declaration markup declaration.protected booleanparseMarkupDeclarations(StringBuffer strBuff) Parse markup declarations.protected voidstartTag(TagElement tag) Handle a start tag.
-
Field Details
-
dtd
The dtd. -
strict
protected boolean strictThis flag determines whether or not the Parser will be strict in enforcing SGML compatibility. If false, it will be lenient with certain common classes of erroneous HTML constructs. Strict or not, in either case an error will be recorded.
-
-
Constructor Details
-
Parser
Creates parser with the specifieddtd.- Parameters:
dtd- the dtd.
-
-
Method Details
-
getCurrentLine
protected int getCurrentLine()Returns the line number of the line currently being parsed.- Returns:
- the line number of the line currently being parsed
-
makeTag
Makes a TagElement.- Parameters:
elem- the element storing the tag definitionfictional- the value of the flag "fictional" to be set for the tag- Returns:
- the created
TagElement
-
makeTag
Makes a TagElement.- Parameters:
elem- the element storing the tag definition- Returns:
- the created
TagElement
-
getAttributes
Returns attributes for the current tag.- Returns:
SimpleAttributeSetcontaining the attributes
-
flushAttributes
protected void flushAttributes()Removes the current attributes. -
handleText
protected void handleText(char[] text) Called when PCDATA is encountered.- Parameters:
text- the section text
-
handleTitle
protected void handleTitle(char[] text) Called when an HTML title tag is encountered.- Parameters:
text- the title text
-
handleComment
protected void handleComment(char[] text) Called when an HTML comment is encountered.- Parameters:
text- the comment being handled
-
handleEOFInComment
protected void handleEOFInComment()Called when the content terminates without closing the HTML comment. -
handleEmptyTag
Called when an empty tag is encountered.- Parameters:
tag- the tag being handled- Throws:
ChangedCharSetException- if the document charset was changed
-
handleStartTag
Called when a start tag is encountered.- Parameters:
tag- the tag being handled
-
handleEndTag
Called when an end tag is encountered.- Parameters:
tag- the tag being handled
-
handleError
An error has occurred.- Parameters:
ln- the number of line containing the errormsg- the error message
-
error
Invokes the error handler.- Parameters:
err- the error typearg1- the 1st error message argumentarg2- the 2nd error message argumentarg3- the 3rd error message argument
-
error
Invokes the error handler with the 3rd error message argument "?".- Parameters:
err- the error typearg1- the 1st error message argumentarg2- the 2nd error message argument
-
error
Invokes the error handler with the 2nd and 3rd error message argument "?".- Parameters:
err- the error typearg1- the 1st error message argument
-
error
Invokes the error handler with the 1st, 2nd and 3rd error message argument "?".- Parameters:
err- the error type
-
startTag
Handle a start tag. The new tag is pushed onto the tag stack. The attribute list is checked for required attributes.- Parameters:
tag- the tag- Throws:
ChangedCharSetException- if the document charset was changed
-
endTag
protected void endTag(boolean omitted) Handle an end tag. The end tag is popped from the tag stack.- Parameters:
omitted-trueif the tag is no actually present in the document, but is supposed by the parser
-
markFirstTime
Marks the first time a tag has been seen in a document- Parameters:
elem- the element represented by the tag
-
parseDTDMarkup
Parses the Document Type Declaration markup declaration. Currently ignores it.- Returns:
- the string representation of the markup declaration
- Throws:
IOException- if an I/O error occurs
-
parseMarkupDeclarations
Parse markup declarations. Currently only handles the Document Type Declaration markup. Returns true if it is a markup declaration false otherwise.- Parameters:
strBuff- the markup declaration- Returns:
trueif this is a valid markup declaration; otherwisefalse- Throws:
IOException- if an I/O error occurs
-
parse
Parse an HTML stream, given a DTD.- Parameters:
in- the reader to read the source from- Throws:
IOException- if an I/O error occurs
-
getCurrentPos
protected int getCurrentPos()Returns the current position.- Returns:
- the current position
-