DocumentBuilder API 官方翻译（翻译有错的地方请多指正）

public abstract class

DocumentBuilder

extends Object

---------------------------------------------------------------------------------------------------------------------------------

java.lang.Object
↳	javax.xml.parsers.DocumentBuilder

Class Overview(类概述)

---

定义API，把XML文档转变成DOM文档实例。使用这个类，应用程序可以把XML 当做一个Document 来操作。

用newDocumentBuilder（）方法可以得到这个类的一个实例 。一旦获得这个类的实例，XML可以从各种输入源解析。这些输入源的InputStreams，Files，URLS      和   SAX InputSources。

请注意，这个类重用了SAX API的一些类。这并不要求实现底层DOM，使用SAX解析器来解析XML文档转换成一个文档。它仅仅需要使用这些现有的API来与应用程序实现沟通。

<!-- jd-descr -->

Summary

---

Protected Constructors

	DocumentBuilder() Protected constructor （受保护的构造函数）

Public Methods

abstract DOMImplementation	getDOMImplementation()       获取 DOMImplementation 对象的一个实例。
Schema	getSchema()                          获取一个架构或模式来供xml处理器使用
abstract boolean	isNamespaceAware()            表明此解析器是否被配置了命名空间
abstract boolean	isValidating()                         表明是否这个解析器配置为验证XML文档。
boolean	isXIncludeAware()                 获取此解析器的XInclude处理模式。
abstract Document	newDocument()                     获取一个新的  Document 对象来构建一个 DOM tree
Document	parse(InputStream is)           解析给定的InputStream的内容，作为XML文档并返回一个新的DOM document对象。
Document	parse(String uri)                     解析给定URI的内容，作为XML文档并返回一个新的DOM document对象。
abstract Document	parse(InputSource is)             解析给定的InputSource内容，作为XML文档并返回一个新的DOM document对象。
Document	parse(InputStream is, String systemId)   解析给定的InputStream内容，作为XML文档并返回一个新的DOM document对象。
Document	parse(File f)                           解析给定的file的内容作为XML文档,并返回一个新的DOM document对象。
void	reset()                                   重置 DocumentBuilder.
abstract void	setEntityResolver(EntityResolver er) 设置EntityResolver使用resolve entities出现在解析XML文档。
abstract void	setErrorHandler(ErrorHandler eh) 设置ErrorHandler所使用的解析器

继承的方法

从类 java.lang.Object继承

    

Protected Constructors

---

protected DocumentBuilder ()

Protected constructor

Public Methods

---

public abstract DOMImplementation getDOMImplementation ()

获取DOMImplementation对象的一个实例。

 

Returns

• 一个新的实例DOMImplementation。

public Schema getSchema ()

 获取一个架构或模式来供xml处理器使用， 如果没有正在使用的模式，则返回NULL。 

Returns

• 返回一个Schema或null

抛出异常

 

 

UnsupportedOperationException

为了向后兼容，当使用JAXP的早期版本的实现，这将抛出异常