uTools-Manuals/docs/java/javax/xml/ws/Action.html

<div class="header">
<div class="subTitle">
     javax.xml.ws 
   </div>
<h2 class="title" title="Annotation Type Action">Annotation Type Action</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre><a href="../../../java/lang/annotation/Documented.html" title="annotation in java.lang.annotation">@Documented</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/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#METHOD">METHOD</a>)
public @interface <span class="memberNameLabel">Action</span></pre>
<div class="block">
<span>所述<code>Action</code>注释允许一个WS寻址的显式关联<code>Action</code>与消息寻址属性<code>input</code> ， <code>output</code>和<code>fault</code>所映射的WSDL操作的消息。</span>
<p> <span>可以在服务端点接口的每个方法上指定此注释。</span> <span>对于这样的方法，在生成的WSDL的映射操作<code>wsam:Action</code>在WSDL属性<code>input</code> ， <code>output</code>和<code>fault</code>的WSDL的消息<code>operation</code>是基于哪些属性的的时<code>Action</code>已指定注释。</span> <span>要精确计算消息的<code>wsam:Action</code>值，请参考JAX-WS规范中的算法。</span> </p>
<p> <span><b>示例1</b> ：为<code>input</code>和<code>output</code>消息指定<code>Action</code>消息寻址属性的显式值。</span> </p>
<pre>  <span>@WebService(targetNamespace="http://example.com/numbers")
 public class AddNumbersImpl {
     <b>@Action( input="http://example.com/inputAction", output="http://example.com/outputAction")</b>
     public int addNumbers(int number1, int number2) {
         return number1 + number2;
     }
 }</span> </pre>
<span>生成的WSDL如下所示：</span>
<pre>  <span>&lt;definitions targetNamespace="http://example.com/numbers" ...&gt;
     ...
     &lt;portType name="AddNumbersPortType"&gt;
       &lt;operation name="AddNumbers"&gt;
         &lt;input message="tns:AddNumbersInput" name="foo"
           <b>wsam:Action="http://example.com/inputAction"</b>/&gt;
         &lt;output message="tns:AddNumbersOutput" name="bar"
           <b>wsam:Action="http://example.com/outputAction"</b>/&gt;
       &lt;/operation&gt;
     &lt;/portType&gt;
     ...
   &lt;/definitions&gt;</span> </pre>
<p> <span><b>实施例2：</b>用于指定显式值<code>Action</code>消息寻址属性仅对<code>input</code>消息。</span> <span>使用JAX-WS规范中的算法计算WSDL <code>output</code>消息的<code>wsam:Action</code>值。</span> </p>
<pre>  <span>@WebService(targetNamespace="http://example.com/numbers")
 public class AddNumbersImpl {
     <b>@Action(input="http://example.com/inputAction")</b>
     public int addNumbers(int number1, int number2) {
         return number1 + number2;
     }
 }</span> </pre>
<span>生成的WSDL如下所示：</span>
<pre>  <span>&lt;definitions targetNamespace="http://example.com/numbers" ...&gt;
     ...
     &lt;portType name="AddNumbersPortType"&gt;
       &lt;operation name="AddNumbers"&gt;
         &lt;input message="tns:AddNumbersInput" name="foo"
           <b>wsam:Action="http://example.com/inputAction"</b> /&gt;
         &lt;output message="tns:AddNumbersOutput" name="bar"
           <b>wsam:Action="http://example.com/numbers/AddNumbersPortType/AddNumbersResponse"</b>/&gt;
       &lt;/operation&gt;
     &lt;/portType&gt;
     ...
   &lt;/definitions&gt;</span> </pre>
<span>它是合法的，为指定一个明确的价值<code>Action</code>消息处理财产为<code>output</code>唯一的消息。</span>
<span>在这种情况下，使用JAX-WS规范中的算法来计算WSDL <code>input</code>消息的<code>wsam:Action</code>值。</span>
<p> <span><b>实施例3：</b>参见<a href="../../../javax/xml/ws/FaultAction.html" title="javax.xml.ws中的注释"><code>FaultAction</code></a>注释有关如何用于指定一个明确的值的示例<code>Action</code>消息寻址属性为<code>fault</code>消息。</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/FaultAction.html" title="javax.xml.ws中的注释"><code>FaultAction</code></a></span>
</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><a href="../../../javax/xml/ws/FaultAction.html" title="annotation in javax.xml.ws">FaultAction</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Action.html#fault--">fault</a></span></code>
<div class="block">
              所述的显式值的WS-Addressing 
             <code>Action</code>消息寻址属性为 
             <code>fault</code>的操作的（多个）消息。 
            </div> </td>
</tr>
<tr class="rowColor">
<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/Action.html#input--">input</a></span></code>
<div class="block">
              所述的显式值的WS-Addressing 
             <code>Action</code>消息寻址属性为 
             <code>input</code>的操作的消息。 
            </div> </td>
</tr>
<tr class="altColor">
<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/Action.html#output--">output</a></span></code>
<div class="block">
              所述的显式值的WS-Addressing 
             <code>Action</code>消息寻址属性为 
             <code>output</code>的操作的消息。 
            </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="input--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>input</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> input</pre>
<div class="block">
            所述的显式值的WS-Addressing 
           <code>Action</code>消息寻址属性为 
           <code>input</code>的操作的消息。 
          </div>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             “” 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="output--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>output</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> output</pre>
<div class="block">
            所述的显式值的WS-Addressing 
           <code>Action</code>消息寻址属性为 
           <code>output</code>的操作的消息。 
          </div>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             “” 
           </dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fault--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>fault</h4> <pre>public abstract <a href="../../../javax/xml/ws/FaultAction.html" title="annotation in javax.xml.ws">FaultAction</a>[] fault</pre>
<div class="block">
<span>所述的显式值的WS-Addressing <code>Action</code>消息寻址属性为<code>fault</code>的操作的（多个）消息。</span>
<span>映射到故障并需要显式WS-Addressing <code>Action</code>消息寻址属性的每个<code>Action</code>都需要使用<a href="../../../javax/xml/ws/FaultAction.html" title="javax.xml.ws中的注释"><code>FaultAction</code></a>注释指定为此属性中的值。</span>
</div>
<dl>
<dt>
             Default: 
           </dt>
<dd>
             {} 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>