javax.xml.namespace.QName 解释以及作用JDK

小灰灰 2022-07-14 10:56 278阅读 0赞

最近在搞webService调用，使用到了QName这个类，经过查找JDK以及一些资料，才明白这个类的作用。

QName  英文全名： qualified name

中文翻译：表示 XML 规范中定义的**限定名称**

`QName` 的值包含名称空间 URI、本地部分和前缀。

`QName` 中包括前缀，以保留词汇信息（当在  `XML 输入源`中*存在* 时）。前缀*不* 用于  `QName.equals(Object)` 或计算  `QName.hashCode()`。*仅* 使用名称空间 URI 和本地部分定义相等性和哈希码。

如果没有指定名称空间 URI，则将其设置为 `XMLConstants.NULL_NS_URI`。如果没有指定前缀，则将其设置为`XMLConstants.DEFAULT_NS_PREFIX`。

`QName` 是不可变的。

**从以下版本开始：**

1.5

**另请参见：**

[XML Schema 第二部分：Datatypes specification][XML Schema _Datatypes specification],  [Namespaces in XML][],  [Namespaces in XML 勘误表][Namespaces in XML 1],  [序列化表格][Link 1]

--------------------

<table style="color:rgb(0,0,0); font-family:Arial; font-size:14px; width:944px"> 
 <tbody> 
  <tr> 
   <th colspan="2" align="left"><span style="font-size:10px">构造方法摘要</span></th> 
  </tr> 
  <tr> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#QName%28java.lang.String%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">QName</a></strong>(<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;localPart)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;指定本地部分的&nbsp;<code>QName</code>&nbsp;构造方法。</td> 
  </tr> 
  <tr> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#QName%28java.lang.String,%20java.lang.String%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">QName</a></strong>(<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;namespaceURI,&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;localPart)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;指定名称空间 URI 和本地部分的&nbsp;<code>QName</code>&nbsp;构造方法。</td> 
  </tr> 
  <tr> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#QName%28java.lang.String,%20java.lang.String,%20java.lang.String%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">QName</a></strong>(<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;namespaceURI,&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;localPart,&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;prefix)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;指定名称空间 URI、本地部分和前缀的&nbsp;<code>QName</code>&nbsp;构造方法。</td> 
  </tr> 
 </tbody> 
</table>

<table style="color:rgb(0,0,0); font-family:Arial; font-size:14px; width:944px"> 
 <tbody> 
  <tr> 
   <th colspan="2" align="left"><span style="font-size:10px">方法摘要</span></th> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;boolean</code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#equals%28java.lang.Object%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">equals</a></strong>(<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/Object.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">Object</a>&nbsp;objectToTest)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;测试此&nbsp;<code>QName</code>&nbsp;与另一个&nbsp;<code>Object</code>&nbsp;的相等性。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a></code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#getLocalPart%28%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">getLocalPart</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获取此&nbsp;<code>QName</code>&nbsp;的本地部分。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a></code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#getNamespaceURI%28%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">getNamespaceURI</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获取此&nbsp;<code>QName</code>&nbsp;的名称空间 URI。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a></code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#getPrefix%28%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">getPrefix</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获取此&nbsp;<code>QName</code>&nbsp;的前缀。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;int</code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#hashCode%28%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">hashCode</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;生成此&nbsp;<code>QName</code>&nbsp;的哈希码。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>&nbsp;<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a></code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#toString%28%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">toString</a></strong>()</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;此&nbsp;<code>QName</code>&nbsp;的&nbsp;<code>String</code>&nbsp;表示形式。</td> 
  </tr> 
  <tr> 
   <td align="right"><code>static&nbsp;<a title="javax.xml.namespace 中的类" href="http://writeblog.csdn.net/javax/xml/namespace/QName.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">QName</a></code></td> 
   <td><code><strong><a href="http://writeblog.csdn.net/javax/xml/namespace/QName.html#valueOf%28java.lang.String%29" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">valueOf</a></strong>(<a title="java.lang 中的类" href="http://writeblog.csdn.net/java/lang/String.html" style="color:rgb(202,0,0); text-decoration:none" rel="nofollow">String</a>&nbsp;qNameAsString)</code>&nbsp;<br> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;从解析格式化&nbsp;<code>String</code>&nbsp;中派生的&nbsp;<code>QName</code>。</td> 
  </tr> 
 </tbody> 
</table>

## 例子：部分代码 ##

@WebService(targetNamespace = "http://webservice.mpi.rhin.landwind.net/", endpointInterface = "net.landwind.rhin.mpi.webservice.MPIWebService", portName = "MPIService", serviceName = "MPIWebService")

public class MPIWebServiceImpl implements MPIWebService \{

public String register(String reqXml)\{

system.out.println("实现代码块......");

//namespaceURI   method

new javax.xml.namespace.QName("http://webservice.mpi.rhin.landwind.net/", "register")

##     ##

[XML Schema _Datatypes specification]: http://www.w3.org/TR/xmlschema-2/#QName
[Namespaces in XML]: http://www.w3.org/TR/REC-xml-names/#ns-qualnames
[Namespaces in XML 1]: http://www.w3.org/XML/xml-names-19990114-errata
[Link 1]: http://writeblog.csdn.net/serialized-form.html#javax.xml.namespace.QName