javax.swing.text.html

Class HTMLDocument.HTMLReader

java.lang.Object

javax.swing.text.html.HTMLEditorKit.ParserCallback

javax.swing.text.html.HTMLDocument.HTMLReader

Enclosing class:

HTMLDocument

public class HTMLDocument.HTMLReader
extends HTMLEditorKit.ParserCallback

一个HTML阅读器加载HTML文档和HTML元素的结构。这是从解析器一组回调函数，实现创建一组元素标记的属性。解析建立令牌（elementspec）描述所需元素的子树，爆裂成文件写入使用插入的方法对文档类外锁的保护下。

读者可以通过注册行为配置（类型HTMLDocument.HTMLReader.TagAction）描述如何处理动作。提供的行动背后的想法是，最自然的文本编辑操作，可以提供，如果元素结构归结为一段，在他们的某种风格的运行。有些东西在结构上是比较自然的，所以在段落的上方应该允许任意的结构，但需要用结构的动作来编辑。也就是说一些在流解析指定的HTML元素将坍塌为属性，并在某些情况下，将合成的段落。当HTML元素都被转换为属性，该属性的关键将是类型的HTML。标签和值将attributeset型，没有信息丢失。这使得许多现有的行动，以便用户可以输入，按回车键，退格键，删除，等有一个合理的结果。可以创建选择，应用或删除的属性，等等。这在头脑中，读者所做的工作可以分为以下几种任务：

块

建立像它在流中指定的结构。这将产生包含其他元素的元素。

段

像块，除了它的预期，该元素将被使用与一个段落视图，所以一个段落元素将不需要被合成。

字符

将元素作为一个属性，将在任意的文本位置开始和停止。这最终将被混合成一个运行的文本，所有的HTML元素，目前平。

特殊

产生一个嵌入的图形元素。

形式

产生一个元素，它像嵌入的图形元素，但它也有一个与它关联的组件模型。

隐藏

创建一个从视图中隐藏的元素，当文档处于只读状态时，并且在文档正在编辑的时候可见。这是有用的保持模型从丢失的信息，并用于存储的东西，如意见和无法识别的标签。

目前， <程序> 、 <参数> ，

的行为描述的分配如下表所示为HTML.Tag定义的标签。

Tag	Action
HTML.Tag.A	CharacterAction
HTML.Tag.ADDRESS	CharacterAction
HTML.Tag.APPLET	HiddenAction
HTML.Tag.AREA	AreaAction
HTML.Tag.B	CharacterAction
HTML.Tag.BASE	BaseAction
HTML.Tag.BASEFONT	CharacterAction
HTML.Tag.BIG	CharacterAction
HTML.Tag.BLOCKQUOTE	BlockAction
HTML.Tag.BODY	BlockAction
HTML.Tag.BR	SpecialAction
HTML.Tag.CAPTION	BlockAction
HTML.Tag.CENTER	BlockAction
HTML.Tag.CITE	CharacterAction
HTML.Tag.CODE	CharacterAction
HTML.Tag.DD	BlockAction
HTML.Tag.DFN	CharacterAction
HTML.Tag.DIR	BlockAction
HTML.Tag.DIV	BlockAction
HTML.Tag.DL	BlockAction
HTML.Tag.DT	ParagraphAction
HTML.Tag.EM	CharacterAction
HTML.Tag.FONT	CharacterAction
HTML.Tag.FORM	As of 1.4 a BlockAction
HTML.Tag.FRAME	SpecialAction
HTML.Tag.FRAMESET	BlockAction
HTML.Tag.H1	ParagraphAction
HTML.Tag.H2	ParagraphAction
HTML.Tag.H3	ParagraphAction
HTML.Tag.H4	ParagraphAction
HTML.Tag.H5	ParagraphAction
HTML.Tag.H6	ParagraphAction
HTML.Tag.HEAD	HeadAction
HTML.Tag.HR	SpecialAction
HTML.Tag.HTML	BlockAction
HTML.Tag.I	CharacterAction
HTML.Tag.IMG	SpecialAction
HTML.Tag.INPUT	FormAction
HTML.Tag.ISINDEX	IsndexAction
HTML.Tag.KBD	CharacterAction
HTML.Tag.LI	BlockAction
HTML.Tag.LINK	LinkAction
HTML.Tag.MAP	MapAction
HTML.Tag.MENU	BlockAction
HTML.Tag.META	MetaAction
HTML.Tag.NOFRAMES	BlockAction
HTML.Tag.OBJECT	SpecialAction
HTML.Tag.OL	BlockAction
HTML.Tag.OPTION	FormAction
HTML.Tag.P	ParagraphAction
HTML.Tag.PARAM	HiddenAction
HTML.Tag.PRE	PreAction
HTML.Tag.SAMP	CharacterAction
HTML.Tag.SCRIPT	HiddenAction
HTML.Tag.SELECT	FormAction
HTML.Tag.SMALL	CharacterAction
HTML.Tag.STRIKE	CharacterAction
HTML.Tag.S	CharacterAction
HTML.Tag.STRONG	CharacterAction
HTML.Tag.STYLE	StyleAction
HTML.Tag.SUB	CharacterAction
HTML.Tag.SUP	CharacterAction
HTML.Tag.TABLE	BlockAction
HTML.Tag.TD	BlockAction
HTML.Tag.TEXTAREA	FormAction
HTML.Tag.TH	BlockAction
HTML.Tag.TITLE	TitleAction
HTML.Tag.TR	BlockAction
HTML.Tag.TT	CharacterAction
HTML.Tag.U	CharacterAction
HTML.Tag.UL	BlockAction
HTML.Tag.VAR	CharacterAction

