mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-01 14:02:44 +08:00
504 lines
27 KiB
HTML
504 lines
27 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.xml.namespace
|
||
</div>
|
||
<h2 class="title" title="Class QName">Class QName</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.namespace.QName</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Implemented Interfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/io/Serializable.html" title="java.io中的接口">Serializable</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public class <span class="typeNameLabel">QName</span>
|
||
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>
|
||
implements <a href="../../../java/io/Serializable.html" title="interface in java.io">Serializable</a></pre>
|
||
<div class="block">
|
||
<p> <span><code>QName</code>表示如在XML规范中定义一个<strong>限定名</strong> ： <a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part2: Datatypes specification</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> </p>
|
||
<p> <span><code>QName</code>的值包含<strong>命名空间URI</strong> ， <strong>本地部分</strong>和<strong>前缀</strong> 。</span> </p>
|
||
<p> <span><code>QName</code>中包含前缀以保留词汇信息， <strong><em>如果存在</em></strong>于<a href="../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>XML input source</code>中</a> 。</span> <span>前缀<strong><em>不</em></strong>用于<a href="../../../javax/xml/namespace/QName.html#equals-java.lang.Object-"><code>QName.equals(Object)</code></a>或计算<a href="../../../javax/xml/namespace/QName.html#hashCode--"><code>QName.hashCode()</code></a> 。</span> <span><strong><em>仅</em></strong>使用命名空间URI和本地部分定义等式和哈希码。</span> </p>
|
||
<p> <span>如果未指定，则命名空间URI设置为<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a> 。</span> <span>如果未指定，则前缀设置为<a href="../../../javax/xml/XMLConstants.html#DEFAULT_NS_PREFIX"><code>XMLConstants.DEFAULT_NS_PREFIX</code></a> 。</span> </p>
|
||
<p> <span><code>QName</code>是不可变的。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">Version:</span>
|
||
</dt>
|
||
<dd>
|
||
$修订：1.8 $，$日期：2010/03/18 03:06:17 $
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="http://www.w3.org/TR/xmlschema-2/#QName">XML Schema Part2: Datatypes specification</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> ，
|
||
<a href="../../../serialized-form.html#javax.xml.namespace.QName">Serialized Form</a>
|
||
</dd>
|
||
</dl> </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="colOne" scope="col">Constructor and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-">QName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart)</code>
|
||
<div class="block">
|
||
<code>QName</code>指定本地零件的构造函数。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-">QName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart)</code>
|
||
<div class="block">
|
||
<code>QName</code>构造函数指定命名空间URI和本地部分。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-java.lang.String-">QName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</code>
|
||
<div class="block">
|
||
<code>QName</code>构造函数指定命名空间URI，本地部分和前缀。
|
||
</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="t1"><span><a href="javascript:show(1);">静态方法</a></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="../../../javax/xml/namespace/QName.html#equals-java.lang.Object-">equals</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> objectToTest)</code>
|
||
<div class="block">
|
||
测试这
|
||
<code>QName</code>与另一个
|
||
<code>Object</code>的平等。
|
||
</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/QName.html#getLocalPart--">getLocalPart</a></span>()</code>
|
||
<div class="block">
|
||
获取本
|
||
<code>QName</code>的本地部分。
|
||
</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="../../../javax/xml/namespace/QName.html#getNamespaceURI--">getNamespaceURI</a></span>()</code>
|
||
<div class="block">
|
||
获取此的命名空间URI
|
||
<code>QName</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<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/QName.html#getPrefix--">getPrefix</a></span>()</code>
|
||
<div class="block">
|
||
获取此
|
||
<code>QName</code>的前缀。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/QName.html#hashCode--">hashCode</a></span>()</code>
|
||
<div class="block">
|
||
生成这个
|
||
<code>QName</code>的哈希码。
|
||
</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="../../../javax/xml/namespace/QName.html#toString--">toString</a></span>()</code>
|
||
<div class="block">
|
||
<code>String</code>这个
|
||
<code>QName</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>static <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/namespace/QName.html#valueOf-java.lang.String-">valueOf</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> qNameAsString)</code>
|
||
<div class="block">
|
||
<code>QName</code>源自解析格式化的
|
||
<code>String</code> 。
|
||
</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#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</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#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="QName-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>QName</h4> <pre>public QName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart)</pre>
|
||
<div class="block">
|
||
<p> <span><code>QName</code>构造函数指定命名空间URI和本地部分。</span> </p>
|
||
<p> <span>如果命名空间URI为<code>null</code> ，则设置为<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a> 。</span> <span>该值表示没有由Namespaces in XML规范定义的明确定义的<a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">命名</a>空间。</span> <span>此操作保留与QName 1.0兼容的行为。</span> <span>明确地提供所述<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a>值是首选的编码样式。</span> </p>
|
||
<p> <span>如果当地部分是<code>null</code> ，则抛出<code>IllegalArgumentException</code> 。</span> <span>允许“”的本地部分保留与QName 1.0的兼容行为。</span> </p>
|
||
<p> <span>使用此构造函数时，前缀设置为<a href="../../../javax/xml/XMLConstants.html#DEFAULT_NS_PREFIX"><code>XMLConstants.DEFAULT_NS_PREFIX</code></a> 。</span> </p>
|
||
<p> <span>命名空间URI未被验证为<a href="http://www.ietf.org/rfc/rfc2396.txt">URI reference</a> 。</span> <span>本地部分不会验证为<a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>在指定的<a href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>namespaceURI</code> -命名空间的URI
|
||
<code>QName</code>
|
||
</dd>
|
||
<dd>
|
||
<code>localPart</code> - 本地部分
|
||
<code>QName</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当时
|
||
<code>localPart</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-java.lang.String-"><code>QName(String namespaceURI, String localPart, String prefix)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="QName-java.lang.String-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>QName</h4> <pre>public QName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</pre>
|
||
<div class="block">
|
||
<p> <span><code>QName</code>构造函数指定命名空间URI，本地部分和前缀。</span> </p>
|
||
<p> <span>如果命名空间URI为<code>null</code> ，则设置为<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a> 。</span> <span>该值不表示由Namespaces in XML规范定义的明确定义的<a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">命名</a>空间。</span> <span>此操作保留与QName 1.0兼容的行为。</span> <span>明确提供<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a>值是首选的编码风格。</span> </p>
|
||
<p> <span>如果当地部分是<code>null</code> ，则抛出<code>IllegalArgumentException</code> 。</span> <span>允许“”的本地部分保留与QName 1.0的兼容行为。</span> </p>
|
||
<p> <span>如果前缀为<code>null</code> ，则会抛出一个<code>IllegalArgumentException</code> 。</span> <span>使用<a href="../../../javax/xml/XMLConstants.html#DEFAULT_NS_PREFIX"><code>XMLConstants.DEFAULT_NS_PREFIX</code></a>来明确表示没有前缀，或前缀不相关。</span> </p>
|
||
<p> <span>命名空间URI未验证为<a href="http://www.ietf.org/rfc/rfc2396.txt">URI reference</a> 。</span> <span>本地部分和前缀不验证为<a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>在指定的<a href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>namespaceURI</code> -命名空间的URI
|
||
<code>QName</code>
|
||
</dd>
|
||
<dd>
|
||
<code>localPart</code> - 本地部分
|
||
<code>QName</code>
|
||
</dd>
|
||
<dd>
|
||
<code>prefix</code> - 前缀的
|
||
<code>QName</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> -
|
||
<code>localPart</code>或
|
||
<code>prefix</code>为
|
||
<code>null</code>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="QName-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>QName</h4> <pre>public QName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localPart)</pre>
|
||
<div class="block">
|
||
<p> <span><code>QName</code>指定本地零件的构造函数。</span> </p>
|
||
<p> <span>如果本地的部分是<code>null</code> ，则抛出一个<code>IllegalArgumentException</code> 。</span> <span>允许“”的本地部分保留与QName 1.0的兼容行为。</span> </p>
|
||
<p> <span>使用此构造函数时，命名空间URI设置为<a href="../../../javax/xml/XMLConstants.html#NULL_NS_URI"><code>XMLConstants.NULL_NS_URI</code></a> ，前缀设置为<a href="../../../javax/xml/XMLConstants.html#DEFAULT_NS_PREFIX"><code>XMLConstants.DEFAULT_NS_PREFIX</code></a> 。</span> </p>
|
||
<p> <span><em>在XML上下文中，所有元素和属性名称都存在于命名空间的上下文中。</em></span> <span><em>制作施工时此明确<code>QName</code>有助于避免诊断XML有效性错误。</em></span> <span><em>构造器<a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-"><code>QName(String namespaceURI, String localPart)</code></a>和<a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-java.lang.String-"><code>QName(String namespaceURI, String localPart, String prefix)</code></a>是优选的。</em></span> </p>
|
||
<p> <span>本地部分不会验证为<a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>在指定的<a href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>localPart</code> - 本地部分
|
||
<code>QName</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>localPart</code>是
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-"><code>QName(String namespaceURI, String localPart)</code></a> ，
|
||
<a href="../../../javax/xml/namespace/QName.html#QName-java.lang.String-java.lang.String-java.lang.String-"><code>QName(String namespaceURI, String localPart, String prefix)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getNamespaceURI--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getNamespaceURI</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespaceURI()</pre>
|
||
<div class="block">
|
||
<p>获取此的命名空间URI <code>QName</code> 。 </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
这个
|
||
<code>QName</code>空间URI
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getLocalPart--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getLocalPart</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getLocalPart()</pre>
|
||
<div class="block">
|
||
<p>获取本<code>QName</code>的本地部分。 </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
本地部分
|
||
<code>QName</code>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getPrefix--">
|
||
<!-- --> </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()</pre>
|
||
<div class="block">
|
||
<p> <span>获取此<code>QName</code>的前缀。</span> </p>
|
||
<p> <span>分配给一个前缀<code>QName</code>可能<strong><em>无法</em></strong>在不同的上下文中有效。</span> <span>例如， <code>QName</code>可以在解析文档的上下文中被分配前缀，但该前缀在不同文档的上下文中可能是无效的。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
这个
|
||
<code>QName</code>前缀
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="equals-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>equals</h4> <pre>public final boolean equals(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> objectToTest)</pre>
|
||
<div class="block">
|
||
<p> <span>测试这个<code>QName</code>与另一个<code>Object</code>的平等。</span> </p>
|
||
<p> <span>如果<code>Object</code>待测试不是<code>QName</code>或为<code>null</code> ，则此方法返回<code>false</code> 。</span> </p>
|
||
<p> <span>当且仅当命名空间URI和本地部分都相等时，两个<code>QName</code>被认为是相等的。</span> <span>此方法使用<code>String.equals()</code>来检查命名空间URI和本地部分的相等性。</span> <span>前缀<strong><em>不</em></strong>用于确定相等。</span> </p>
|
||
<p> <span>此方法满足的总承包<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(Object)</code></a></span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>objectToTest</code> -
|
||
<code>Object</code>以测试与此
|
||
<code>QName</code>的平等
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>true</code>如果给定的
|
||
<code>Object</code>等于这个
|
||
<code>QName</code>其他
|
||
<code>false</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> ， <a href="../../../java/util/HashMap.html" title="java.util中的类"><code>HashMap</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="hashCode--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>hashCode</h4> <pre>public final int hashCode()</pre>
|
||
<div class="block">
|
||
<p> <span>生成这个<code>QName</code>的哈希码。</span> </p>
|
||
<p> <span>哈希码同时使用命名空间URI和本地部分计算<code>QName</code> 。</span> <span>前缀<strong><em>不</em></strong>用于计算哈希码。</span> </p>
|
||
<p> <span>此方法满足的总承包<a href="../../../java/lang/Object.html#hashCode--"><code>Object.hashCode()</code></a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#hashCode--">hashCode</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
这个哈希码为
|
||
<code>QName</code>
|
||
<code>Object</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(java.lang.Object)</code></a> ，
|
||
<a href="../../../java/lang/System.html#identityHashCode-java.lang.Object-"><code>System.identityHashCode(java.lang.Object)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="toString--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
|
||
<div class="block">
|
||
<p> <span><code>String</code>表示此<code>QName</code> 。</span> </p>
|
||
<p> <span>代表<code>QName</code>作为<code>String</code>的普遍接受的方式是James Clark的<a href="http://jclark.com/xml/xmlns.htm">defined</a> 。</span> <span>虽然这不是<em>标准</em>规范，但它是常用的，例如<a href="../../../javax/xml/transform/Transformer.html#setParameter-java.lang.String-java.lang.Object-"><code>Transformer.setParameter(String name, Object value)</code></a> 。</span> <span>这个实现表示一个<code>QName</code>为：“{”+ Namespace URI +“}”+本地部分。</span> <span>如果命名空间URI为<code>.equals(XMLConstants.NULL_NS_URI)</code> ，则只返回本地部分。</span> <span>这种方法的适当使用是用于人类消费的调试或记录。</span> </p>
|
||
<p> <span>注意前缀值<strong><em>不</em></strong>作为<code>String</code>表示的一部分返回。</span> </p>
|
||
<p> <span>此方法满足的总承包<a href="../../../java/lang/Object.html#toString--"><code>Object.toString()</code></a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#toString--">toString</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>String</code>表示此
|
||
<code>QName</code>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="valueOf-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>valueOf</h4> <pre>public static <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> valueOf(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> qNameAsString)</pre>
|
||
<div class="block">
|
||
<p> <span><code>QName</code>衍生自解析格式化的<code>String</code> 。</span> </p>
|
||
<p> <span>如果<code>String</code>是<code>null</code>或不符合<a href="../../../javax/xml/namespace/QName.html#toString--"><code>QName.toString()</code></a>格式，则会抛出一个<code>IllegalArgumentException</code> 。</span> </p>
|
||
<p> <span><em><code>String</code> <strong>必须</strong>以<a href="../../../javax/xml/namespace/QName.html#toString--"><code>QName.toString()</code></a>返回的<a href="../../../javax/xml/namespace/QName.html#toString--">形式</a> 。</em></span> </p>
|
||
<p> <span>代表<code>QName</code>作为<code>String</code>的普遍接受的方式是James Clark的<a href="http://jclark.com/xml/xmlns.htm">defined</a> 。</span> <span>虽然这不是一个<em>标准的</em>规范，但它是常用的，例如<a href="../../../javax/xml/transform/Transformer.html#setParameter-java.lang.String-java.lang.Object-"><code>Transformer.setParameter(String name, Object value)</code></a> 。</span> <span>此实现解析为<code>String</code>格式为：“{”+ Namespace URI +“}”+本地部分。</span> <span>如果命名空间URI为<code>.equals(XMLConstants.NULL_NS_URI)</code> ，则只应提供本地部分。</span> </p>
|
||
<p> <span>前缀值<strong><em>不能</em></strong>在String中<code>String</code> ，并将设置为<a href="../../../javax/xml/XMLConstants.html#DEFAULT_NS_PREFIX"><code>XMLConstants.DEFAULT_NS_PREFIX</code></a> 。</span> </p>
|
||
<p> <span>该方法不会对所得的<code>QName</code>进行全面<code>QName</code> 。</span> </p>
|
||
<p> <span>命名空间URI未验证为<a href="http://www.ietf.org/rfc/rfc2396.txt">URI reference</a> 。</span> <span>本地部分不会验证为<a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a>在指定的<a href="http://www.w3.org/TR/REC-xml-names/">Namespaces in XML</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>qNameAsString</code> -
|
||
<code>String</code>表示
|
||
<code>QName</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>QName</code>对应给定的
|
||
<code>String</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 当
|
||
<code>qNameAsString</code>为
|
||
<code>null</code>或格式错误
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/xml/namespace/QName.html#toString--"><code>QName.toString()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |