mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-02 06:32:44 +08:00
211 lines
12 KiB
HTML
211 lines
12 KiB
HTML
<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><element xmlns:prefix="http://Namespace-name-URI"></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><element xmlns:prefix1="http://Namespace-name-URI"
|
||
xmlns:prefix2="http://Namespace-name-URI"></span> </pre>
|
||
<span>当在逻辑父元素层次结构中的多个<code>XMLConstants.XMLNS_ATTRIBUTE</code> (“xmlns”)命名空间声明中使用相同的命名空间URI时,也会发生这种情况。</span>
|
||
<span>例如</span>
|
||
<br/>
|
||
<pre> <span><parent xmlns:prefix1="http://Namespace-name-URI">
|
||
<child xmlns:prefix2="http://Namespace-name-URI">
|
||
...
|
||
</child>
|
||
</parent></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 <default Namespace URI> <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 <default Namespace URI> <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> |