一旦遇到< / HTML >，动作不再通知。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	HTMLDocument.HTMLReader.BlockAction
class	HTMLDocument.HTMLReader.CharacterAction
class	HTMLDocument.HTMLReader.FormAction 通过建立用于表示窗体控件的所有元素的形式来支持窗体的作用。
class	HTMLDocument.HTMLReader.HiddenAction
class	HTMLDocument.HTMLReader.IsindexAction
class	HTMLDocument.HTMLReader.ParagraphAction
class	HTMLDocument.HTMLReader.PreAction
class	HTMLDocument.HTMLReader.SpecialAction
class	HTMLDocument.HTMLReader.TagAction 响应解析标签的动作要执行的操作。

Field Summary

Fields

Modifier and Type	Field and Description
protected MutableAttributeSet	charAttr
protected Vector<DefaultStyledDocument.ElementSpec>	parseBuffer

Fields inherited from class javax.swing.text.html.HTMLEditorKit.ParserCallback

IMPLIED

构造方法摘要

构造方法

Constructor and Description
HTMLReader(int offset)
HTMLReader(int offset, int popDepth, int pushDepth, HTML.Tag insertTag)

方法摘要

Modifier and Type	Method and Description
protected void	addContent(char[] data, int offs, int length) 添加了一些当前字符属性的文本。
protected void	addContent(char[] data, int offs, int length, boolean generateImpliedPIfNecessary) 添加了一些当前字符属性的文本。
protected void	addSpecialElement(HTML.Tag t, MutableAttributeSet a) 添加基本上完全在属性集中指定的内容。
protected void	blockClose(HTML.Tag t) 向解析缓冲区添加一个指令，以关闭给定类型的块元素。
protected void	blockOpen(HTML.Tag t, MutableAttributeSet attr) 向解析缓冲区添加一个指令，以创建给定属性的块元素。
void	flush() 最后一种方法调用阅读器。
void	handleComment(char[] data, int pos)
void	handleEndOfLineString(String eol) 这是调用后流解析完毕，但在 flush。
void	handleEndTag(HTML.Tag t, int pos) 从解析器回调。
void	handleSimpleTag(HTML.Tag t, MutableAttributeSet a, int pos) 从解析器回调。
void	handleStartTag(HTML.Tag t, MutableAttributeSet a, int pos) 从解析器回调。
void	handleText(char[] data, int pos) 由解析器调用来表示遇到了一个文本块。
protected void	popCharacterStyle() 弹出一个以前推的字符样式关闭堆栈返回到以前的样式。
protected void	preContent(char[] data) 添加在预元素中遇到的给定内容。
protected void	pushCharacterStyle() 将当前的字符样式推到堆栈上，以形成一个新的嵌套字符样式。
protected void	registerTag(HTML.Tag t, HTMLDocument.HTMLReader.TagAction a) 为给定的标签注册一个处理程序。
protected void	textAreaContent(char[] data) 由于增加了内容的文本文件。

