352 lines
21 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
compact2, compact3
</div>
<div class="subTitle">
org.w3c.dom.ls
</div>
<h2 class="title" title="Interface LSInput">Interface LSInput</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">LSInput</span></pre>
<div class="block">
<span>此接口表示数据的输入源。</span>
<p> <span>该接口允许应用将关于输入源的信息封装在单个对象中该对象可以包括公共标识符系统标识符字节流可能具有指定的编码基本URI和/或字符流。</span> </p>
<p> <span>字节流和字符流的确切定义是依赖于绑定的。</span> </p>
<p> <span>预计应用程序将提供在需要此类对象时实现此接口的对象。</span> <span>应用程序可以提供自己的实现该接口的对象,也可以使用通用的工厂方法<code>DOMImplementationLS.createLSInput()</code>创建实现此接口的对象。</span> </p>
<p> <span><code>LSParser</code>将使用<code>LSInput</code>对象来确定如何读取数据。</span> <span><code>LSParser</code>将着眼于指定的不同的输入<code>LSInput</code>按以下顺序知道从,第一个不为空,而不是将使用空字符串来读取其中之一:</span> </p>
<ol>
<li> <code>LSInput.characterStream</code> </li>
<li> <code>LSInput.byteStream</code> </li>
<li> <code>LSInput.stringData</code> </li>
<li> <code>LSInput.systemId</code> </li>
<li> <code>LSInput.publicId</code> </li>
</ol>
<p> <span>如果所有输入为空, <code>LSParser</code>将报告<code>DOMError</code> ,其<code>DOMError.type</code>设置为<code>"no-input-specified"</code> ,其<code>DOMError.severity</code>设置为<code>DOMError.SEVERITY_FATAL_ERROR</code></span> </p>
<p> <span><code>LSInput</code>对象属于应用程序。</span> <span>DOM实现永远不会修改它们尽管如果需要它可能会复制并修改副本</span> </p>
<p> <span>另见<a href="http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407">Document Object Model (DOM) Level 3 Load and Save Specification</a></span> </p>
</div> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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>
</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><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getBaseURI--">getBaseURI</a></span>()</code>
<div class="block">
要使用的基本URI参见[
<a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的第5.1.4节))将相对值
<code>systemId</code>为绝对URI。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getByteStream--">getByteStream</a></span>()</code>
<div class="block">
表示字节流的语言和绑定依赖类型的属性。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getCertifiedText--">getCertifiedText</a></span>()</code>
<div class="block">
如果设置为true则在解析[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]时,假定输入已被认证(参见[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]中的2.13部分)。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getCharacterStream--">getCharacterStream</a></span>()</code>
<div class="block">
一种表示16位单位流的语言和绑定依赖类型的属性。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getEncoding--">getEncoding</a></span>()</code>
<div class="block">
字符编码,如果知道。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getPublicId--">getPublicId</a></span>()</code>
<div class="block">
该输入源的公共标识符。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getStringData--">getStringData</a></span>()</code>
<div class="block">
要解析的字符串数据。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#getSystemId--">getSystemId</a></span>()</code>
<div class="block">
系统标识符一个URI参考[
<a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ],用于此输入源。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setBaseURI-java.lang.String-">setBaseURI</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> baseURI)</code>
<div class="block">
要使用的基本URI参见[
<a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的5.1.4),用于将相对值
<code>systemId</code>为绝对URI。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setByteStream-java.io.InputStream-">setByteStream</a></span>(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> byteStream)</code>
<div class="block">
表示字节流的语言和绑定依赖类型的属性。
</div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setCertifiedText-boolean-">setCertifiedText</a></span>(boolean certifiedText)</code>
<div class="block">
如果设置为true则在解析[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]时,假设输入已被认证(参见[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]中的2.13部分)。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setCharacterStream-java.io.Reader-">setCharacterStream</a></span>(<a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a> characterStream)</code>
<div class="block">
一种表示16位单位流的语言和绑定依赖类型的属性。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setEncoding-java.lang.String-">setEncoding</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> encoding)</code>
<div class="block">
字符编码,如果知道。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setPublicId-java.lang.String-">setPublicId</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> publicId)</code>
<div class="block">
该输入源的公共标识符。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setStringData-java.lang.String-">setStringData</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> stringData)</code>
<div class="block">
要解析的字符串数据。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/w3c/dom/ls/LSInput.html#setSystemId-java.lang.String-">setSystemId</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> systemId)</code>
<div class="block">
系统标识符一个URI参考[
<a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ],用于此输入源。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getCharacterStream--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCharacterStream</h4> <pre><a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a> getCharacterStream()</pre>
<div class="block">
<span>一种表示16位单位流的语言和绑定依赖类型的属性。</span>
<span>应用程序必须使用UTF-16在[Unicode]和[ISO / IEC 10646]中定义)编码流。</span>
<span>使用字符流时不需要XML声明。</span>
<span>如果存在XML声明则将忽略encoding属性的值。</span>
</div> </li>
</ul> <a name="setCharacterStream-java.io.Reader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setCharacterStream</h4> <pre>void setCharacterStream(<a href="../../../../java/io/Reader.html" title="class in java.io">Reader</a> characterStream)</pre>
<div class="block">
<span>一种表示16位单位流的语言和绑定依赖类型的属性。</span>
<span>应用程序必须使用UTF-16在[Unicode]和[ISO / IEC 10646]中定义)编码流。</span>
<span>使用字符流时不需要XML声明。</span>
<span>如果存在XML声明则将忽略encoding属性的值。</span>
</div> </li>
</ul> <a name="getByteStream--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getByteStream</h4> <pre><a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> getByteStream()</pre>
<div class="block">
<span>表示字节流的语言和绑定依赖类型的属性。</span>
<br/>
<span>如果应用程序知道字节流的字符编码则应该设置encoding属性。</span>
<span>以这种方式设置编码将覆盖数据中XML声明中指定的任何编码。</span>
</div> </li>
</ul> <a name="setByteStream-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setByteStream</h4> <pre>void setByteStream(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> byteStream)</pre>
<div class="block">
<span>表示字节流的语言和绑定依赖类型的属性。</span>
<br/>
<span>如果应用程序知道字节流的字符编码则应该设置encoding属性。</span>
<span>以这种方式设置编码将覆盖数据中XML声明中指定的任何编码。</span>
</div> </li>
</ul> <a name="getStringData--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getStringData</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getStringData()</pre>
<div class="block">
<span>要解析的字符串数据。</span>
<span>如果提供这将始终被视为16位单位UTF-16编码字符的序列。</span>
<span>使用<code>stringData</code><code>stringData</code> XML <code>stringData</code></span>
<span>如果存在XML声明则将忽略encoding属性的值。</span>
</div> </li>
</ul> <a name="setStringData-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setStringData</h4> <pre>void setStringData(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> stringData)</pre>
<div class="block">
<span>要解析的字符串数据。</span>
<span>如果提供这将始终被视为16位单位UTF-16编码字符的序列。</span>
<span>使用<code>stringData</code><code>stringData</code> XML <code>stringData</code></span>
<span>如果存在XML声明则将忽略encoding属性的值。</span>
</div> </li>
</ul> <a name="getSystemId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSystemId</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getSystemId()</pre>
<div class="block">
<span>系统标识符一个URI参考[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ],用于此输入源。</span>
<span>如果有字节流,字符流或字符串数据,则系统标识符是可选的。</span>
<span>提供一个还是有用的因为应用程序将使用它来解析任何相对的URI并将其包含在错误消息和警告中。</span>
<span>如果输入源中没有其他输入LSParser将仅尝试获取由URI引用标识的资源。</span>
<br/>
<span>如果应用程序知道系统标识符指向的对象的字符编码,则可以使用<code>encoding</code>属性来设置编码。</span>
<br/>
<span>如果指定的系统ID是相对URI引用参见[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的第5节则DOM实现将尝试以<code>baseURI</code>作为基础来解析相对URI如果失败则行为依赖于实现。</span>
</div> </li>
</ul> <a name="setSystemId-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setSystemId</h4> <pre>void setSystemId(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> systemId)</pre>
<div class="block">
<span>系统标识符一个URI参考[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ],用于此输入源。</span>
<span>如果有字节流,字符流或字符串数据,则系统标识符是可选的。</span>
<span>提供一个还是有用的因为应用程序将使用它来解析任何相对的URI并将其包含在错误消息和警告中。</span>
<span>如果输入源中没有其他输入LSParser将仅尝试获取由URI引用标识的资源。</span>
<br/>
<span>如果应用程序知道系统标识符指向的对象的字符编码,则可以使用<code>encoding</code>属性设置编码。</span>
<br/>
<span>如果指定的系统ID是相对URI引用参见[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的第5节则DOM实现将尝试以<code>baseURI</code>作为基础来解析相对URI如果失败则该行为依赖于实现。</span>
</div> </li>
</ul> <a name="getPublicId--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPublicId</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getPublicId()</pre>
<div class="block">
<span>该输入源的公共标识符。</span>
<span>这可以使用实现相关机制(例如目录或其他映射)映射到输入源。</span>
<span>公共标识符(如果指定)也可以在报告错误时作为位置信息的一部分报告。</span>
</div> </li>
</ul> <a name="setPublicId-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setPublicId</h4> <pre>void setPublicId(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> publicId)</pre>
<div class="block">
<span>该输入源的公共标识符。</span>
<span>这可以使用实现相关机制(例如目录或其他映射)映射到输入源。</span>
<span>公共标识符(如果指定)也可以在报告错误时作为位置信息的一部分报告。</span>
</div> </li>
</ul> <a name="getBaseURI--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBaseURI</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getBaseURI()</pre>
<div class="block">
<span>要使用的基址URI参见[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的5.1.4),用于将相对值<code>systemId</code>为绝对URI。</span>
<br/>
<span>如果使用时基本URI本身就是一个相对的URI一个空字符串或者是null这个行为是依赖于实现的。</span>
</div> </li>
</ul> <a name="setBaseURI-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setBaseURI</h4> <pre>void setBaseURI(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> baseURI)</pre>
<div class="block">
<span>要使用的基址URI参见[ <a href="http://www.ietf.org/rfc/rfc2396.txt">IETF RFC 2396</a> ]中的5.1.4),用于将相对值<code>systemId</code>为绝对URI。</span>
<br/>
<span>如果使用时基本URI本身就是一个相对的URI一个空字符串或者是null这个行为是依赖于实现的。</span>
</div> </li>
</ul> <a name="getEncoding--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getEncoding</h4> <pre><a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getEncoding()</pre>
<div class="block">
<span>字符编码,如果知道。</span>
<span>编码必须是XML编码声明可接受的字符串[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]第4.3.3节“实体中的字符编码”)。</span>
<br/>
<span>当应用程序提供字符流或字符串数据时,此属性不起作用。</span>
<span>对于其他输入源通过此属性指定的编码将覆盖XML声明或Text声明中指定的任何编码或从较高级别协议例如HTTP [ <a href="http://www.ietf.org/rfc/rfc2616.txt">IETF RFC 2616</a> ])获取的编码。</span>
</div> </li>
</ul> <a name="setEncoding-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setEncoding</h4> <pre>void setEncoding(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> encoding)</pre>
<div class="block">
<span>字符编码,如果知道。</span>
<span>编码必须是XML编码声明可接受的字符串[ <a href="http://www.w3.org/TR/2004/REC-xml-20040204">XML 1.0</a> ]第4.3.3节“实体中的字符编码”)。</span>
<br/>
<span>当应用程序提供字符流或字符串数据时,此属性不起作用。</span>
<span>对于其他输入源通过此属性指定的编码将覆盖XML声明或Text声明中指定的任何编码或从较高级别协议如HTTP [ <a href="http://www.ietf.org/rfc/rfc2616.txt">IETF RFC 2616</a> ])获取的编码。</span>
</div> </li>
</ul> <a name="getCertifiedText--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCertifiedText</h4> <pre>boolean getCertifiedText()</pre>
<div class="block">
如果设置为true则在分析[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]时,假设输入已经过认证(参见[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]中的2.13节))。
</div> </li>
</ul> <a name="setCertifiedText-boolean-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>setCertifiedText</h4> <pre>void setCertifiedText(boolean certifiedText)</pre>
<div class="block">
如果设置为true则假设在解析[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]时输入已被认证(参见[
<a href="http://www.w3.org/TR/2004/REC-xml11-20040204/">XML 1.1</a> ]中的2.13部分)。
</div> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>