javax.swing.text.html.parser

Class DocumentParser

java.lang.Object

javax.swing.text.html.parser.Parser

javax.swing.text.html.parser.DocumentParser

All Implemented Interfaces:

DTDConstants

public class DocumentParser
extends Parser

HTML文档的解析器（实际上，您可以指定一个DTD，但您应该只使用html dtd的这个类）。 读取一个HTML的InputStream，并在ParserCallback类中调用适当的方法。 这是HTMLEditorKit用来解析HTML网址的默认解析器。

这将消息所有有效标记的回调以及隐含但未明确指定的标记。 例如，html字符串（<p> blah）只有定义了ap标签。 回调将看到以下方法：

1. handleStartTag（html，...）
2. handleStartTag（头，...）
3. handleEndTag（头）
4. handleStartTag（body，...）
5. handleStartTag（p，...）
6. handleText（...）
7. handleEndTag（p）
8. handleEndTag（body）
9. handleEndTag（html）

这些项目是斜体的，也就是虽然没有明确规定，但是正确的html应该是存在的（头不是必需的，但仍然是生成的）。 对于隐含的标签，AttributeSet参数的值为Boolean.TRUE ，关键HTMLEditorKit.ParserCallback.IMPLIED 。

HTML.Attributes定义了html属性的类型安全枚举。 如果HTML.Attribute中定义了一个标签的属性键，则将使用HTML.Attribute作为键，否则将使用String。 例如<p foo = bar class = neat>有两个属性。 foo没有在HTML.Attribute中定义，因为它是Class，因此AttributeSet将有两个值，其中的值为“neat”的String.Attribute.CLASS和String值为'foo'的String key为'酒吧'。

position参数将指示标签，注释或文本的开始。 与数组类似，流中的第一个字符的位置为0.对于隐含的标记，位置将指示下一个遇到标记的位置。 在第一个示例中，隐含的起始正文和html标签将具有与p标记相同的位置，并且隐含的结尾p，html和body标签都将具有相同的位置。

当html跳过空格时，文本的位置将是第一个有效字符的位置，例如在字符串'\ n \ n \ nblah'中，文本“blah”将具有3的位置，跳过换行符。

对于没有值的属性，例如在html字符串<foo blah> ，属性blah没有值，将有两个可能的值放在AttributeSet的值中：

• 如果DTD不包含该元素的定义，或定义没有显式值，则AttributeSet中的值将为HTML.NULL_ATTRIBUTE_VALUE 。
• 如果DTD包含显式值，如： <!ATTLIST OPTION selected (selected) #IMPLIED>将使用dtd（在这种情况下选择）中的此值。

一旦流已被解析，回调通知最可能的行字符串结束。 行字符串的结尾将是\ n，\ r或\ r \ n中的一个，这在解析流中遇到最多。

Field Summary

Fields inherited from class javax.swing.text.html.parser.Parser

dtd, strict

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 and Description
DocumentParser(DTD dtd)

方法摘要

Modifier and Type	Method and Description
protected void	handleComment(char[] text) 遇到HTML注释时调用。
protected void	handleEmptyTag(TagElement tag) 处理空标签。
protected void	handleEndTag(TagElement tag) 处理结束标签
protected void	handleError(int ln, String errorMsg) 发生了错误。
protected void	handleStartTag(TagElement tag) 处理起始标签。
protected void	handleText(char[] data) 处理文本。
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

Methods inherited from class java.lang.Object

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

构造方法详细信息

DocumentParser

public DocumentParser(DTD dtd)

方法详细信息

parse

public void parse(Reader in,
                  HTMLEditorKit.ParserCallback callback,
                  boolean ignoreCharSet)
           throws IOException

异常

IOException

handleStartTag

protected void handleStartTag(TagElement tag)

处理起始标签。

重写：

handleStartTag在 Parser

handleComment

protected void handleComment(char[] text)

描述从类别复制： Parser

遇到HTML注释时调用。

重写：

handleComment在 Parser

handleEmptyTag

protected void handleEmptyTag(TagElement tag)
                       throws ChangedCharSetException

处理空标签。

重写：

handleEmptyTag在 Parser

异常

ChangedCharSetException

handleEndTag

protected void handleEndTag(TagElement tag)

处理结束标签

重写：

handleEndTag在 Parser

handleText

protected void handleText(char[] data)

处理文本。

重写：

handleText在 Parser

handleError

protected void handleError(int ln,
                           String errorMsg)

描述从类别复制： Parser

发生了错误。

重写：

handleError在 Parser