mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-03 23:32:47 +08:00
610 lines
30 KiB
HTML
610 lines
30 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.xml.parsers
|
||
</div>
|
||
<h2 class="title" title="Class DocumentBuilder">Class DocumentBuilder</h2>
|
||
</div><div class="contentContainer">
|
||
<ul class="inheritance">
|
||
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li>javax.xml.parsers.DocumentBuilder</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">DocumentBuilder</span>
|
||
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
|
||
<div class="block">
|
||
<span>定义从XML文档获取DOM文档实例的API。</span>
|
||
<span>使用这个类,应用程序员可以从XML获得一个<a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a> 。</span>
|
||
<p> <span>这个类的一个实例可以从<a href="../../../javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder--"><code>DocumentBuilderFactory.newDocumentBuilder()</code></a>方法获得。</span> <span>一旦获得此类的实例,可以从各种输入源解析XML。</span> <span>这些输入源是InputStreams,Files,URL和SAX InputSources。</span> </p>
|
||
<p> <span>请注意,该类从SAX API重用了几个类。</span> <span>这不要求底层DOM实现的实现者使用SAX解析器将XML文档解析为<code>Document</code> 。</span> <span>它只需要实现使用这些现有API与应用程序通信。</span> </p>
|
||
</div> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.summary">
|
||
<!-- --> </a> <h3>构造方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
|
||
<caption>
|
||
<span>构造方法</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier</th>
|
||
<th class="colLast" scope="col">Constructor and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>protected </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#DocumentBuilder--">DocumentBuilder</a></span>()</code>
|
||
<div class="block">
|
||
受保护的构造函数
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<!-- ========== METHOD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.summary">
|
||
<!-- --> </a> <h3>方法摘要</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
|
||
<caption>
|
||
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
|
||
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Method and Description</th>
|
||
</tr>
|
||
<tr class="altColor" id="i0">
|
||
<td class="colFirst"><code>abstract <a href="../../../org/w3c/dom/DOMImplementation.html" title="interface in org.w3c.dom">DOMImplementation</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#getDOMImplementation--">getDOMImplementation</a></span>()</code>
|
||
<div class="block">
|
||
<span>获取一个<a href="../../../org/w3c/dom/DOMImplementation.html" title="界面在org.w3c.dom"><code>DOMImplementation</code></a>对象的实例。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../javax/xml/validation/Schema.html" title="class in javax.xml.validation">Schema</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#getSchema--">getSchema</a></span>()</code>
|
||
<div class="block">
|
||
<span>获取到的基准<a href="../../../javax/xml/validation/Schema.html" title="javax.xml.validation中的类"><code>Schema</code></a>正在使用的XML处理器。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>abstract boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#isNamespaceAware--">isNamespaceAware</a></span>()</code>
|
||
<div class="block">
|
||
指示此解析器是否配置为了解命名空间。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>abstract boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#isValidating--">isValidating</a></span>()</code>
|
||
<div class="block">
|
||
指示此解析器是否配置为验证XML文档。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#isXIncludeAware--">isXIncludeAware</a></span>()</code>
|
||
<div class="block">
|
||
获取此解析器的XInclude处理模式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>abstract <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#newDocument--">newDocument</a></span>()</code>
|
||
<div class="block">
|
||
<span>获取DOM的新实例<a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象来构建一个DOM树。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#parse-java.io.File-">parse</a></span>(<a href="../../../java/io/File.html" title="class in java.io">File</a> f)</code>
|
||
<div class="block">
|
||
<span>将给定文件的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>abstract <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#parse-org.xml.sax.InputSource-">parse</a></span>(<a href="../../../org/xml/sax/InputSource.html" title="class in org.xml.sax">InputSource</a> is)</code>
|
||
<div class="block">
|
||
<span>将给定输入源的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#parse-java.io.InputStream-">parse</a></span>(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> is)</code>
|
||
<div class="block">
|
||
<span>将给定的<code>InputStream</code>的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i9">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#parse-java.io.InputStream-java.lang.String-">parse</a></span>(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> is, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId)</code>
|
||
<div class="block">
|
||
<span>将给定的<code>InputStream</code>的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i10">
|
||
<td class="colFirst"><code><a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#parse-java.lang.String-">parse</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
<span>将给定URI的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i11">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#reset--">reset</a></span>()</code>
|
||
<div class="block">
|
||
将此
|
||
<code>DocumentBuilder</code>重置为原始配置。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i12">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#setEntityResolver-org.xml.sax.EntityResolver-">setEntityResolver</a></span>(<a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a> er)</code>
|
||
<div class="block">
|
||
<span>指定要用于解析要解析的XML文档中存在的实体的<a href="../../../org/xml/sax/EntityResolver.html" title="org.xml.sax中的接口"><code>EntityResolver</code></a> 。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i13">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/parsers/DocumentBuilder.html#setErrorHandler-org.xml.sax.ErrorHandler-">setErrorHandler</a></span>(<a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a> eh)</code>
|
||
<div class="block">
|
||
<span>指定解析器使用的<a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> 。</span>
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
|
||
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="details">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="DocumentBuilder--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>DocumentBuilder</h4> <pre>protected DocumentBuilder()</pre>
|
||
<div class="block">
|
||
受保护的构造函数
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="reset--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>reset</h4> <pre>public void reset()</pre>
|
||
<div class="block">
|
||
<p> <span>将此<code>DocumentBuilder</code>重置为原始配置。</span> </p>
|
||
<p> <span><code>DocumentBuilder</code>被重置为与使用<a href="../../../javax/xml/parsers/DocumentBuilderFactory.html#newDocumentBuilder--"><code>DocumentBuilderFactory.newDocumentBuilder()</code></a>创建时相同的状态。</span> <span><code>reset()</code>旨在允许现有的<code>DocumentBuilder</code> s的重用,从而节省了与创建新的<code>DocumentBuilder</code>的资源。</span> </p>
|
||
<p> <span>重置<code>DocumentBuilder</code>不能保证具有相同的<a href="../../../org/xml/sax/EntityResolver.html" title="org.xml.sax中的接口"><code>EntityResolver</code></a>或<a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> <code>Object</code> s,例如<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(Object obj)</code></a> 。</span> <span>保证功能相当于<code>EntityResolver</code>和<code>ErrorHandler</code> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 实现时不覆盖此方法。
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="parse-java.io.InputStream-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>parse</h4> <pre>public <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> parse(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> is)
|
||
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
|
||
<a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>将给定的<code>InputStream</code>的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
<span>一个<code>IllegalArgumentException</code>如果抛出<code>InputStream</code>为空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>is</code> - 包含要解析的内容的InputStream。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>Document</code>解析的结果
|
||
<code>InputStream</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生任何IO错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 如果发生任何解析错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>is</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="parse-java.io.InputStream-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>parse</h4> <pre>public <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> parse(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> is,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> systemId)
|
||
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
|
||
<a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>将给定的<code>InputStream</code>的内容解析为XML文档并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
<span>一个<code>IllegalArgumentException</code>如果抛出<code>InputStream</code>为空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>is</code> - 包含要解析的内容的InputStream。
|
||
</dd>
|
||
<dd>
|
||
<code>systemId</code> - 提供解决相对URI的基础。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个新的DOM文档对象。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生任何IO错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 如果发生任何解析错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>is</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="parse-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>parse</h4> <pre>public <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> parse(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)
|
||
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
|
||
<a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>将给定URI的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
<span>一个<code>IllegalArgumentException</code>如果URI是被抛出<code>null</code>空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>uri</code> - 要解析的内容的位置。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个新的DOM文档对象。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生任何IO错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 如果发生任何解析错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>uri</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="parse-java.io.File-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>parse</h4> <pre>public <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> parse(<a href="../../../java/io/File.html" title="class in java.io">File</a> f)
|
||
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
|
||
<a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>将给定文件的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
<span>一个<code>IllegalArgumentException</code>如果抛出<code>File</code>是<code>null</code>空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>f</code> - 包含要解析的XML的文件。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个新的DOM文档对象。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生任何IO错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 如果发生任何解析错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>f</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="parse-org.xml.sax.InputSource-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>parse</h4> <pre>public abstract <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> parse(<a href="../../../org/xml/sax/InputSource.html" title="class in org.xml.sax">InputSource</a> is)
|
||
throws <a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a>,
|
||
<a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>将给定输入源的内容解析为XML文档,并返回一个新的DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象。</span>
|
||
<span>一个<code>IllegalArgumentException</code>如果抛出<code>InputSource</code>是<code>null</code>空。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>is</code> - 包含要解析的内容的InputSource。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个新的DOM文档对象。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生任何IO错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../org/xml/sax/SAXException.html" title="class in org.xml.sax">SAXException</a></code> - 如果发生任何解析错误。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>is</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../org/xml/sax/DocumentHandler.html" title="org.xml.sax中的接口"><code>DocumentHandler</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isNamespaceAware--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isNamespaceAware</h4> <pre>public abstract boolean isNamespaceAware()</pre>
|
||
<div class="block">
|
||
指示此解析器是否配置为了解命名空间。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果此解析器配置为了解命名空间,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isValidating--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isValidating</h4> <pre>public abstract boolean isValidating()</pre>
|
||
<div class="block">
|
||
指示此解析器是否配置为验证XML文档。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>如果此解析器配置为验证XML文档,则为true;</span>
|
||
<span>否则为假。</span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setEntityResolver-org.xml.sax.EntityResolver-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setEntityResolver</h4> <pre>public abstract void setEntityResolver(<a href="../../../org/xml/sax/EntityResolver.html" title="interface in org.xml.sax">EntityResolver</a> er)</pre>
|
||
<div class="block">
|
||
<span>指定要用于解析要解析的XML文档中存在的实体的<a href="../../../org/xml/sax/EntityResolver.html" title="org.xml.sax中的接口"><code>EntityResolver</code></a> 。</span>
|
||
<span>将其设置为<code>null</code>将导致使用它自己的默认实现和行为的底层实现。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>er</code> - 要用于解析要解析的XML文档中存在的实体的
|
||
<code>EntityResolver</code> 。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setErrorHandler-org.xml.sax.ErrorHandler-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setErrorHandler</h4> <pre>public abstract void setErrorHandler(<a href="../../../org/xml/sax/ErrorHandler.html" title="interface in org.xml.sax">ErrorHandler</a> eh)</pre>
|
||
<div class="block">
|
||
<span>指定解析器使用的<a href="../../../org/xml/sax/ErrorHandler.html" title="org.xml.sax中的接口"><code>ErrorHandler</code></a> 。</span>
|
||
<span>将其设置为<code>null</code>将导致使用它自己的默认实现和行为的底层实现。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>eh</code> - 解析器使用的
|
||
<code>ErrorHandler</code> 。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="newDocument--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>newDocument</h4> <pre>public abstract <a href="../../../org/w3c/dom/Document.html" title="interface in org.w3c.dom">Document</a> newDocument()</pre>
|
||
<div class="block">
|
||
<span>获取DOM <a href="../../../org/w3c/dom/Document.html" title="界面在org.w3c.dom"><code>Document</code></a>对象的新实例以构建一个DOM树。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个DOM文档对象的新实例。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getDOMImplementation--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getDOMImplementation</h4> <pre>public abstract <a href="../../../org/w3c/dom/DOMImplementation.html" title="interface in org.w3c.dom">DOMImplementation</a> getDOMImplementation()</pre>
|
||
<div class="block">
|
||
<span>获取一个<a href="../../../org/w3c/dom/DOMImplementation.html" title="界面在org.w3c.dom"><code>DOMImplementation</code></a>对象的实例。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个新的一个
|
||
<code>DOMImplementation</code> 。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getSchema--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getSchema</h4> <pre>public <a href="../../../javax/xml/validation/Schema.html" title="class in javax.xml.validation">Schema</a> getSchema()</pre>
|
||
<div class="block">
|
||
<p> <span>获取到的基准<a href="../../../javax/xml/validation/Schema.html" title="javax.xml.validation中的类"><code>Schema</code></a>正在使用的XML处理器。</span> </p>
|
||
<p> <span>如果没有使用模式,则返回<code>null</code> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/validation/Schema.html" title="javax.xml.validation中的类"><code>Schema</code></a>正在使用或<code>null</code>如果没有使用</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 实现时不覆盖此方法
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isXIncludeAware--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>isXIncludeAware</h4> <pre>public boolean isXIncludeAware()</pre>
|
||
<div class="block">
|
||
<p>获取此解析器的XInclude处理模式。 </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
当这个解析器从工厂创建时,返回值为
|
||
<a href="../../../javax/xml/parsers/DocumentBuilderFactory.html#isXIncludeAware--"><code>DocumentBuilderFactory.isXIncludeAware()</code></a> 。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 实现时不覆盖此方法
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/xml/parsers/DocumentBuilderFactory.html#setXIncludeAware-boolean-"><code>DocumentBuilderFactory.setXIncludeAware(boolean)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |