- All Implemented Interfaces:
DTDConstants
This will message the callback for all valid tags, as well as tags that are implied but not explicitly specified. For example, the html string (<p>blah) only has a p tag defined. The callback will see the following methods:
- handleStartTag(html, ...)
- handleStartTag(head, ...)
- handleEndTag(head)
- handleStartTag(body, ...)
- handleStartTag(p, ...)
- handleText(...)
- handleEndTag(p)
- handleEndTag(body)
- handleEndTag(html)
Boolean.TRUE
for the key
HTMLEditorKit.ParserCallback.IMPLIED
.
HTML.Attributes defines a type safe enumeration of html attributes. If an attribute key of a tag is defined in HTML.Attribute, the HTML.Attribute will be used as the key, otherwise a String will be used. For example <p foo=bar class=neat> has two attributes. foo is not defined in HTML.Attribute, where as class is, therefore the AttributeSet will have two values in it, HTML.Attribute.CLASS with a String value of 'neat' and the String key 'foo' with a String value of 'bar'.
The position argument will indicate the start of the tag, comment or text. Similar to arrays, the first character in the stream has a position of 0. For tags that are implied the position will indicate the location of the next encountered tag. In the first example, the implied start body and html tags will have the same position as the p tag, and the implied end p, html and body tags will all have the same position.
As html skips whitespace the position for text will be the position of the first valid character, eg in the string '\n\n\nblah' the text 'blah' will have a position of 3, the newlines are skipped.
For attributes that do not have a value, eg in the html
string <foo blah>
the attribute blah
does not have a value, there are two possible values that will be
placed in the AttributeSet's value:
- If the DTD does not contain an definition for the element, or the
definition does not have an explicit value then the value in the
AttributeSet will be
HTML.NULL_ATTRIBUTE_VALUE
. - If the DTD contains an explicit value, as in:
<!ATTLIST OPTION selected (selected) #IMPLIED>
this value from the dtd (in this case selected) will be used.
Once the stream has been parsed, the callback is notified of the most likely end of line string. The end of line string will be one of \n, \r or \r\n, which ever is encountered the most in parsing the stream.
-
Field Summary
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
-
Method Summary
Modifier and TypeMethodDescriptionprotected void
handleEmptyTag
(TagElement tag) Handle Empty Tag.protected void
handleEndTag
(TagElement tag) Handle End Tag.protected void
handleStartTag
(TagElement tag) Handle Start Tag.protected void
handleText
(char[] data) Handle Text.void
parse
(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet) Parse an HTML stream, given a DTD.Methods declared in class javax.swing.text.html.parser.Parser
endTag, error, error, error, error, flushAttributes, getAttributes, getCurrentLine, getCurrentPos, handleComment, handleEOFInComment, handleError, handleTitle, makeTag, makeTag, markFirstTime, parse, parseDTDMarkup, parseMarkupDeclarations, startTag
-
Constructor Details
-
DocumentParser
Creates document parser with the specifieddtd
.- Parameters:
dtd
- the dtd.
-
-
Method Details
-
parse
public void parse(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet) throws IOException Parse an HTML stream, given a DTD.- Parameters:
in
- the reader to read the source fromcallback
- the callbackignoreCharSet
- iftrue
the charset is ignored- Throws:
IOException
- if an I/O error occurs
-
handleStartTag
Handle Start Tag.- Overrides:
handleStartTag
in classParser
- Parameters:
tag
- the tag being handled
-
handleEmptyTag
Handle Empty Tag.- Overrides:
handleEmptyTag
in classParser
- Parameters:
tag
- the tag being handled- Throws:
ChangedCharSetException
- if the document charset was changed
-
handleEndTag
Handle End Tag.- Overrides:
handleEndTag
in classParser
- Parameters:
tag
- the tag being handled
-
handleText
protected void handleText(char[] data) Handle Text.- Overrides:
handleText
in classParser
- Parameters:
data
- the section text
-