Most visited

Recently visited

Added in API level 1

DocumentBuilder

public abstract class DocumentBuilder
extends Object

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


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

这个类的一个实例可以从newDocumentBuilder()方法中获得。 一旦获得此类的实例,就可以从各种输入源分析XML。 这些输入源是InputStreams,Files,URLs和SAX InputSources。

请注意,这个类重用了SAX API中的几个类。 这并不要求底层DOM实现的实现者使用SAX解析器将XML文档解析为Document 它只需要实现与使用这些现有API的应用程序进行通信。

Summary

Protected constructors

DocumentBuilder()

受保护的构造函数

Public methods

abstract DOMImplementation getDOMImplementation()

获取一个 DOMImplementation对象的实例。

Schema getSchema()

获取XML处理器正在使用的 Schema的引用。

abstract boolean isNamespaceAware()

指示此分析器是否配置为了解命名空间。

abstract boolean isValidating()

指示此分析器是否配置为验证XML文档。

boolean isXIncludeAware()

获取此解析器的XInclude处理模式。

abstract Document newDocument()

获取DOM Document对象的新实例以构建DOM树。

abstract Document parse(InputSource is)

将给定输入源的内容解析为XML文档并返回一个新的DOM Document对象。

Document parse(String uri)

将给定URI的内容解析为一个XML文档并返回一个新的DOM对象 Document

Document parse(InputStream is)

将给定的 InputStream的内容解析为XML文档并返回一个新的DOM Document对象。

Document parse(InputStream is, String systemId)

将给定的 InputStream的内容解析为XML文档并返回一个新的DOM Document对象。

Document parse(File f)

将给定文件的内容解析为XML文档并返回一个新的DOM Document对象。

void reset()

将此 DocumentBuilder重置为其原始配置。

abstract void setEntityResolver(EntityResolver er)

指定要用于解析要解析的XML文档中存在的实体的 EntityResolver

abstract void setErrorHandler(ErrorHandler eh)

指定解析器使用的 ErrorHandler

Inherited methods

From class java.lang.Object

Protected constructors

DocumentBuilder

Added in API level 1
DocumentBuilder ()

受保护的构造函数

Public methods

getDOMImplementation

Added in API level 1
DOMImplementation getDOMImplementation ()

获取一个 DOMImplementation对象的实例。

Returns
DOMImplementation A new instance of a DOMImplementation.

getSchema

Added in API level 8
Schema getSchema ()

获取对XML处理器正在使用的 Schema的引用。

如果没有使用模式,则返回 null

Returns
Schema Schema being used or null if none in use
Throws
UnsupportedOperationException For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown.

isNamespaceAware

Added in API level 1
boolean isNamespaceAware ()

指示此分析器是否配置为了解命名空间。

Returns
boolean true if this parser is configured to understand namespaces; false otherwise.

isValidating

Added in API level 1
boolean isValidating ()

指示此分析器是否配置为验证XML文档。

Returns
boolean true if this parser is configured to validate XML documents; false otherwise.

isXIncludeAware

Added in API level 1
boolean isXIncludeAware ()

获取此解析器的XInclude处理模式。

Returns
boolean the return value of the isXIncludeAware() when this parser was created from factory.
Throws
UnsupportedOperationException For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown.

也可以看看:

newDocument

Added in API level 1
Document newDocument ()

获取DOM Document对象的新实例以构建DOM树。

Returns
Document A new instance of a DOM Document object.

parse

Added in API level 1
Document parse (InputSource is)

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

Parameters
is InputSource: InputSource containing the content to be parsed.
Returns
Document A new DOM Document object.
Throws
IOException If any IO errors occur.
SAXException If any parse errors occur.

也可以看看:

parse

Added in API level 1
Document parse (String uri)

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

Parameters
uri String: The location of the content to be parsed.
Returns
Document A new DOM Document object.
Throws
IOException If any IO errors occur.
SAXException If any parse errors occur.

也可以看看:

parse

Added in API level 1
Document parse (InputStream is)

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

Parameters
is InputStream: InputStream containing the content to be parsed.
Returns
Document Document result of parsing the InputStream
Throws
IOException If any IO errors occur.
SAXException If any parse errors occur.

也可以看看:

parse

Added in API level 1
Document parse (InputStream is, 
                String systemId)

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

Parameters
is InputStream: InputStream containing the content to be parsed.
systemId String: Provide a base for resolving relative URIs.
Returns
Document A new DOM Document object.
Throws
IOException If any IO errors occur.
SAXException If any parse errors occur.

也可以看看:

parse

Added in API level 1
Document parse (File f)

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

Parameters
f File: The file containing the XML to parse.
Returns
Document A new DOM Document object.
Throws
IOException If any IO errors occur.
SAXException If any parse errors occur.

也可以看看:

reset

Added in API level 1
void reset ()

将此 DocumentBuilder重置为其原始配置。

DocumentBuilder被重置为与使用newDocumentBuilder()创建时相同的状态。 reset()旨在允许重复使用现有的DocumentBuilder从而节省与创建新的DocumentBuilder相关的资源。

不保证重置DocumentBuilder具有相同的EntityResolverErrorHandler Object ,例如equals(Object) 它保证有一个功能相同的EntityResolverErrorHandler

setEntityResolver

Added in API level 1
void setEntityResolver (EntityResolver er)

指定EntityResolver用于解析要解析的XML文档中存在的实体。 将其设置为null将导致底层实现使用它自己的默认实现和行为。

Parameters
er EntityResolver: The EntityResolver to be used to resolve entities present in the XML document to be parsed.

setErrorHandler

Added in API level 1
void setErrorHandler (ErrorHandler eh)

指定分析器使用的ErrorHandler 将其设置为null将导致底层实现使用它自己的默认实现和行为。

Parameters
eh ErrorHandler: The ErrorHandler to be used by the parser.

Hooray!