uTools-Manuals/docs/java/javax/xml/soap/SOAPEnvelope.html

<div class="header">
<div class="subTitle">
     javax.xml.soap 
   </div>
<h2 class="title" title="Interface SOAPEnvelope">Interface SOAPEnvelope</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
         All Superinterfaces: 
       </dt>
<dd>
<span><a href="../../../org/w3c/dom/Element.html" title="界面在org.w3c.dom">Element</a> ， <a href="../../../org/w3c/dom/Node.html" title="界面在org.w3c.dom">Node</a> ， <a href="../../../javax/xml/soap/SOAPElement.html" title="javax.xml.soap中的接口">SOAPElement</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">SOAPEnvelope</span>
extends <a href="../../../javax/xml/soap/SOAPElement.html" title="interface in javax.xml.soap">SOAPElement</a></pre>
<div class="block">
<span>用于SOAPHeader和SOAPBody的容器为<code>SOAPPart</code>对象。</span>
<span>默认情况下，将使用具有<code>SOAPPart</code>对象的<code>SOAPMessage</code>对象创建一个<code>SOAPEnvelope</code>对象。</span>
<span>默认情况下， <code>SOAPEnvelope</code>对象有一个空的<code>SOAPBody</code>对象和一个空的<code>SOAPHeader</code>对象。</span>
<span><code>SOAPBody</code>对象是必需的，而在大多数情况下， <code>SOAPHeader</code>对象虽然是可选的。</span>
<span>如果<code>SOAPHeader</code>对象，则可以将其删除，稍后再示出。</span>
<p> <span>客户端可以通过调用方法<code>SOAPEnvelope.getHeader</code>和<code>SOAPEnvelope.getBody</code>访问<code>SOAPHeader</code>和<code>SOAPBody</code>对象。</span> <span>下面的代码行使用这两种方法与起始后<code>SOAPMessage</code>对象<i>消息</i> ，以获得<code>SOAPPart</code>对象<i>SP，</i>然后将其用于获取<code>SOAPEnvelope</code>对象<i>本身</i> 。</span> </p>
<pre>  <span>SOAPPart sp = message.getSOAPPart();
     SOAPEnvelope se = sp.getEnvelope();
     SOAPHeader sh = se.getHeader();
     SOAPBody sb = se.getBody();</span> </pre>
<p> <span>可以通过检索当前的对象，删除它，然后添加一个新的主体或头来更改一个<code>SOAPEnvelope</code>对象的正文或标题。</span> <span><code>javax.xml.soap.Node</code>方法<code>deleteNode</code>删除<code>javax.xml.soap.Node</code>调用的XML元素（节点）。</span> <span>例如，以下代码<code>SOAPBody</code>删除由方法<code>getBody</code>的<code>SOAPBody</code>对象。</span> </p>
<pre>  <span>se.getBody().detachNode();</span> </pre>
<span>要创建一个<code>SOAPHeader</code>对象来替换被删除的对象，客户端使用方法<code>SOAPEnvelope.addHeader</code> ，该方法创建一个新的头并将其添加到<code>SOAPEnvelope</code>对象。</span>
<span>类似地，方法<code>addBody</code>创建一个新的<code>SOAPBody</code>对象，并将其添加到<code>SOAPEnvelope</code>对象。</span>
<span>以下代码片段检索当前头文件，将其删除，并添加一个新的标题。</span>
<span>然后它检索当前正文，删除它，并添加一个新的正文。</span>
<pre>  <span>SOAPPart sp = message.getSOAPPart();
     SOAPEnvelope se = sp.getEnvelope();
     se.getHeader().detachNode();
     SOAPHeader sh = se.addHeader();
     se.getBody().detachNode();
     SOAPBody sb = se.addBody();</span> </pre>
<span>如果一个已经存在，添加一个<code>SOAPBody</code>或<code>SOAPHeader</code>对象是一个错误。</span>
<p> <span><code>SOAPEnvelope</code>界面提供了创建<code>Name</code>对象的三种方法。</span> <span>一种方法创建具有本地名称，命名空间前缀和名称映射URI的<code>Name</code>对象。</span> <span>第二种方法创建<code>Name</code>对象与本地名称和命名空间的前缀，而第三创建<code>Name</code>个使用本地名称的对象。</span> <span>以下代码行，其中<i>se</i>是一个<code>SOAPEnvelope</code>对象，创建一个全新的<code>Name</code>对象。</span> </p>
<pre>  <span>Name name = se.createName("GetLastTradePrice", "WOMBAT",
                                "http://www.wombat.org/trader");</span> </pre>
</div> </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>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Fields inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#ATTRIBUTE_NODE">ATTRIBUTE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#CDATA_SECTION_NODE">CDATA_SECTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#COMMENT_NODE">COMMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_FRAGMENT_NODE">DOCUMENT_FRAGMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_NODE">DOCUMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINED_BY">DOCUMENT_POSITION_CONTAINED_BY</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_CONTAINS">DOCUMENT_POSITION_CONTAINS</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_DISCONNECTED">DOCUMENT_POSITION_DISCONNECTED</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_FOLLOWING">DOCUMENT_POSITION_FOLLOWING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC">DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_POSITION_PRECEDING">DOCUMENT_POSITION_PRECEDING</a>, <a href="../../../org/w3c/dom/Node.html#DOCUMENT_TYPE_NODE">DOCUMENT_TYPE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ELEMENT_NODE">ELEMENT_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_NODE">ENTITY_NODE</a>, <a href="../../../org/w3c/dom/Node.html#ENTITY_REFERENCE_NODE">ENTITY_REFERENCE_NODE</a>, <a href="../../../org/w3c/dom/Node.html#NOTATION_NODE">NOTATION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#PROCESSING_INSTRUCTION_NODE">PROCESSING_INSTRUCTION_NODE</a>, <a href="../../../org/w3c/dom/Node.html#TEXT_NODE">TEXT_NODE</a></code></li>
</ul> </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="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="../../../javax/xml/soap/SOAPBody.html" title="interface in javax.xml.soap">SOAPBody</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#addBody--">addBody</a></span>()</code>
<div class="block">
              创建一个 
             <code>SOAPBody</code>对象，并将其设置为 
             <code>SOAPBody</code>对象的 
             <code>SOAPEnvelope</code>对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/xml/soap/SOAPHeader.html" title="interface in javax.xml.soap">SOAPHeader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#addHeader--">addHeader</a></span>()</code>
<div class="block">
              创建一个 
             <code>SOAPHeader</code>对象，并将其设置为 
             <code>SOAPHeader</code>对象为此 
             <code>SOAPEnvelope</code>对象。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/xml/soap/Name.html" title="interface in javax.xml.soap">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#createName-java.lang.String-">createName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
              创建一个新的 
             <code>Name</code>对象，使用给定的本地名称初始化。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/xml/soap/Name.html" title="interface in javax.xml.soap">Name</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#createName-java.lang.String-java.lang.String-java.lang.String-">createName</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName, <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">
              创建使用给定的本地名称，命名空间前缀和命名空间URI初始化的新的 
             <code>Name</code>对象。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/xml/soap/SOAPBody.html" title="interface in javax.xml.soap">SOAPBody</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#getBody--">getBody</a></span>()</code>
<div class="block">
              返回 
             <code>SOAPBody</code>与此相关联的对象 
             <code>SOAPEnvelope</code>对象。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code><a href="../../../javax/xml/soap/SOAPHeader.html" title="interface in javax.xml.soap">SOAPHeader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/soap/SOAPEnvelope.html#getHeader--">getHeader</a></span>()</code>
<div class="block">
              返回此 
             <code>SOAPHeader</code>对象的 
             <code>SOAPEnvelope</code>对象。 
            </div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.soap.SOAPElement">
<!-- --> </a> <h3>Methods inherited from interface javax.xml.soap.<a href="../../../javax/xml/soap/SOAPElement.html" title="interface in javax.xml.soap">SOAPElement</a></h3> <code><a href="../../../javax/xml/soap/SOAPElement.html#addAttribute-javax.xml.soap.Name-java.lang.String-">addAttribute</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addAttribute-javax.xml.namespace.QName-java.lang.String-">addAttribute</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-javax.xml.soap.Name-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-javax.xml.namespace.QName-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-javax.xml.soap.SOAPElement-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-java.lang.String-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-java.lang.String-java.lang.String-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addChildElement-java.lang.String-java.lang.String-java.lang.String-">addChildElement</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addNamespaceDeclaration-java.lang.String-java.lang.String-">addNamespaceDeclaration</a>, <a href="../../../javax/xml/soap/SOAPElement.html#addTextNode-java.lang.String-">addTextNode</a>, <a href="../../../javax/xml/soap/SOAPElement.html#createQName-java.lang.String-java.lang.String-">createQName</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getAllAttributes--">getAllAttributes</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getAllAttributesAsQNames--">getAllAttributesAsQNames</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getAttributeValue-javax.xml.soap.Name-">getAttributeValue</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getAttributeValue-javax.xml.namespace.QName-">getAttributeValue</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getChildElements--">getChildElements</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getChildElements-javax.xml.soap.Name-">getChildElements</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getChildElements-javax.xml.namespace.QName-">getChildElements</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getElementName--">getElementName</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getElementQName--">getElementQName</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getEncodingStyle--">getEncodingStyle</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getNamespacePrefixes--">getNamespacePrefixes</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getNamespaceURI-java.lang.String-">getNamespaceURI</a>, <a href="../../../javax/xml/soap/SOAPElement.html#getVisibleNamespacePrefixes--">getVisibleNamespacePrefixes</a>, <a href="../../../javax/xml/soap/SOAPElement.html#removeAttribute-javax.xml.soap.Name-">removeAttribute</a>, <a href="../../../javax/xml/soap/SOAPElement.html#removeAttribute-javax.xml.namespace.QName-">removeAttribute</a>, <a href="../../../javax/xml/soap/SOAPElement.html#removeContents--">removeContents</a>, <a href="../../../javax/xml/soap/SOAPElement.html#removeNamespaceDeclaration-java.lang.String-">removeNamespaceDeclaration</a>, <a href="../../../javax/xml/soap/SOAPElement.html#setElementQName-javax.xml.namespace.QName-">setElementQName</a>, <a href="../../../javax/xml/soap/SOAPElement.html#setEncodingStyle-java.lang.String-">setEncodingStyle</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.soap.Node">
<!-- --> </a> <h3>Methods inherited from interface javax.xml.soap.<a href="../../../javax/xml/soap/Node.html" title="interface in javax.xml.soap">Node</a></h3> <code><a href="../../../javax/xml/soap/Node.html#detachNode--">detachNode</a>, <a href="../../../javax/xml/soap/Node.html#getParentElement--">getParentElement</a>, <a href="../../../javax/xml/soap/Node.html#getValue--">getValue</a>, <a href="../../../javax/xml/soap/Node.html#recycleNode--">recycleNode</a>, <a href="../../../javax/xml/soap/Node.html#setParentElement-javax.xml.soap.SOAPElement-">setParentElement</a>, <a href="../../../javax/xml/soap/Node.html#setValue-java.lang.String-">setValue</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Element">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Element.html" title="interface in org.w3c.dom">Element</a></h3> <code><a href="../../../org/w3c/dom/Element.html#getAttribute-java.lang.String-">getAttribute</a>, <a href="../../../org/w3c/dom/Element.html#getAttributeNode-java.lang.String-">getAttributeNode</a>, <a href="../../../org/w3c/dom/Element.html#getAttributeNodeNS-java.lang.String-java.lang.String-">getAttributeNodeNS</a>, <a href="../../../org/w3c/dom/Element.html#getAttributeNS-java.lang.String-java.lang.String-">getAttributeNS</a>, <a href="../../../org/w3c/dom/Element.html#getElementsByTagName-java.lang.String-">getElementsByTagName</a>, <a href="../../../org/w3c/dom/Element.html#getElementsByTagNameNS-java.lang.String-java.lang.String-">getElementsByTagNameNS</a>, <a href="../../../org/w3c/dom/Element.html#getSchemaTypeInfo--">getSchemaTypeInfo</a>, <a href="../../../org/w3c/dom/Element.html#getTagName--">getTagName</a>, <a href="../../../org/w3c/dom/Element.html#hasAttribute-java.lang.String-">hasAttribute</a>, <a href="../../../org/w3c/dom/Element.html#hasAttributeNS-java.lang.String-java.lang.String-">hasAttributeNS</a>, <a href="../../../org/w3c/dom/Element.html#removeAttribute-java.lang.String-">removeAttribute</a>, <a href="../../../org/w3c/dom/Element.html#removeAttributeNode-org.w3c.dom.Attr-">removeAttributeNode</a>, <a href="../../../org/w3c/dom/Element.html#removeAttributeNS-java.lang.String-java.lang.String-">removeAttributeNS</a>, <a href="../../../org/w3c/dom/Element.html#setAttribute-java.lang.String-java.lang.String-">setAttribute</a>, <a href="../../../org/w3c/dom/Element.html#setAttributeNode-org.w3c.dom.Attr-">setAttributeNode</a>, <a href="../../../org/w3c/dom/Element.html#setAttributeNodeNS-org.w3c.dom.Attr-">setAttributeNodeNS</a>, <a href="../../../org/w3c/dom/Element.html#setAttributeNS-java.lang.String-java.lang.String-java.lang.String-">setAttributeNS</a>, <a href="../../../org/w3c/dom/Element.html#setIdAttribute-java.lang.String-boolean-">setIdAttribute</a>, <a href="../../../org/w3c/dom/Element.html#setIdAttributeNode-org.w3c.dom.Attr-boolean-">setIdAttributeNode</a>, <a href="../../../org/w3c/dom/Element.html#setIdAttributeNS-java.lang.String-java.lang.String-boolean-">setIdAttributeNS</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.org.w3c.dom.Node">
<!-- --> </a> <h3>Methods inherited from interface org.w3c.dom.<a href="../../../org/w3c/dom/Node.html" title="interface in org.w3c.dom">Node</a></h3> <code><a href="../../../org/w3c/dom/Node.html#appendChild-org.w3c.dom.Node-">appendChild</a>, <a href="../../../org/w3c/dom/Node.html#cloneNode-boolean-">cloneNode</a>, <a href="../../../org/w3c/dom/Node.html#compareDocumentPosition-org.w3c.dom.Node-">compareDocumentPosition</a>, <a href="../../../org/w3c/dom/Node.html#getAttributes--">getAttributes</a>, <a href="../../../org/w3c/dom/Node.html#getBaseURI--">getBaseURI</a>, <a href="../../../org/w3c/dom/Node.html#getChildNodes--">getChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#getFeature-java.lang.String-java.lang.String-">getFeature</a>, <a href="../../../org/w3c/dom/Node.html#getFirstChild--">getFirstChild</a>, <a href="../../../org/w3c/dom/Node.html#getLastChild--">getLastChild</a>, <a href="../../../org/w3c/dom/Node.html#getLocalName--">getLocalName</a>, <a href="../../../org/w3c/dom/Node.html#getNamespaceURI--">getNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#getNextSibling--">getNextSibling</a>, <a href="../../../org/w3c/dom/Node.html#getNodeName--">getNodeName</a>, <a href="../../../org/w3c/dom/Node.html#getNodeType--">getNodeType</a>, <a href="../../../org/w3c/dom/Node.html#getNodeValue--">getNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#getOwnerDocument--">getOwnerDocument</a>, <a href="../../../org/w3c/dom/Node.html#getParentNode--">getParentNode</a>, <a href="../../../org/w3c/dom/Node.html#getPrefix--">getPrefix</a>, <a href="../../../org/w3c/dom/Node.html#getPreviousSibling--">getPreviousSibling</a>, <a href="../../../org/w3c/dom/Node.html#getTextContent--">getTextContent</a>, <a href="../../../org/w3c/dom/Node.html#getUserData-java.lang.String-">getUserData</a>, <a href="../../../org/w3c/dom/Node.html#hasAttributes--">hasAttributes</a>, <a href="../../../org/w3c/dom/Node.html#hasChildNodes--">hasChildNodes</a>, <a href="../../../org/w3c/dom/Node.html#insertBefore-org.w3c.dom.Node-org.w3c.dom.Node-">insertBefore</a>, <a href="../../../org/w3c/dom/Node.html#isDefaultNamespace-java.lang.String-">isDefaultNamespace</a>, <a href="../../../org/w3c/dom/Node.html#isEqualNode-org.w3c.dom.Node-">isEqualNode</a>, <a href="../../../org/w3c/dom/Node.html#isSameNode-org.w3c.dom.Node-">isSameNode</a>, <a href="../../../org/w3c/dom/Node.html#isSupported-java.lang.String-java.lang.String-">isSupported</a>, <a href="../../../org/w3c/dom/Node.html#lookupNamespaceURI-java.lang.String-">lookupNamespaceURI</a>, <a href="../../../org/w3c/dom/Node.html#lookupPrefix-java.lang.String-">lookupPrefix</a>, <a href="../../../org/w3c/dom/Node.html#normalize--">normalize</a>, <a href="../../../org/w3c/dom/Node.html#removeChild-org.w3c.dom.Node-">removeChild</a>, <a href="../../../org/w3c/dom/Node.html#replaceChild-org.w3c.dom.Node-org.w3c.dom.Node-">replaceChild</a>, <a href="../../../org/w3c/dom/Node.html#setNodeValue-java.lang.String-">setNodeValue</a>, <a href="../../../org/w3c/dom/Node.html#setPrefix-java.lang.String-">setPrefix</a>, <a href="../../../org/w3c/dom/Node.html#setTextContent-java.lang.String-">setTextContent</a>, <a href="../../../org/w3c/dom/Node.html#setUserData-java.lang.String-java.lang.Object-org.w3c.dom.UserDataHandler-">setUserData</a></code></li>
</ul> </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="createName-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createName</h4> <pre><a href="../../../javax/xml/soap/Name.html" title="interface in javax.xml.soap">Name</a> createName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName,
                <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)
         throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>创建一个使用给定的本地名称，命名空间前缀和命名空间URI初始化的新的<code>Name</code>对象。</span>
<p> <span>此工厂方法创建<code>Name</code>对象以在SOAP / XML文档中使用。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>localName</code> - a 
            <code>String</code>给出本地名称 
           </dd>
<dd>
<code>prefix</code> - 一个 
            <code>String</code>给出 
            <code>String</code>的前缀 
           </dd>
<dd>
<code>uri</code> - 一个 
            <code>String</code>给出 
            <code>String</code>的URI 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             用给定的本地名称，命名空间前缀和命名空间URI 
            <code>Name</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果有一个SOAP错误 
           </dd>
</dl> </li>
</ul> <a name="createName-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createName</h4> <pre><a href="../../../javax/xml/soap/Name.html" title="interface in javax.xml.soap">Name</a> createName(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
         throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>创建使用给定的本地名称初始化的新的<code>Name</code>对象。</span>
<p> <span>此工厂方法创建<code>Name</code>对象以在SOAP / XML文档中使用。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>localName</code> - a 
            <code>String</code>给出本地名称 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Name</code>对象使用给定的本地名称初始化 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果存在SOAP错误 
           </dd>
</dl> </li>
</ul> <a name="getHeader--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getHeader</h4> <pre><a href="../../../javax/xml/soap/SOAPHeader.html" title="interface in javax.xml.soap">SOAPHeader</a> getHeader()
              throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>返回此<code>SOAPHeader</code>对象的<code>SOAPEnvelope</code>对象。</span>
