mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-05 00:04:33 +08:00
305 lines
13 KiB
HTML
305 lines
13 KiB
HTML
<div class="header">
|
||
<h1 class="title" title="Package">Package javax.xml.soap</h1>
|
||
<div class="docSummary">
|
||
<div class="block">
|
||
提供用于创建和构建SOAP消息的API。
|
||
</div>
|
||
</div>
|
||
<p>See: <a href="#package.description">描述</a></p>
|
||
</div><div class="contentContainer">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<table border="0" cellpadding="3" cellspacing="0" class="typeSummary" summary="Interface Summary table, listing interfaces, and an explanation">
|
||
<caption>
|
||
<span>接口摘要</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">接口</th>
|
||
<th class="colLast" scope="col">描述</th>
|
||
</tr>
|
||
</tbody>
|
||
<tbody>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/Detail.html" title="interface in javax.xml.soap">Detail</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
<code>DetailEntry</code>对象的
|
||
<code>DetailEntry</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/DetailEntry.html" title="interface in javax.xml.soap">DetailEntry</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
一个
|
||
<code>Detail</code>对象的内容，给出一个
|
||
<code>SOAPFault</code>对象的详细信息。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/Name.html" title="interface in javax.xml.soap">Name</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
XML名称的表示形式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/Node.html" title="interface in javax.xml.soap">Node</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
XML文档中节点（元素）的表示。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPBody.html" title="interface in javax.xml.soap">SOAPBody</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
表示SOAP消息中SOAP主体元素内容的对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPBodyElement.html" title="interface in javax.xml.soap">SOAPBodyElement</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
甲
|
||
<code>SOAPBodyElement</code>对象表示内容
|
||
<code>SOAPBody</code>对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPConstants.html" title="interface in javax.xml.soap">SOAPConstants</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
关于SOAP协议的常量定义。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPElement.html" title="interface in javax.xml.soap">SOAPElement</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
表示SOAP消息的元素的对象，SOAP消息被允许但不是由SOAP规范特别规定。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPEnvelope.html" title="interface in javax.xml.soap">SOAPEnvelope</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
用于SOAPHeader的容器和SOAPBody部分的一个
|
||
<code>SOAPPart</code>对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPFault.html" title="interface in javax.xml.soap">SOAPFault</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
<code>SOAPBody</code>对象中包含错误和/或状态信息的元素。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPFaultElement.html" title="interface in javax.xml.soap">SOAPFaultElement</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
内容在
|
||
<code>SOAPFault</code>对象中的
|
||
<code>SOAPFault</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPHeader.html" title="interface in javax.xml.soap">SOAPHeader</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
SOAP头元素的表示。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPHeaderElement.html" title="interface in javax.xml.soap">SOAPHeaderElement</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
表示SOAP信封SOAP头部分内容的对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/Text.html" title="interface in javax.xml.soap">Text</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
值为文本的节点的表示。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
<li class="blockList">
|
||
<table border="0" cellpadding="3" cellspacing="0" class="typeSummary" summary="Class Summary table, listing classes, and an explanation">
|
||
<caption>
|
||
<span>类摘要</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">类</th>
|
||
<th class="colLast" scope="col">描述</th>
|
||
</tr>
|
||
</tbody>
|
||
<tbody>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/AttachmentPart.html" title="class in javax.xml.soap">AttachmentPart</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
一个附件到一个
|
||
<code>SOAPMessage</code>对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/MessageFactory.html" title="class in javax.xml.soap">MessageFactory</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
创建
|
||
<code>SOAPMessage</code>对象的工厂。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/MimeHeader.html" title="class in javax.xml.soap">MimeHeader</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
一个存储MIME头名称及其值的对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/MimeHeaders.html" title="class in javax.xml.soap">MimeHeaders</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
一个用于
|
||
<code>MimeHeader</code>对象的
|
||
<code>MimeHeader</code> ，它们表示消息的MIME部分中出现的MIME头。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SAAJMetaFactory.html" title="class in javax.xml.soap">SAAJMetaFactory</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
在SAAJ API中定义的工厂的实现类的接入点。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SAAJResult.html" title="class in javax.xml.soap">SAAJResult</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
作为SAAJ树形式的JAXP转换或JAXB编组的结果的持有者。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPConnection.html" title="class in javax.xml.soap">SOAPConnection</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
客户端可以将消息直接发送到远程方（例如由URL表示）的点对点连接。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPConnectionFactory.html" title="class in javax.xml.soap">SOAPConnectionFactory</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
创建
|
||
<code>SOAPConnection</code>对象的工厂。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPElementFactory.html" title="class in javax.xml.soap">SOAPElementFactory</a></td>
|
||
<td class="colLast">Deprecated
|
||
<div class="block">
|
||
<span class="deprecationComment">- 使用<code>javax.xml.soap.SOAPFactory</code>创建SOAPElements。</span>
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPFactory.html" title="class in javax.xml.soap">SOAPFactory</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
<code>SOAPFactory</code>是用于创建SOAP XML树中存在的各种对象的工厂。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPMessage.html" title="class in javax.xml.soap">SOAPMessage</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
所有SOAP消息的根类。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPPart.html" title="class in javax.xml.soap">SOAPPart</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
用于
|
||
<code>SOAPMessage</code>对象的SOAP特定部分的
|
||
<code>SOAPMessage</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
<li class="blockList">
|
||
<table border="0" cellpadding="3" cellspacing="0" class="typeSummary" summary="Exception Summary table, listing exceptions, and an explanation">
|
||
<caption>
|
||
<span>异常摘要</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">异常</th>
|
||
<th class="colLast" scope="col">描述</th>
|
||
</tr>
|
||
</tbody>
|
||
<tbody>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></td>
|
||
<td class="colLast">
|
||
<div class="block">
|
||
发生SOAP异常发生的异常。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<a name="package.description">
|
||
<!-- --> </a>
|
||
<h2 title="Package javax.xml.soap Description">Package javax.xml.soap Description</h2>
|
||
<div class="block">
|
||
<span>提供用于创建和构建SOAP消息的API。</span>
|
||
<span>此包在<i>SOAP with Java <sup><font size="-2">TM</font></sup> （SAAJ）1.3</i>规范的<i>附件API</i>中定义。</span>
|
||
<p> <span><code>javax.xml.soap</code>程序包中的API允许您执行以下操作：</span> </p>
|
||
<ul>
|
||
<li> <span>创建到指定端点的点对点连接</span> </li>
|
||
<li> <span>创建SOAP消息</span> </li>
|
||
<li> <span>创建一个XML片段</span> </li>
|
||
<li> <span>将内容添加到SOAP消息的头部</span> </li>
|
||
<li> <span>将内容添加到SOAP消息的正文中</span> </li>
|
||
<li> <span>创建附件，并向其添加内容</span> </li>
|
||
<li> <span>访问/添加/修改SOAP消息的部分</span> </li>
|
||
<li> <span>创建/添加/修改SOAP故障信息</span> </li>
|
||
<li> <span>从SOAP消息中提取内容</span> </li>
|
||
<li> <span>发送SOAP请求响应消息</span> </li>
|
||
</ul>
|
||
<p>
|
||
<!-- <h2>Package Specification</h2> -->
|
||
<!-- The SAAJ 1.1 specification gives an overview of the -->
|
||
<!-- <code>javax.xml.soap</code> package and -->
|
||
<!-- explains how its classes and interfaces work. -->
|
||
<!-- <ul> -->
|
||
<!-- <li><a href="http://java.sun.com/xml/downloads/jaxm.html"> -->
|
||
<!-- SAAJ 1.1 Specification</a> -->
|
||
<!-- </ul> -->
|
||
<!-- <h2>Related Documentation</h2> -->
|
||
<!-- For overviews, tutorials, examples, guides, and tool documentation, please see: -->
|
||
<!-- <ul> -->
|
||
<!-- <li><a href="../../../../tutorial/doc/JAXM.html">JAXM Tutorial</a> -->
|
||
<!-- <li><a href="../../../../jaxm/index.html">JAXM Reference Implementation (RI) -->
|
||
<!-- Documentation</a> -->
|
||
<!-- </ul> --></p>
|
||
<span>另外， <code>javax.xml.soap</code>包中的API扩展了其对应的<code>org.w3c.dom</code>包。</span>
|
||
<span>这意味着<code>SOAPPart</code>的<code>SOAPMessage</code>也是DOM Level 2 <code>Document</code> ，并且可以通过使用DOM的应用程序，工具和库进行操作（有关更多信息，请参见http://www.w3.org/DOM/）。</span>
|
||
<span>重要的是要注意，虽然可以使用DOM API将普通的DOM节点添加到SAAJ树中，但SAAJ API在检查或操作树时仍然需要返回SAAJ类型。</span>
|
||
<span>为了实现这一点，允许SAAJ API（特别是<a href="../../../javax/xml/soap/SOAPElement.html#getChildElements--"><code>SOAPElement.getChildElements()</code></a> ）默认地替换相对于SAAJ要求错误类型的对象，并且具有所需类型的等效对象。</span>
|
||
<span>这些替换不能导致树的逻辑结构发生变化，所以从DOM API的角度来看，树将保持不变。</span>
|
||
<span>然而，树的物理组成将会发生变化，因此对被替换的节点的引用将引用不再是树的一部分的节点。</span>
|
||
<span>如果SAAJ API不需要，那么SAAJ API不允许进行这些替换，因此替换对象永远不会被以后的SAAJ API调用替代。</span>
|
||
<p> <span>实际上这意味着在使用DOM API处理树之后，开始使用SAAJ API的应用程序必须假定该树已被转换为所有SAAJ树，并且对已获得的树中的对象的任何引用使用DOM API不再有效。</span> <span>从SAAJ API切换到DOM API不允许导致无效引用，也不会专门使用SAAJ API。</span> <span>它只是在特定的SAAJ树上使用DOM API切换到使用导致无效引用风险的SAAJ API。</span> <br/></p>
|
||
</div>
|
||
</div> |