compact2, compact3

javax.xml.parsers

Class DocumentBuilder

java.lang.Object

javax.xml.parsers.DocumentBuilder

public abstract class DocumentBuilder
extends Object

定义从一个XML文档的DOM API获取文档实例。使用这个类，程序员可以从XML获得 Document。

这个类的实例可以从DocumentBuilderFactory.newDocumentBuilder()方法得到的。一旦这个类的一个实例获得，XML可以从各种输入源解析。这些输入源文件的URL，InputStreams，萨克斯inputsources。

注意这类重用的几类从SAX API。这不需要底层的DOM实现的实现者使用SAX解析器解析XML文档转换成一Document。它仅仅要求使用这些现有的应用程序与应用程序进行通信。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	DocumentBuilder() 受保护的构造函数

方法摘要

Modifier and Type	Method and Description
abstract DOMImplementation	getDOMImplementation() 获得一个 DOMImplementation对象的一个实例。
Schema	getSchema() 得到一个参考的 Schema由XML处理器。
abstract boolean	isNamespaceAware() 指示是否这个解析器配置理解命名空间。
abstract boolean	isValidating() 指示此解析器是否被配置来验证XML文档。
boolean	isXIncludeAware() 得到这个解析器的XInclude处理模式。
abstract Document	newDocument() 获得一个DOM Document对象建立DOM树的一个新实例。
Document	parse(File f) 解析给定的文件作为XML文档的内容并返回一个新的 Document DOM对象。
abstract Document	parse(InputSource is) 解析给定的输入源的内容作为一个XML文档的DOM对象并返回一个新的 Document。
Document	parse(InputStream is) 解析给定的 InputStream含量为XML文档的DOM对象并返回一个新的 Document。
Document	parse(InputStream is, String systemId) 解析给定的 InputStream含量为XML文档的DOM对象并返回一个新的 Document。
Document	parse(String uri) 解析给定URI的内容作为一个XML文档的DOM对象并返回一个新的 Document。
void	reset() 这 DocumentBuilder复位到原来的配置。
abstract void	setEntityResolver(EntityResolver er) 指定 EntityResolver用来解决当前的XML文档进行解析实体。
abstract void	setErrorHandler(ErrorHandler eh) 指定要使用的解析器 ErrorHandler。

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentBuilder

protected DocumentBuilder()

受保护的构造函数

方法详细信息

reset

public void reset()

这DocumentBuilder复位到原来的配置。

DocumentBuilder设置为相同的状态时，它的创建与DocumentBuilderFactory.newDocumentBuilder()。reset()旨在让现有的DocumentBuilders节约与新DocumentBuilders创作相关资源的重用。

复位DocumentBuilder不能保证有相同的EntityResolver或ErrorHandler Objects，例如Object.equals(Object obj)。它是保证有一个功能相同的EntityResolver和ErrorHandler。

异常

UnsupportedOperationException当实施不重写这个方法。

从以下版本开始：

一点五

parse

public Document parse(InputStream is)
               throws SAXException,
                      IOException

解析给定的 InputStream含量为XML文档的DOM对象并返回一个新的 Document。一个 IllegalArgumentException如果 InputStream空抛。

参数

is -包含内容进行解析输入流。

结果

Document解析 InputStream结果

异常

IOException -如果出现任何IO错误。

SAXException -如果任何语法错误发生。

IllegalArgumentException当 is是 null

另请参见：

DocumentHandler

parse

public Document parse(InputStream is,
                      String systemId)
               throws SAXException,
                      IOException

解析给定的 InputStream含量为XML文档的DOM对象并返回一个新的 Document。一个 IllegalArgumentException如果 InputStream空抛。

参数

is -包含内容进行解析输入流。

systemId -提供一个相对URI的解析基础。

结果

一个新的DOM文档对象。

异常

IOException -如果出现任何IO错误。

SAXException -如果任何语法错误发生。

IllegalArgumentException当 is是 null

另请参见：

DocumentHandler

parse

public Document parse(String uri)
               throws SAXException,
                      IOException

解析给定URI的内容作为一个XML文档的DOM对象并返回一个新的 Document。如果一个 IllegalArgumentException URI是 null空抛。

参数

uri -内容分析的位置。

结果

一个新的DOM文档对象。

异常

IOException -如果出现任何IO错误。

SAXException -如果任何语法错误发生。

IllegalArgumentException当 uri是 null

另请参见：

DocumentHandler

parse

public Document parse(File f)
               throws SAXException,
                      IOException

解析给定的文件作为XML文档的内容并返回一个新的 Document DOM对象。如果一个 IllegalArgumentException File是 null空抛。

参数

f包含XML解析文件。

结果

一个新的DOM文档对象。

异常

IOException -如果出现任何IO错误。

SAXException -如果任何语法错误发生。

IllegalArgumentException当 f是 null

另请参见：

DocumentHandler

parse

public abstract Document parse(InputSource is)
                        throws SAXException,
                               IOException

解析给定的输入源的内容作为一个XML文档的DOM对象并返回一个新的 Document。如果一个 IllegalArgumentException InputSource是 null空抛。

参数

is -包含内容进行解析，InputSource。

结果

一个新的DOM文档对象。

异常

IOException -如果出现任何IO错误。

SAXException -如果任何语法错误发生。

IllegalArgumentException当 is是 null

另请参见：

DocumentHandler

isNamespaceAware

public abstract boolean isNamespaceAware()

指示是否这个解析器配置理解命名空间。

结果

如果这个解析器配置理解命名空间真；否则为false。

isValidating

public abstract boolean isValidating()

指示此解析器是否被配置来验证XML文档。

结果

如果此解析器配置为验证XML文档，则为真；否则为。

setEntityResolver

public abstract void setEntityResolver(EntityResolver er)

指定 EntityResolver用来解决当前的XML文档进行解析实体。设置为 null将底层的实现使用它自己的默认的实现和行为结果。

参数

er - EntityResolver用来解决当前的XML文档进行解析实体。

setErrorHandler

public abstract void setErrorHandler(ErrorHandler eh)

指定要使用的解析器 ErrorHandler。设置为 null将底层的实现使用它自己的默认的实现和行为结果。

参数

eh - ErrorHandler会被解析器。

newDocument

public abstract Document newDocument()

获得一个DOM Document对象建立DOM树的一个新实例。

结果

一种新的DOM文档实例对象。

getDOMImplementation

public abstract DOMImplementation getDOMImplementation()

获得一个 DOMImplementation对象的一个实例。

结果

一个 DOMImplementation新实例。

getSchema

public Schema getSchema()

得到一个参考的Schema由XML处理器。

如果没有模式正在被使用，null返回。

结果

Schema正在使用或 null如果没有使用

异常

UnsupportedOperationException当实施不重写这个方法

从以下版本开始：

一点五

isXIncludeAware

public boolean isXIncludeAware()

得到这个解析器的XInclude处理模式。

结果

返回值的 DocumentBuilderFactory.isXIncludeAware()当解析器创建工厂。

异常

UnsupportedOperationException当实施不重写这个方法

从以下版本开始：

一点五

另请参见：

DocumentBuilderFactory.setXIncludeAware(boolean)