study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-07 10:06:53 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/xml/ws/soap/AddressingFeature.html

405 lines
20 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.xml.ws.soap
</div>
<h2 class="title" title="Class AddressingFeature">Class AddressingFeature</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><a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">javax.xml.ws.WebServiceFeature</a></li>
<li>
<ul class="inheritance">
<li>javax.xml.ws.soap.AddressingFeature</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public final class <span class="typeNameLabel">AddressingFeature</span>
extends <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a></pre>
<div class="block">
<span>AddressingFeature表示使用SOAP 1.1 / HTTP或SOAP 1.2 / HTTP绑定的WS-Addressing。</span>
<span>使用此功能与任何其他绑定是未定义的。</span>
<p> <span>此功能可以在创建SEI代理的过程中使用，并<a href="../../../../javax/xml/ws/Dispatch.html" title="javax.xml.ws中的接口"><code>Dispatch</code>个</a>在客户端实例和<a href="../../../../javax/xml/ws/Endpoint.html" title="javax.xml.ws中的类"><code>Endpoint</code>个</a>在服务器端实例。</span> <span>此功能不能用于客户端上创建的<a href="../../../../javax/xml/ws/Service.html" title="javax.xml.ws中的类"><code>Service</code></a>实例。</span> </p>
<p> <span>以下描述了该功能对启用或禁用的影响：</span> </p>
<ul>
<li> <span>ENABLED：在此模式下，将启用WS-Addressing。</span> <span>这意味着端点支持WS寻址，但不需要使用它。</span> <span>发件人可以使用WS-Addressing标头或没有WS-Addressing标头发送消息。</span> <span>但接收者必须消耗这两种类型的消息。</span> </li>
<li> <span>DISABLED：在此模式下，WS-Addressing将被禁用。</span> <span>在运行时，WS-Addressing头不能被发送者或接收者使用。</span> </li>
</ul>
<p> <span>如果启用该功能，则<code>required</code>属性确定端点是否需要WS-Addressing。</span> <span>如果设置为真，WS-Addressing头必须在传入和传出的消息中存在。</span> <span>默认情况下， <code>required</code>属性为<code>false</code> 。</span> </p>
<p> <span>如果Web服务开发人员尚未明确启用此功能，则WSDL的wsam：寻址策略断言用于查找使用WS-Addressing。</span> <span>通过明确使用该功能，应用程序会覆盖WSDL使用WS-Addressing的指示。</span> <span>在某些情况下，这是真正需要的。</span> <span>例如，如果应用程序本身已经实现了WS-Addressing，它可以使用此功能来禁用寻址。</span> <span>这意味着JAX-WS实现不消耗或产生WS-Addressing头。</span> </p>
<p> <span>如果启用寻址，则必须根据3.1 WS-Policy Assertions在WSDL中生成相应的wsam：寻址策略<a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyassertions">断言</a></span> </p>
<p> <span><b>实施例1：</b>在用于产生WSDL可能的策略声明<code>@Addressing</code></span> </p>
<pre> <span>&lt;wsam:Addressing wsp:Optional="true"&gt;
&lt;wsp:Policy/&gt;
&lt;/wsam:Addressing&gt;</span> </pre>
<p> <span><b>实施例2：</b>在对生成的WSDL可能的策略声明<code>@Addressing(required=true)</code></span> </p>
<pre> <span>&lt;wsam:Addressing&gt;
&lt;wsp:Policy/&gt;
&lt;/wsam:Addressing&gt;</span> </pre>
<p> <span><b>实施例3：</b>在用于产生WSDL可能的策略声明<code>@Addressing(required=true, responses=Responses.ANONYMOUS)</code></span> </p>
<pre> <span>&lt;wsam:Addressing&gt;
&lt;wsp:Policy&gt;
&lt;wsam:AnonymousResponses/&gt;
&lt;/wsp:Policy&gt;
&lt;/wsam:Addressing&gt;</span> </pre>
<p> <span>见<a href="http://www.w3.org/TR/2006/REC-ws-addr-core-20060509/">Web Services Addressing - Core</a> ， <a href="http://www.w3.org/TR/2006/REC-ws-addr-soap-20060509/">Web Services Addressing 1.0 - SOAP Binding</a>和<a href="http://www.w3.org/TR/ws-addr-metadata/">Web Services Addressing 1.0 - Metadata</a>对WS寻址的更多信息。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.1
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/ws/soap/Addressing.html" title="javax.xml.ws.soap中的注释"><code>Addressing</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== NESTED CLASS SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="nested.class.summary">
<!-- --> </a> <h3>Nested Class Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Nested Class Summary table, listing nested classes, and an explanation">
<caption>
<span>Nested Classes</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Class and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static class </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html" title="enum in javax.xml.ws.soap">AddressingFeature.Responses</a></span></code>
<div class="block">
如果启用寻址，则此属性确定端点是否仅需要使用匿名响应，或仅使用非匿名响应或全部。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- =========== 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="../../../../javax/xml/ws/soap/AddressingFeature.html#ID">ID</a></span></code>
<div class="block">
识别寻址功能的常数值
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#required">required</a></span></code>
<div class="block">
如果启用寻址，则此属性确定端点是否需要WS-Addressing。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.xml.ws.WebServiceFeature">
<!-- --> </a> <h3>Fields inherited from class javax.xml.ws.<a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a></h3> <code><a href="../../../../javax/xml/ws/WebServiceFeature.html#enabled">enabled</a></code></li>
</ul> </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="../../../../javax/xml/ws/soap/AddressingFeature.html#AddressingFeature--">AddressingFeature</a></span>()</code>
<div class="block">
创建和配置
<code>AddressingFeature</code>配合使用的寻址要求。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#AddressingFeature-boolean-">AddressingFeature</a></span>(boolean enabled)</code>
<div class="block">
创建和配置
<code>AddressingFeature</code>配合使用的寻址要求。
</div> </td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#AddressingFeature-boolean-boolean-">AddressingFeature</a></span>(boolean enabled, boolean required)</code>
<div class="block">
创建和配置
<code>AddressingFeature</code>配合使用的寻址要求。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#AddressingFeature-boolean-boolean-javax.xml.ws.soap.AddressingFeature.Responses-">AddressingFeature</a></span>(boolean enabled, boolean required, <a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html" title="enum in javax.xml.ws.soap">AddressingFeature.Responses</a> responses)</code>
<div class="block">
创建和配置
<code>AddressingFeature</code>配合使用的寻址要求。
</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><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/ws/soap/AddressingFeature.html#getID--">getID</a></span>()</code>
<div class="block">
获取此WebServiceFeature的唯一标识符。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html" title="enum in javax.xml.ws.soap">AddressingFeature.Responses</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#getResponses--">getResponses</a></span>()</code>
<div class="block">
如果启用寻址，则此属性确定端点是否需要使用匿名响应，或非匿名响应或所有响应。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/AddressingFeature.html#isRequired--">isRequired</a></span>()</code>
<div class="block">
如果启用寻址，则此属性确定端点是否需要WS-Addressing。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.ws.WebServiceFeature">
<!-- --> </a> <h3>Methods inherited from class javax.xml.ws.<a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a></h3> <code><a href="../../../../javax/xml/ws/WebServiceFeature.html#isEnabled--">isEnabled</a></code></li>
</ul>
<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="ID">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ID</h4> <pre>public static final <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> ID</pre>
<div class="block">
识别寻址功能的常数值
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../constant-values.html#javax.xml.ws.soap.AddressingFeature.ID">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="required">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>required</h4> <pre>protected boolean required</pre>
<div class="block">
<span>如果启用寻址，则此属性确定端点是否需要WS-Addressing。</span>
<span>如果需要，则WS-Addressing头必须存在于传入和传出的消息中。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="AddressingFeature--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>AddressingFeature</h4> <pre>public AddressingFeature()</pre>
<div class="block">
<span>创建和配置<code>AddressingFeature</code>配合使用的寻址要求。</span>
<span>创建的功能使ws寻址即支持ws寻址，但不需要使用。</span>
<span>它也被配置为接受所有的响应类型。</span>
</div> </li>
</ul> <a name="AddressingFeature-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>AddressingFeature</h4> <pre>public AddressingFeature(boolean enabled)</pre>
<div class="block">
<span>创建和配置<code>AddressingFeature</code>配合使用的寻址要求。</span>
<span>如果<code>enabled</code>是真的，它可以实现ws寻址，即支持ws寻址，但不需要它的使用。</span>
<span>它还配置为接受所有响应类型。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>enabled</code> - true启用ws寻址iews寻址，但不需要使用它
</dd>
</dl> </li>
</ul> <a name="AddressingFeature-boolean-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>AddressingFeature</h4> <pre>public AddressingFeature(boolean enabled,
boolean required)</pre>
<div class="block">
<span>创建和配置<code>AddressingFeature</code>配合使用的寻址要求。</span>
<span>如果<code>enabled</code>和<code>required</code>是真的，它可以实现ws寻址并且需要它的使用。</span>
<span>它还配置为接受所有响应类型。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>enabled</code> - true启用ws寻址iews寻址，但不需要使用
</dd>
<dd>
<code>required</code> - 真正的手段需要使用ws寻址。
</dd>
</dl> </li>
</ul> <a name="AddressingFeature-boolean-boolean-javax.xml.ws.soap.AddressingFeature.Responses-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>AddressingFeature</h4> <pre>public AddressingFeature(boolean enabled,
boolean required,
<a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html" title="enum in javax.xml.ws.soap">AddressingFeature.Responses</a> responses)</pre>
<div class="block">
<span>创建和配置<code>AddressingFeature</code>配合使用的寻址要求。</span>
<span>如果<code>enabled</code>和<code>required</code>是真的，它可以实现ws寻址并且需要使用它。</span>
<span>此外，响应类型可以使用<code>responses</code>参数进行配置。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>enabled</code> - true启用ws寻址iews寻址，但不需要使用
</dd>
<dd>
<code>required</code> - 真正的手段需要使用ws寻址。
</dd>
<dd>
<code>responses</code> - 指定需要什么类型的响应
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.2
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getID--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getID</h4> <pre>public <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> getID()</pre>
<div class="block">
获取此WebServiceFeature的唯一标识符。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../../javax/xml/ws/WebServiceFeature.html#getID--">getID</a></code>在
<code><a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该功能的唯一标识符。
</dd>
</dl> </li>
</ul> <a name="isRequired--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isRequired</h4> <pre>public boolean isRequired()</pre>
<div class="block">
<span>如果启用寻址，则此属性确定端点是否需要WS-Addressing。</span>
<span>如果需要，则WS-Addressing头必须存在于传入和传出的消息中。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前所需的值
</dd>
</dl> </li>
</ul> <a name="getResponses--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getResponses</h4> <pre>public <a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html" title="enum in javax.xml.ws.soap">AddressingFeature.Responses</a> getResponses()</pre>
<div class="block">
如果启用寻址，则此属性确定端点是否需要使用匿名响应，或非匿名响应或所有响应。
<p></p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#ALL"><code>AddressingFeature.Responses.ALL</code></a>当端点支持所有类型的响应时，
<a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#ANONYMOUS"><code>AddressingFeature.Responses.ANONYMOUS</code></a>当端点只需使用匿名响应时，
<a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#NON_ANONYMOUS"><code>AddressingFeature.Responses.NON_ANONYMOUS</code></a>当端点需要使用只有非匿名响应时
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
JAX-WS 2.2
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink