uTools-Manuals/docs/java/javax/xml/ws/soap/Addressing.html

<div class="header">
<div class="subTitle">
     javax.xml.ws.soap 
   </div>
<h2 class="title" title="Annotation Type Addressing">Annotation Type Addressing</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre><a href="../../../../java/lang/annotation/Target.html" title="annotation in java.lang.annotation">@Target</a>(<a href="../../../../java/lang/annotation/Target.html#value--">value</a>={<a href="../../../../java/lang/annotation/ElementType.html#TYPE">TYPE</a>,<a href="../../../../java/lang/annotation/ElementType.html#METHOD">METHOD</a>,<a href="../../../../java/lang/annotation/ElementType.html#FIELD">字段</a>})
 <a href="../../../../java/lang/annotation/Retention.html" title="annotation in java.lang.annotation">@Retention</a>(<a href="../../../../java/lang/annotation/Retention.html#value--">value</a>=<a href="../../../../java/lang/annotation/RetentionPolicy.html#RUNTIME">RUNTIME</a>)
 <a href="../../../../java/lang/annotation/Documented.html" title="annotation in java.lang.annotation">@Documented</a>
 <a href="../../../../javax/xml/ws/spi/WebServiceFeatureAnnotation.html" title="annotation in javax.xml.ws.spi">@WebServiceFeatureAnnotation</a>(<a href="../../../../javax/xml/ws/spi/WebServiceFeatureAnnotation.html#id--">id</a>="http://www.w3.org/2005/08/addressing/module",
                             <a href="../../../../javax/xml/ws/spi/WebServiceFeatureAnnotation.html#bean--">bean</a>=<a href="../../../../javax/xml/ws/soap/AddressingFeature.html" title="class in javax.xml.ws.soap">AddressingFeature.class</a>)
public @interface <span class="memberNameLabel">Addressing</span></pre>
<div class="block">
<span>此注释表示使用SOAP 1.1 / HTTP或SOAP 1.2 / HTTP绑定的WS-Addressing。</span>
<span>将此注释与任何其他绑定一起使用是未定义的。</span>
<p> <span>该注释必须仅在结合使用与<a href="../../../../javax/jws/WebService.html" title="javax.jws中的注释"><code>WebService</code></a> ， <a href="../../../../javax/xml/ws/WebServiceProvider.html" title="javax.xml.ws中的注释"><code>WebServiceProvider</code></a>和<a href="../../../../javax/xml/ws/WebServiceRef.html" title="javax.xml.ws中的注释"><code>WebServiceRef</code></a>注释。</span> <span>当与<code>javax.jws.WebService</code>注释一起使用时，此注释必须仅在服务端点实现类上使用。</span> <span>当与<code>WebServiceRef</code>注释一起使用时，此注释必须仅在创建代理实例时使用。</span> <span>注入的SEI代理和端点必须符合<code>Addressing</code>注释的值。</span> </p>
<p> <span>此注释的行为由相应的功能<a href="../../../../javax/xml/ws/soap/AddressingFeature.html" title="javax.xml.ws.soap中的类"><code>AddressingFeature</code></a>定义。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         JAX-WS 2.1 
       </dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== ANNOTATION TYPE OPTIONAL MEMBER SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.optional.element.summary">
<!-- --> </a> <h3>Optional Element Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Optional Element Summary table, listing optional elements, and an explanation">
<caption>
<span>Optional Elements</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Optional Element and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/Addressing.html#enabled--">enabled</a></span></code>
<div class="block">
              指定是否启用或禁用此功能。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/soap/Addressing.html#required--">required</a></span></code>
<div class="block">
              如果启用寻址，则此属性确定端点是否需要WS-Addressing。 
            </div> </td>
</tr>
<tr class="altColor">
<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/Addressing.html#responses--">responses</a></span></code>
<div class="block">
              如果启用寻址，则此属性确定端点是否需要使用匿名响应或非匿名响应或全部。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ ANNOTATION TYPE MEMBER DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.element.detail">
<!-- --> </a> <h3>Element Detail</h3> <a name="enabled--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>enabled</h4> <pre>public abstract boolean enabled</pre>
<div class="block">
<span>指定是否启用或禁用此功能。</span>
<span>如果启用，则表示端点支持WS-Addressing，但不需要使用WS-Addressing。</span>
<span>相应<a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyaddressing">3.1.1 Addressing Assertion</a>必须在生成WSDL生成。</span>
</div>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             真正 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="required--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>required</h4> <pre>public abstract boolean required</pre>
<div class="block">
<span>如果启用寻址，则此属性确定端点是否需要WS-Addressing。</span>
<span>如果需要，则端点需要WS-Addressing，WS-Addressing头必须在传入的消息中存在。</span>
<span>相应<a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyaddressing">3.1.1 Addressing Assertion</a>必须在WSDL产生。</span>
</div>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             假 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="responses--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>responses</h4> <pre>public abstract <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>如果启用寻址，则此属性确定端点是否需要使用匿名响应或非匿名响应或全部。</span>
<p> <span><a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#ALL"><code>AddressingFeature.Responses.ALL</code></a>支持所有响应类型，这是默认值。</span> </p>
<p> <span><a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#ANONYMOUS"><code>AddressingFeature.Responses.ANONYMOUS</code></a>要求仅使用匿名响应。</span> <span>这将导致在生成的WSDL中的<a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicyanonresponses">3.1.2 AnonymousResponses Assertion</a>中指定的wsam：AnonymousResponses嵌套断言。</span> </p>
<p> <span><a href="../../../../javax/xml/ws/soap/AddressingFeature.Responses.html#NON_ANONYMOUS"><code>AddressingFeature.Responses.NON_ANONYMOUS</code></a>要求仅使用非匿名响应。</span> <span>这将导致在生成的WSDL中的<a href="http://www.w3.org/TR/ws-addr-metadata/#wspolicynonanonresponses">3.1.3 NonAnonymousResponses Assertion</a>中指定的wsam：NonAnonymousResponses嵌套断言。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.2 
           </dd>
</dl>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             javax.xml.ws.soap.AddressingFeature.Responses.ALL 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>