<p> <span>新<code>SOAPMessage</code>目标是通过创建一个默认<code>SOAPEnvelope</code>包含空对象<code>SOAPHeader</code>对象。</span> <span>因此，方法<code>getHeader</code>将始终返回一个<code>SOAPHeader</code>对象，除非头已经被删除，并且没有添加新的对象。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>SOAPHeader</code>对象或 
            <code>null</code>如果没有 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果获取 
            <code>SOAPHeader</code>对象时出现问题 
           </dd>
</dl> </li>
</ul> <a name="getBody--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getBody</h4> <pre><a href="../../../javax/xml/soap/SOAPBody.html" title="interface in javax.xml.soap">SOAPBody</a> getBody()
          throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>返回<code>SOAPBody</code>与此相关联的对象<code>SOAPEnvelope</code>对象。</span>
<p> <span>新<code>SOAPMessage</code>目标是通过创建一个默认<code>SOAPEnvelope</code>包含空对象<code>SOAPBody</code>对象。</span> <span>因此，方法<code>getBody</code>将始终返回一个<code>SOAPBody</code>对象，除非正文已被删除并且尚未添加新对象。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>SOAPBody</code>对象为这 
            <code>SOAPEnvelope</code>对象或 
            <code>null</code>如果没有 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果获取 
            <code>SOAPBody</code>对象时出现问题 
           </dd>
</dl> </li>
</ul> <a name="addHeader--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addHeader</h4> <pre><a href="../../../javax/xml/soap/SOAPHeader.html" title="interface in javax.xml.soap">SOAPHeader</a> addHeader()
              throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>创建一个<code>SOAPHeader</code>对象，并将其设置为<code>SOAPHeader</code>对象的<code>SOAPEnvelope</code>对象。</span>
<p> <span>当信封已经包含标题时添加标题是非法的。</span> <span>因此，只有在删除现有标题之后，才应该调用此方法。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>SOAPHeader</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果此 
            <code>SOAPEnvelope</code>对象已经包含有效的 
            <code>SOAPHeader</code>对象 
           </dd>
</dl> </li>
</ul> <a name="addBody--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>addBody</h4> <pre><a href="../../../javax/xml/soap/SOAPBody.html" title="interface in javax.xml.soap">SOAPBody</a> addBody()
          throws <a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></pre>
<div class="block">
<span>创建一个<code>SOAPBody</code>对象，并将其设置为该<code>SOAPBody</code>对象的<code>SOAPEnvelope</code>对象。</span>
<p> <span>当信封已经包含身体时添加身体是非法的。</span> <span>因此，只有在删除现有的身体后才应该调用此方法。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             新的 
            <code>SOAPBody</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/soap/SOAPException.html" title="class in javax.xml.soap">SOAPException</a></code> - 如果这个 
            <code>SOAPEnvelope</code>对象已经包含一个有效的 
            <code>SOAPBody</code>对象 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>