java.beans

Class XMLDecoder

java.lang.Object

java.beans.XMLDecoder

All Implemented Interfaces:

AutoCloseable

public class XMLDecoder
extends Object
implements AutoCloseable

的 XMLDecoder类用于读取XML文件的创建和使用 XMLEncoder就像 ObjectInputStream。例如，可以使用以下片断读写的 XMLEncoder类定义XML文档的第一个对象：

xmldecoder a新XMLDecoder（新的缓冲输入流（新的输入（“测试。XML”）））；结果readobject()对象D.；D.（）；

更多的信息，你也可能想看看Long Term Persistence of JavaBeans Components: XML Schema，在秋千上连接的一篇文章。

从以下版本开始：

一点四

另请参见：

XMLEncoder， ObjectInputStream

构造方法摘要

构造方法

Constructor and Description
XMLDecoder(InputSource is) 创建解析XML档案的 XMLEncoder类创建了一个新的解码器。
XMLDecoder(InputStream in) 建立阅读档案的 XMLEncoder类创建一个新的输入流。
XMLDecoder(InputStream in, Object owner) 建立阅读档案的 XMLEncoder类创建一个新的输入流。
XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener) 建立阅读档案的 XMLEncoder类创建一个新的输入流。
XMLDecoder(InputStream in, Object owner, ExceptionListener exceptionListener, ClassLoader cl) 建立阅读档案的 XMLEncoder类创建一个新的输入流。

方法摘要

Modifier and Type	Method and Description
void	close() 此方法关闭与此流关联的输入流。
static DefaultHandler	createHandler(Object owner, ExceptionListener el, ClassLoader cl) 创建SAX解析器，可以用来解析嵌入式XML档案的 XMLEncoder类创建了一个新的处理程序。
ExceptionListener	getExceptionListener() 获取此流的异常处理程序。
Object	getOwner() 获取此解码器的所有者。
Object	readObject() 从下面的输入流读取下一个对象。
void	setExceptionListener(ExceptionListener exceptionListener) 设置此流 exceptionListener异常处理程序。
void	setOwner(Object owner) 设置此解码器业主 owner。

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLDecoder

public XMLDecoder(InputStream in)

建立阅读档案的 XMLEncoder类创建一个新的输入流。

参数

in -基础流。

另请参见：

XMLEncoder.XMLEncoder(java.io.OutputStream)

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner)

建立阅读档案的 XMLEncoder类创建一个新的输入流。

参数

in -基础流。

owner -这流人。

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener)

建立阅读档案的 XMLEncoder类创建一个新的输入流。

参数

in -基础流。

owner -这流人。

exceptionListener -流的异常处理程序；如果 null默认侦听器将使用异常。

XMLDecoder

public XMLDecoder(InputStream in,
                  Object owner,
                  ExceptionListener exceptionListener,
                  ClassLoader cl)

建立阅读档案的 XMLEncoder类创建一个新的输入流。

参数

in -基础流。 null可能没有错误，但由此产生的xmldecoder将无用

owner -这流人。 null是法律价值

exceptionListener -流的异常处理程序，或 null使用默认的

cl用于实例化对象的类装载器。 null表示默认的类加载器应该使用

从以下版本开始：

一点五

XMLDecoder

public XMLDecoder(InputSource is)

创建解析XML档案的 XMLEncoder类创建了一个新的解码器。如果输入源 is是 null，没有异常被抛出，没有执行分析。这种行为是类似于其他构造函数使用 InputStream作为参数的行为。

参数

is -输入源解析

从以下版本开始：

一点七

方法详细信息

close

public void close()

此方法关闭与此流关联的输入流。

Specified by:

close 接口 AutoCloseable

setExceptionListener

public void setExceptionListener(ExceptionListener exceptionListener)

设置此流 exceptionListener异常处理程序。当此流捕获可恢复的异常时，将通知异常处理程序。

参数

exceptionListener -该流的异常处理程序；如果 null默认侦听器将使用异常。

另请参见：

getExceptionListener()

getExceptionListener

public ExceptionListener getExceptionListener()

获取此流的异常处理程序。

结果

此流的异常处理程序。将返回默认的异常侦听器，如果这没有显式设置。

另请参见：

setExceptionListener(java.beans.ExceptionListener)

readObject

public Object readObject()

从下面的输入流读取下一个对象。

结果

下一个对象读取

异常

ArrayIndexOutOfBoundsException如果流不包含对象（或没有更多的对象）

另请参见：

XMLEncoder.writeObject(java.lang.Object)

setOwner

public void setOwner(Object owner)

设置此解码器业主 owner。

参数

owner -此解码器的主人。

另请参见：

getOwner()

getOwner

public Object getOwner()

获取此解码器的所有者。

结果

此解码器的所有者。

另请参见：

setOwner(java.lang.Object)

createHandler

public static DefaultHandler createHandler(Object owner,
                                           ExceptionListener el,
                                           ClassLoader cl)

创建SAX解析器，可以用来解析嵌入式XML档案的 XMLEncoder类创建了一个新的处理程序。的 owner应该如果解析XML文档包含方法调用在< >元素中使用java。的 null值可能导致非法解析在这种情况下。同样的问题可能会发生，如果 owner类不包含预期的调用方法。详情请看 here。

参数

owner -默认处理程序可以作为一个值＜java >元的主人

el -解析器的异常处理程序，或 null使用默认的异常处理程序

cl用于实例化对象的类装载器，或 null使用默认的类加载器

结果

为 DefaultHandler SAX解析器的实例

从以下版本开始：

一点七