Methods inherited from class javax.swing.text.html.HTMLEditorKit.ParserCallback

handleError

Methods inherited from class java.lang.Object

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

Field Detail

parseBuffer

protected Vector<DefaultStyledDocument.ElementSpec> parseBuffer

charAttr

protected MutableAttributeSet charAttr

Constructor Detail

HTMLReader

public HTMLReader(int offset)

HTMLReader

public HTMLReader(int offset,
                  int popDepth,
                  int pushDepth,
                  HTML.Tag insertTag)

方法详细信息

flush

public void flush()
           throws BadLocationException

最后一种方法调用阅读器。它允许任何挂起的更改被刷新到文档中。由于这是当前加载同步，整个一组的变化被推在这一点上。

重写：

flush 方法重写，继承类 HTMLEditorKit.ParserCallback

异常

BadLocationException

handleText

public void handleText(char[] data,
                       int pos)

由解析器调用来表示遇到了一个文本块。

重写：

handleText 方法重写，继承类 HTMLEditorKit.ParserCallback

handleStartTag

public void handleStartTag(HTML.Tag t,
                           MutableAttributeSet a,
                           int pos)

从解析器回调。给标记的适当处理程序的路由。

重写：

handleStartTag 方法重写，继承类 HTMLEditorKit.ParserCallback

handleComment

public void handleComment(char[] data,
                          int pos)

重写：

handleComment 方法重写，继承类 HTMLEditorKit.ParserCallback

handleEndTag

public void handleEndTag(HTML.Tag t,
                         int pos)

从解析器回调。给标记的适当处理程序的路由。

重写：

handleEndTag 方法重写，继承类 HTMLEditorKit.ParserCallback

handleSimpleTag

public void handleSimpleTag(HTML.Tag t,
                            MutableAttributeSet a,
                            int pos)

从解析器回调。给标记的适当处理程序的路由。

重写：

handleSimpleTag 方法重写，继承类 HTMLEditorKit.ParserCallback

handleEndOfLineString

public void handleEndOfLineString(String eol)

这是调用后流解析完毕，但在 flush。 eol将其中n、R或\r\n，这曾经是遇到的最在解析流。

重写：

handleEndOfLineString 方法重写，继承类 HTMLEditorKit.ParserCallback

从以下版本开始：

一点三

registerTag

protected void registerTag(HTML.Tag t,
                           HTMLDocument.HTMLReader.TagAction a)

为给定的标签注册一个处理程序。默认情况下，所有的知名标签将被注册。这可以用来改变一个特定的标签的处理或添加自定义标签的支持。

pushCharacterStyle

protected void pushCharacterStyle()

将当前的字符样式推到堆栈上，以形成一个新的嵌套字符样式。

popCharacterStyle

protected void popCharacterStyle()

弹出一个以前推的字符样式关闭堆栈返回到以前的样式。

textAreaContent

protected void textAreaContent(char[] data)

由于增加了内容的文本文件。这种方法被称为当我们在文本语境。因此所有的文本是属于文本的区域，因此添加到文本区域关联的textareadocument。

preContent

protected void preContent(char[] data)

添加在预元素中遇到的给定内容。这种合成线把握文本运行，并调用addcontent实际上添加文本。

blockOpen

protected void blockOpen(HTML.Tag t,
                         MutableAttributeSet attr)

向解析缓冲区添加一个指令，以创建给定属性的块元素。

blockClose

protected void blockClose(HTML.Tag t)

向解析缓冲区添加一个指令，以关闭给定类型的块元素。

addContent

protected void addContent(char[] data,
                          int offs,
                          int length)

添加了一些当前字符属性的文本。

参数

data -添加内容

初始偏移 offs -

length -长度

addContent

protected void addContent(char[] data,
                          int offs,
                          int length,
                          boolean generateImpliedPIfNecessary)

添加了一些当前字符属性的文本。

参数

data -添加内容

offs -初始偏移

length -长度

generateImpliedPIfNecessary -是否产生暗示的段落

addSpecialElement

protected void addSpecialElement(HTML.Tag t,
                                 MutableAttributeSet a)

添加基本上完全在属性集中指定的内容。