uTools-Manuals/docs/java/javax/xml/namespace/NamespaceContext.html

211 lines
12 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">
javax.xml.namespace
</div>
<h2 class="title" title="Interface NamespaceContext">Interface NamespaceContext</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">NamespaceContext</span></pre>
<div class="block">
<p> <span>只读XML接口名称空间上下文处理。</span> </p>
<p> <span>XML命名空间具有以下属性</span> </p>
<ul>
<li> <span>命名空间URI命名空间名称表示为前缀绑定到的URI</span> </li>
<li> <span>前缀:在语法上,这是在命名空间声明中的<code>XMLConstants.XMLNS_ATTRIBUTE</code> “xmlns”之后的属性名称的一部分</span> </li>
</ul>
<p> <span>例如: <code>&lt;element xmlns:prefix="http://Namespace-name-URI"&gt;</code></span> </p>
<p> <span>所有<code>get*(*)</code>方法在当前范围内操作命名空间URI和前缀解析。</span> </p>
<p> <span>请注意命名空间URI可以绑定到当前作用域中的<strong>多个</strong>前缀。</span> <span>当多个<code>XMLConstants.XMLNS_ATTRIBUTE</code> “xmlns”命名空间声明发生在同一起始标签中并引用相同的命名空间URI时可能会发生这种情况。</span> <span>例如</span> <br/></p>
<pre> <span>&lt;element xmlns:prefix1="http://Namespace-name-URI"
xmlns:prefix2="http://Namespace-name-URI"&gt;</span> </pre>
<span>当在逻辑父元素层次结构中的多个<code>XMLConstants.XMLNS_ATTRIBUTE</code> “xmlns”命名空间声明中使用相同的命名空间URI时也会发生这种情况。</span>
<span>例如</span>
<br/>
<pre> <span>&lt;parent xmlns:prefix1="http://Namespace-name-URI"&gt;
&lt;child xmlns:prefix2="http://Namespace-name-URI"&gt;
...
&lt;/child&gt;
&lt;/parent&gt;</span> </pre>
<p></p>
<p> <span>前缀只能绑定到当前作用域中的<strong>单个</strong>命名空间URI。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.5
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/xml/XMLConstants.html" title="javax.xml中的类"><code>javax.xml.XMLConstants for declarations of common XML values</code></a> <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part2: Datatypes</a> <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">Namespaces in XML</a> <a href="http://www.w3.org/XML/xml-names-19990114-errata">Namespaces in XML Errata</a></span>
</dd>
</dl> </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="../../../javax/xml/namespace/NamespaceContext.html#getNamespaceURI-java.lang.String-">getNamespaceURI</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</code>
<div class="block">
获取命名空间URI绑定到当前作用域中的前缀。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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="../../../javax/xml/namespace/NamespaceContext.html#getPrefix-java.lang.String-">getPrefix</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI)</code>
<div class="block">
获取前缀绑定到当前作用域中的命名空间URI。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/NamespaceContext.html#getPrefixes-java.lang.String-">getPrefixes</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI)</code>
<div class="block">
获取绑定到当前作用域中的命名空间URI的所有前缀。
</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="getNamespaceURI-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceURI</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespaceURI(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</pre>
<div class="block">
<p> <span>获取命名空间URI绑定到当前作用域中的前缀。</span> </p>
<p> <span>当通过前缀请求命名空间URI时下表描述了所有可能的前缀值返回的命名空间URI值</span> </p>
<span> <code>getNamespaceURI(prefix)</code> return value for specified prefixes prefix parameter Namespace URI return value <code>DEFAULT_NS_PREFIX</code> ("") default Namespace URI in the current scope or <code><a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI("")</code></a> </code> when there is no default Namespace URI in the current scope bound prefix Namespace URI bound to prefix in current scope unbound prefix <code><a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI("")</code></a> </code> <code>XMLConstants.XML_NS_PREFIX</code> ("xml") <code>XMLConstants.XML_NS_URI</code> ("http://www.w3.org/XML/1998/namespace") <code>XMLConstants.XMLNS_ATTRIBUTE</code> ("xmlns") <code>XMLConstants.XMLNS_ATTRIBUTE_NS_URI</code> ("http://www.w3.org/2000/xmlns/") <code>null</code> <code>IllegalArgumentException</code> is thrown </span>
<table border="2" cellpadding="4" rules="all">
</table>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>prefix</code> - 前缀查找
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
命名空间URI绑定到当前作用域中的前缀
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
<code>prefix</code>
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="getPrefix-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPrefix</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPrefix(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI)</pre>
<div class="block">
<p> <span>获取前缀绑定到当前作用域中的命名空间URI。</span> </p>
<p> <span>要获取绑定到当前作用域中的命名空间URI的所有前缀请使用<a href="../../../javax/xml/namespace/NamespaceContext.html#getPrefixes-java.lang.String-"><code>getPrefixes(String namespaceURI)</code></a></span> </p>
<p> <span>当通过Namespace URI请求前缀时下表描述了所有Namespace URI值返回的前缀值</span> </p>
<span> <code>getPrefix(namespaceURI)</code> return value for specified Namespace URIs Namespace URI parameter prefix value returned &lt;default Namespace URI&gt; <code>XMLConstants.DEFAULT_NS_PREFIX</code> ("") bound Namespace URI prefix bound to Namespace URI in the current scope, if multiple prefixes are bound to the Namespace URI in the current scope, a single arbitrary prefix, whose choice is implementation dependent, is returned unbound Namespace URI <code>null</code> <code>XMLConstants.XML_NS_URI</code> ("http://www.w3.org/XML/1998/namespace") <code>XMLConstants.XML_NS_PREFIX</code> ("xml") <code>XMLConstants.XMLNS_ATTRIBUTE_NS_URI</code> ("http://www.w3.org/2000/xmlns/") <code>XMLConstants.XMLNS_ATTRIBUTE</code> ("xmlns") <code>null</code> <code>IllegalArgumentException</code> is thrown </span>
<table border="2" cellpadding="4" rules="all">
</table>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要查找的
<code>namespaceURI</code> URI
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
前缀绑定到当前上下文中的命名空间URI
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
<code>namespaceURI</code>
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="getPrefixes-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getPrefixes</h4> <pre><a href="../../../java/util/Iterator.html" title="interface in java.util">Iterator</a> getPrefixes(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI)</pre>
<div class="block">
<p> <span>获取绑定到当前作用域中的命名空间URI的所有前缀。</span> </p>
<p> <span>一个迭代器上的String元素以任意的 <strong>依赖于实现的</strong>顺序返回。</span> </p>
<p> <span><strong><code>Iterator</code><em>不可</em>修改的。</strong></span> <span><strong>例如<code>remove()</code>方法会抛出<code>UnsupportedOperationException</code></strong></span> </p>
<p> <span>当通过Namespace URI请求前缀时下表描述了所有Namespace URI值返回的前缀值</span> </p>
<span> <code> getPrefixes(namespaceURI)</code> return value for specified Namespace URIs Namespace URI parameter prefixes value returned bound Namespace URI, including the &lt;default Namespace URI&gt; <code>Iterator</code> over prefixes bound to Namespace URI in the current scope in an arbitrary, <strong>implementation dependent</strong>, order unbound Namespace URI empty <code>Iterator</code> <code>XMLConstants.XML_NS_URI</code> ("http://www.w3.org/XML/1998/namespace") <code>Iterator</code> with one element set to <code>XMLConstants.XML_NS_PREFIX</code> ("xml") <code>XMLConstants.XMLNS_ATTRIBUTE_NS_URI</code> ("http://www.w3.org/2000/xmlns/") <code>Iterator</code> with one element set to <code>XMLConstants.XMLNS_ATTRIBUTE</code> ("xmlns") <code>null</code> <code>IllegalArgumentException</code> is thrown </span>
<table border="2" cellpadding="4" rules="all">
</table>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 要查找的
<code>namespaceURI</code> URI
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Iterator</code>用于绑定到当前作用域中的命名空间URI的所有前缀
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当时
<code>namespaceURI</code>
<code>null</code>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>