mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 09:02:49 +08:00
626 lines
33 KiB
HTML
626 lines
33 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
org.xml.sax.helpers
|
||
</div>
|
||
<h2 class="title" title="Class NamespaceSupport">Class NamespaceSupport</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>org.xml.sax.helpers.NamespaceSupport</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public class <span class="typeNameLabel">NamespaceSupport</span>
|
||
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
|
||
<div class="block">
|
||
<span>封装使用SAX的应用程序或由SAX驱动程序内部使用的命名空间逻辑。</span>
|
||
<blockquote>
|
||
<span><em>This module, both source code and documentation, is in the Public Domain, and comes with <strong>NO WARRANTY</strong>.</em> See <a href="http://www.saxproject.org">http://www.saxproject.org</a> for further information.</span>
|
||
</blockquote>
|
||
<p> <span>该类封装了命名空间处理的逻辑:它跟踪每个上下文当前有效的声明,并将合格的XML名称自动处理到其命名空间部分中;</span> <span>它也可以相反地用于从命名空间生成XML qnames。</span> </p>
|
||
<p> <span>命名空间支持对象是可重用的,但必须在每个会话之间调用reset方法。</span> </p>
|
||
<p> <span>这是一个简单的会话:</span> </p>
|
||
<pre> <span>String parts[] = new String[3];
|
||
NamespaceSupport support = new NamespaceSupport();
|
||
|
||
support.pushContext();
|
||
support.declarePrefix("", "http://www.w3.org/1999/xhtml");
|
||
support.declarePrefix("dc", "http://www.purl.org/dc#");
|
||
|
||
parts = support.processName("p", parts, false);
|
||
System.out.println("Namespace URI: " + parts[0]);
|
||
System.out.println("Local name: " + parts[1]);
|
||
System.out.println("Raw name: " + parts[2]);
|
||
|
||
parts = support.processName("dc:title", parts, false);
|
||
System.out.println("Namespace URI: " + parts[0]);
|
||
System.out.println("Local name: " + parts[1]);
|
||
System.out.println("Raw name: " + parts[2]);
|
||
|
||
support.popContext();</span> </pre>
|
||
<p> <span>请注意,此类针对大多数元素不包含Namespace声明的用例进行了优化:如果为每个上下文重复相同的前缀/ URI映射(例如),则此类的效率会稍差一些。</span> </p>
|
||
<p> <span>虽然SAX驱动程序(解析器)可能会选择使用这个类来实现命名空间处理,但是它们不需要这样做。</span> <span>如果要使用命名空间信息,应用程序本身必须跟踪命名空间信息。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
SAX 2.0
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- =========== FIELD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.summary">
|
||
<!-- --> </a> <h3>Field Summary</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
|
||
<caption>
|
||
<span>Fields</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Field and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>static <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/xml/sax/helpers/NamespaceSupport.html#NSDECL">NSDECL</a></span></code>
|
||
<div class="block">
|
||
命名空间声明URI为常量。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>static <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/xml/sax/helpers/NamespaceSupport.html#XMLNS">XMLNS</a></span></code>
|
||
<div class="block">
|
||
XML命名空间URI作为常量。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<!-- ======== 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="colOne" scope="col">Constructor and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#NamespaceSupport--">NamespaceSupport</a></span>()</code>
|
||
<div class="block">
|
||
创建一个新的Namespace支持对象。
|
||
</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="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>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#declarePrefix-java.lang.String-java.lang.String-">declarePrefix</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> prefix, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
声明一个命名空间前缀。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code><a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getDeclaredPrefixes--">getDeclaredPrefixes</a></span>()</code>
|
||
<div class="block">
|
||
返回在此上下文中声明的所有前缀的枚举。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<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/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-">getPrefix</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
返回映射到命名空间URI的前缀之一。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code><a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes--">getPrefixes</a></span>()</code>
|
||
<div class="block">
|
||
返回其声明在当前上下文中处于活动状态的所有前缀的枚举。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code><a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes-java.lang.String-">getPrefixes</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
返回给定URI的所有前缀的枚举,其声明在当前上下文中处于活动状态。
|
||
</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/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-">getURI</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="altColor" id="i6">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#isNamespaceDeclUris--">isNamespaceDeclUris</a></span>()</code>
|
||
<div class="block">
|
||
如果将命名空间声明属性放入命名空间,则返回true。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#popContext--">popContext</a></span>()</code>
|
||
<div class="block">
|
||
恢复到以前的命名空间上下文。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<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/xml/sax/helpers/NamespaceSupport.html#processName-java.lang.String-java.lang.String:A-boolean-">processName</a></span>(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> qName, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a>[] parts, boolean isAttribute)</code>
|
||
<div class="block">
|
||
处理原始XML限定名,之后在目前情况下的所有声明已被处理
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#declarePrefix-java.lang.String-java.lang.String-"><code>declarePrefix()</code></a> 。
|
||
</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/xml/sax/helpers/NamespaceSupport.html#pushContext--">pushContext</a></span>()</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/xml/sax/helpers/NamespaceSupport.html#reset--">reset</a></span>()</code>
|
||
<div class="block">
|
||
重置此Namespace支持对象以供重用。
|
||
</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/xml/sax/helpers/NamespaceSupport.html#setNamespaceDeclUris-boolean-">setNamespaceDeclUris</a></span>(boolean value)</code>
|
||
<div class="block">
|
||
控制命名空间声明属性是否被
|
||
<code>processName()</code>放入
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#NSDECL"><code>NSDECL</code></a>命名
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#processName-java.lang.String-java.lang.String:A-boolean-">空间中</a> 。
|
||
</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">
|
||
<!-- ============ FIELD DETAIL =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.detail">
|
||
<!-- --> </a> <h3>字段详细信息</h3> <a name="XMLNS">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>XMLNS</h4> <pre>public static final <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> XMLNS</pre>
|
||
<div class="block">
|
||
<span>XML命名空间URI作为常量。</span>
|
||
<span>值为<code>http://www.w3.org/XML/1998/namespace</code> ,如“XML中的命名空间”*中所定义。</span>
|
||
<p> <span>这是自动映射到“xml”前缀的命名空间URI。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../constant-values.html#org.xml.sax.helpers.NamespaceSupport.XMLNS">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="NSDECL">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>NSDECL</h4> <pre>public static final <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> NSDECL</pre>
|
||
<div class="block">
|
||
<span>命名空间声明URI为常量。</span>
|
||
<span>值为<code>http://www.w3.org/xmlns/2000/</code> ,如“XML中的命名空间”推荐与向后不兼容的错误定义的。</span>
|
||
<span>因为这个勘误后SAX2,SAX2默认为原来的建议,通常不会使用这个URI。</span>
|
||
<p> <span>这是可选地应用于<em>xmlns</em>和<em>xmlns:*</em>属性的命名空间URI,用于声明命名空间。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
SAX 2.1alpha
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#setNamespaceDeclUris-boolean-"><code>setNamespaceDeclUris(boolean)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#isNamespaceDeclUris--"><code>isNamespaceDeclUris()</code></a> ,
|
||
<a href="../../../../constant-values.html#org.xml.sax.helpers.NamespaceSupport.NSDECL">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="NamespaceSupport--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>NamespaceSupport</h4> <pre>public NamespaceSupport()</pre>
|
||
<div class="block">
|
||
创建一个新的Namespace支持对象。
|
||
</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">
|
||
<span>重置此Namespace支持对象以供重用。</span>
|
||
<p> <span>在重新使用新会话的Namespace支持对象之前,需要调用此方法。</span> <span>如果要支持命名空间声明URI,则该标志也必须设置为非默认值。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#setNamespaceDeclUris-boolean-"><code>setNamespaceDeclUris(boolean)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="pushContext--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>pushContext</h4> <pre>public void pushContext()</pre>
|
||
<div class="block">
|
||
<span>启动一个新的命名空间上下文。</span>
|
||
<span>新的上下文将自动继承其父上下文的声明,但它也将跟踪在此上下文中进行的声明。</span>
|
||
<p> <span>事件回调代码应该为每个元素启动一个新的上下文。</span> <span>这意味着准备在两个地方之间调用。</span> <span>对于不包含命名空间声明的元素, <em>ContentHandler.startElement()</em>回调是正确的位置。</span> <span>对于具有这种声明的元素,它在第一个<em>ContentHandler.startPrefixMapping()</em>回调中完成。</span> <span>可以使用布尔标志来跟踪上下文是否已经开始。</span> <span>当调用这些方法之一时,它会检查该标志以查看是否需要启动新的上下文。</span> <span>如果是这样,它启动上下文并设置该标志。</span> <span>在<em>ContentHandler.startElement()</em>这样做之后,它总是清除该标志。</span> </p>
|
||
<p> <span>通常,SAX驱动程序将在每个XML元素的开头推送一个新的上下文。</span> <span>然后,他们首先执行属性来处理所有命名空间声明,从而使<em>ContentHandler.startPrefixMapping()</em>回调。</span> <span>然后进行第二次传递,以确定所有属性和元素名称的命名空间限定名称。</span> <span>最后, <em>ContentHandler.startElement()</em>回调的所有信息都可用,因此可以被创建。</span> </p>
|
||
<p> <span>命名空间支持对象始终以已经有效的基本上下文开头:在这种情况下,只会声明“xml”前缀。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../../org/xml/sax/ContentHandler.html" title="org.xml.sax中的接口"><code>ContentHandler</code></a> , <a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#popContext--"><code>popContext()</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="popContext--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>popContext</h4> <pre>public void popContext()</pre>
|
||
<div class="block">
|
||
<span>恢复到以前的命名空间上下文。</span>
|
||
<p> <span>通常,您应该弹出每个XML元素末尾的上下文。</span> <span>弹出上下文后,所有先前有效的命名空间前缀映射都将被还原。</span> </p>
|
||
<p> <span>弹出上下文后,您不得尝试声明额外的命名空间前缀,除非您首先推送另一个上下文。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#pushContext--"><code>pushContext()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="declarePrefix-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>declarePrefix</h4> <pre>public boolean declarePrefix(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> prefix,
|
||
<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> uri)</pre>
|
||
<div class="block">
|
||
<span>声明一个命名空间前缀。</span>
|
||
<span>引用前必须声明所有前缀。</span>
|
||
<span>例如,SAX驱动程序(解析器)将以两遍的方式扫描元素的属性:首先用于命名空间声明,然后使用<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#processName-java.lang.String-java.lang.String:A-boolean-"><code>processName()</code></a>解释前缀(可能重新定义)前缀的第二遍。</span>
|
||
<p> <span>此方法在当前命名空间上下文中声明一个前缀;</span> <span>前缀将保持有效,直到弹出上下文,除非它在后代上下文中被隐藏。</span> </p>
|
||
<p> <span>要声明默认元素Namespace,请使用空字符串作为前缀。</span> </p>
|
||
<p> <span>请注意,此库中存在不对称: <a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-"><code>getPrefix</code></a>不会返回“”前缀,即使已声明默认元素命名空间。</span> <span>要检查默认命名空间,您必须使用<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI</code>显式查找</a> 。</span> <span>存在这种不对称性,以便更容易地查找属性名称的前缀,其中不允许使用默认前缀。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>prefix</code> - 要声明的前缀,或用于指示默认元素命名空间的空字符串。</span>
|
||
<span>这可能永远不会有值“xml”或“xmlns”。</span>
|
||
</dd>
|
||
<dd>
|
||
<code>uri</code> - 与前缀关联的命名空间URI。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
如果前缀合法,则为true,否则为false
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#processName-java.lang.String-java.lang.String:A-boolean-"><code>processName(java.lang.String, java.lang.String[], boolean)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI(java.lang.String)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-"><code>getPrefix(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="processName-java.lang.String-java.lang.String:A-boolean-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>processName</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a>[] processName(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> qName,
|
||
<a href="../../../../java/lang/String.html" title="class in java.lang">String</a>[] parts,
|
||
boolean isAttribute)</pre>
|
||
<div class="block">
|
||
<span>处理原始XML限定名,之后在目前情况下的所有声明已被处理<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#declarePrefix-java.lang.String-java.lang.String-"><code>declarePrefix()</code></a> 。</span>
|
||
<p> <span>此方法通过删除前缀并在当前声明的前缀中查找原始XML限定名称来处理当前上下文中的原始XML限定名称。</span> <span>返回值将是调用者提供的数组,填入如下:</span> </p>
|
||
<dl>
|
||
<dt>
|
||
<span>零件[0]</span>
|
||
</dt>
|
||
<dd>
|
||
<span>命名空间URI,或空字符串,如果没有使用。</span>
|
||
</dd>
|
||
<dt>
|
||
<span>零件[1]</span>
|
||
</dt>
|
||
<dd>
|
||
<span>本地名称(无前缀)。</span>
|
||
</dd>
|
||
<dt>
|
||
<span>零件[2]</span>
|
||
</dt>
|
||
<dd>
|
||
<span>原始的原始名称。</span>
|
||
</dd>
|
||
</dl>
|
||
<p> <span>数组中的所有字符串将被内化。</span> <span>如果原始名称的前缀未被声明,那么返回值将为null。</span> </p>
|
||
<p> <span>请注意,属性名称的处理方式与元素名称不同:未校正的元素名称将接收默认名称空间(如果有),而未定义的属性名称将不会。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>qName</code> - 要处理的XML限定名称。
|
||
</dd>
|
||
<dd>
|
||
<code>parts</code> - 由调用者提供的一个数组,能够容纳至少三个成员。
|
||
</dd>
|
||
<dd>
|
||
<code>isAttribute</code> - 表示这是属性名称(true)还是元素名称(false)的标志。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span>提供的数组包含三个表示命名空间URI(或空字符串)的内部字符串,本地名称和XML限定名称;</span>
|
||
<span>如果有未声明的前缀,则为null。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#declarePrefix-java.lang.String-java.lang.String-"><code>declarePrefix(java.lang.String, java.lang.String)</code></a> ,
|
||
<a href="../../../../java/lang/String.html#intern--"><code>String.intern()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getURI-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getURI</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getURI(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</pre>
|
||
<div class="block">
|
||
<span>查找前缀并获取当前映射的命名空间URI。</span>
|
||
<p> <span>此方法查找当前上下文中的前缀。</span> <span>使用空字符串(“”)作为默认命名空间。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>prefix</code> - 要查找的前缀。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
关联的命名空间URI,如果前缀在此上下文中未声明,则为null。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-"><code>getPrefix(java.lang.String)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes--"><code>getPrefixes()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getPrefixes--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getPrefixes</h4> <pre>public <a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a> getPrefixes()</pre>
|
||
<div class="block">
|
||
<span>返回其声明在当前上下文中处于活动状态的所有前缀的枚举。</span>
|
||
<span>这包括父上下文中尚未被覆盖的声明。</span>
|
||
<p> <span><strong>注意:</strong>如果有默认的前缀,则不会在此枚举中返回;</span> <span>使用参数为“”的<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI</code></a>检查默认前缀。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
枚举前缀(从不为空)。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getDeclaredPrefixes--"><code>getDeclaredPrefixes()</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getPrefix-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getPrefix</h4> <pre>public <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> uri)</pre>
|
||
<div class="block">
|
||
<span>返回映射到命名空间URI的前缀之一。</span>
|
||
<p> <span>如果多个前缀当前映射到同一个URI,则该方法将进行任意选择;</span> <span>如果您想要所有的前缀,请<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes--">改用<code>getPrefixes()</code></a>方法。</span> </p>
|
||
<p> <span><strong>注意:</strong>这将永远不会返回空(默认)前缀;</span> <span>要检查默认前缀,请使用参数为“”的<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI</code></a>方法。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>uri</code> - 命名空间URI
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
当前映射到提供的URI的前缀之一,如果没有映射,则为空,或者将URI分配给默认命名空间
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes-java.lang.String-"><code>getPrefixes(java.lang.String)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getPrefixes-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getPrefixes</h4> <pre>public <a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a> getPrefixes(<a href="../../../../java/lang/String.html" title="class in java.lang">String</a> uri)</pre>
|
||
<div class="block">
|
||
<span>返回给定URI的所有前缀的枚举,其声明在当前上下文中处于活动状态。</span>
|
||
<span>这包括父上下文中尚未被覆盖的声明。</span>
|
||
<p> <span>此方法返回映射到特定命名空间URI的前缀。</span> <span>将包括xml:前缀。</span> <span>如果您只想要一个映射到命名空间URI的前缀,并且您不在乎哪个前缀,请<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-">改用<code>getPrefix</code></a>方法。</span> </p>
|
||
<p> <span><strong>注意:</strong>空(默认)前缀<em>从不</em>包含在此枚举中;</span> <span>检查是否存在默认名称空间,请使用参数“”“的<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI</code></a>方法。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>uri</code> - 命名空间URI。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
枚举前缀(从不为空)。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-"><code>getPrefix(java.lang.String)</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getDeclaredPrefixes--"><code>getDeclaredPrefixes()</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getDeclaredPrefixes--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getDeclaredPrefixes</h4> <pre>public <a href="../../../../java/util/Enumeration.html" title="interface in java.util">Enumeration</a> getDeclaredPrefixes()</pre>
|
||
<div class="block">
|
||
<span>返回在此上下文中声明的所有前缀的枚举。</span>
|
||
<p> <span>空(默认)前缀将包含在此枚举中;</span> <span>请注意,此行为与<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefix-java.lang.String-"><code>getPrefix(java.lang.String)</code></a>和<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes--"><code>getPrefixes()</code>不同</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
枚举在此上下文中声明的所有前缀。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getPrefixes--"><code>getPrefixes()</code></a> ,
|
||
<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#getURI-java.lang.String-"><code>getURI(java.lang.String)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setNamespaceDeclUris-boolean-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setNamespaceDeclUris</h4> <pre>public void setNamespaceDeclUris(boolean value)</pre>
|
||
<div class="block">
|
||
<span>控制命名空间声明属性是否被<code>processName()</code>放入<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#NSDECL"><code>NSDECL</code></a>命名<a href="../../../../org/xml/sax/helpers/NamespaceSupport.html#processName-java.lang.String-java.lang.String:A-boolean-">空间中</a> 。</span>
|
||
<span>这可能只有在任何上下文被推送之前才能更改。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 尝试在任何上下文被推送后设置此选项。
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
SAX 2.1alpha
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isNamespaceDeclUris--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>isNamespaceDeclUris</h4> <pre>public boolean isNamespaceDeclUris()</pre>
|
||
<div class="block">
|
||
<span>如果将命名空间声明属性放入命名空间,则返回true。</span>
|
||
<span>此行为不是默认值。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
SAX 2.1alpha
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |