- java.lang.Object
-
- javax.swing.text.html.parser.Parser
-
- javax.swing.text.html.parser.DocumentParser
-
- All Implemented Interfaces:
- DTDConstants
public class DocumentParser extends Parser
A Parser for HTML Documents (actually, you can specify a DTD, but you should really only use this class with the html dtd in swing). Reads an InputStream of HTML and invokes the appropriate methods in the ParserCallback class. This is the default parser used by HTMLEditorKit to parse HTML url's.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 keyHTMLEditorKit.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. Similiar 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 attributeblah
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 inherited from 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 Constructor and Description DocumentParser(DTD dtd)
-
Method Summary
Methods Modifier and Type Method and Description protected void
handleComment(char[] text)
Called when an HTML comment is encountered.protected void
handleEmptyTag(TagElement tag)
Handle Empty Tag.protected void
handleEndTag(TagElement tag)
Handle End Tag.protected void
handleError(int ln, String errorMsg)
An error has occurred.protected void
handleStartTag(TagElement tag)
Handle Start Tag.protected void
handleText(char[] data)
Handle Text.void
parse(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet)
-
Methods inherited from class javax.swing.text.html.parser.Parser
endTag, error, error, error, error, flushAttributes, getAttributes, getCurrentLine, getCurrentPos, handleEOFInComment, handleTitle, makeTag, makeTag, markFirstTime, parse, parseDTDMarkup, parseMarkupDeclarations, startTag
-
-
-
-
Constructor Detail
-
DocumentParser
public DocumentParser(DTD dtd)
-
-
Method Detail
-
parse
public void parse(Reader in, HTMLEditorKit.ParserCallback callback, boolean ignoreCharSet) throws IOException
- Throws:
IOException
-
handleStartTag
protected void handleStartTag(TagElement tag)
Handle Start Tag.- Overrides:
handleStartTag
in classParser
-
handleComment
protected void handleComment(char[] text)
Description copied from class:Parser
Called when an HTML comment is encountered.- Overrides:
handleComment
in classParser
-
handleEmptyTag
protected void handleEmptyTag(TagElement tag) throws ChangedCharSetException
Handle Empty Tag.- Overrides:
handleEmptyTag
in classParser
- Throws:
ChangedCharSetException
-
handleEndTag
protected void handleEndTag(TagElement tag)
Handle End Tag.- Overrides:
handleEndTag
in classParser
-
handleText
protected void handleText(char[] data)
Handle Text.- Overrides:
handleText
in classParser
-
handleError
protected void handleError(int ln, String errorMsg)
Description copied from class:Parser
An error has occurred.- Overrides:
handleError
in classParser
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/swing/text/html/parser/DocumentParser.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.