234 lines
12 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
</div>
<h2 class="title" title="Interface Dispatch">Interface Dispatch&lt;T&gt;</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../javax/xml/ws/BindingProvider.html" title="javax.xml.ws中的接口">BindingProvider</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Dispatch&lt;T&gt;</span>
extends <a href="../../../javax/xml/ws/BindingProvider.html" title="interface in javax.xml.ws">BindingProvider</a></pre>
<div class="block">
<span><code>Dispatch</code>接口为动态调用服务端点操作提供支持。</span>
<span><code>javax.xml.ws.Service</code>类用作创建<code>Dispatch</code>实例的工厂。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JAX-WS 2.0
</dd>
</dl> </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.javax.xml.ws.BindingProvider">
<!-- --> </a> <h3>Fields inherited from interface javax.xml.ws.<a href="../../../javax/xml/ws/BindingProvider.html" title="interface in javax.xml.ws">BindingProvider</a></h3> <code><a href="../../../javax/xml/ws/BindingProvider.html#ENDPOINT_ADDRESS_PROPERTY">ENDPOINT_ADDRESS_PROPERTY</a>, <a href="../../../javax/xml/ws/BindingProvider.html#PASSWORD_PROPERTY">PASSWORD_PROPERTY</a>, <a href="../../../javax/xml/ws/BindingProvider.html#SESSION_MAINTAIN_PROPERTY">SESSION_MAINTAIN_PROPERTY</a>, <a href="../../../javax/xml/ws/BindingProvider.html#SOAPACTION_URI_PROPERTY">SOAPACTION_URI_PROPERTY</a>, <a href="../../../javax/xml/ws/BindingProvider.html#SOAPACTION_USE_PROPERTY">SOAPACTION_USE_PROPERTY</a>, <a href="../../../javax/xml/ws/BindingProvider.html#USERNAME_PROPERTY">USERNAME_PROPERTY</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/ws/Dispatch.html" title="type parameter in Dispatch">T</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Dispatch.html#invoke-T-">invoke</a></span>(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</code>
<div class="block">
同步调用服务操作。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/xml/ws/Response.html" title="interface in javax.xml.ws">Response</a>&lt;<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Dispatch.html#invokeAsync-T-">invokeAsync</a></span>(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</code>
<div class="block">
异步调用服务操作。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/util/concurrent/Future.html" title="interface in java.util.concurrent">Future</a>&lt;?&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Dispatch.html#invokeAsync-T-javax.xml.ws.AsyncHandler-">invokeAsync</a></span>(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg, <a href="../../../javax/xml/ws/AsyncHandler.html" title="interface in javax.xml.ws">AsyncHandler</a>&lt;<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a>&gt; handler)</code>
<div class="block">
异步调用服务操作。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Dispatch.html#invokeOneWay-T-">invokeOneWay</a></span>(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</code>
<div class="block">
使用单向交互模式调用服务操作。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.xml.ws.BindingProvider">
<!-- --> </a> <h3>Methods inherited from interface javax.xml.ws.<a href="../../../javax/xml/ws/BindingProvider.html" title="interface in javax.xml.ws">BindingProvider</a></h3> <code><a href="../../../javax/xml/ws/BindingProvider.html#getBinding--">getBinding</a>, <a href="../../../javax/xml/ws/BindingProvider.html#getEndpointReference--">getEndpointReference</a>, <a href="../../../javax/xml/ws/BindingProvider.html#getEndpointReference-java.lang.Class-">getEndpointReference</a>, <a href="../../../javax/xml/ws/BindingProvider.html#getRequestContext--">getRequestContext</a>, <a href="../../../javax/xml/ws/BindingProvider.html#getResponseContext--">getResponseContext</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="invoke-java.lang.Object-">
<!-- --> </a><a name="invoke-T-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>invoke</h4> <pre><a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> invoke(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</pre>
<div class="block">
<span>同步调用服务操作。</span>
<span>根据使用协议绑定的要求,客户端负责确保<code>msg</code>对象。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>msg</code> - 将形成用于调用操作的消息的消息或有效负载的对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
响应消息或消息有效载荷到操作调用。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果在与服务通信期间发生故障
</dd>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果
<code>Dispatch</code>实例的配置有任何错误
</dd>
</dl> </li>
</ul> <a name="invokeAsync-java.lang.Object-">
<!-- --> </a><a name="invokeAsync-T-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>invokeAsync</h4> <pre><a href="../../../javax/xml/ws/Response.html" title="interface in javax.xml.ws">Response</a>&lt;<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a>&gt; invokeAsync(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</pre>
<div class="block">
<span>异步调用服务操作。</span>
<span>该方法返回而不等待对操作调用的响应,操作的结果通过轮询返回的<code>Response</code></span>
<p> <span>根据使用协议绑定的要求,客户端负责确保<code>msg</code>对象。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>msg</code> - 将形成用于调用操作的消息或消息的有效内容的对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
响应消息或消息有效载荷到操作调用。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果
<code>Dispatch</code>实例的配置有任何错误
</dd>
</dl> </li>
</ul> <a name="invokeAsync-java.lang.Object-javax.xml.ws.AsyncHandler-">
<!-- --> </a><a name="invokeAsync-T-javax.xml.ws.AsyncHandler-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>invokeAsync</h4> <pre><a href="../../../java/util/concurrent/Future.html" title="interface in java.util.concurrent">Future</a>&lt;?&gt; invokeAsync(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg,
<a href="../../../javax/xml/ws/AsyncHandler.html" title="interface in javax.xml.ws">AsyncHandler</a>&lt;<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a>&gt; handler)</pre>
<div class="block">
<span>异步调用服务操作。</span>
<span>无需等待响应于所述操作调用该方法返回,操作的结果通过在传递传送到客户端<code>handler</code></span>
<p> <span>根据使用协议绑定的要求,客户端负责确保<code>msg</code>对象。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>msg</code> - 将形成用于调用操作的消息或消息的有效内容的对象。
</dd>
<dd>
<code>handler</code> - 将接收对操作调用的响应的处理程序对象。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span><code>Future</code>可用于检查操作调用的状态对象。</span>
<span>该对象绝对不能用于尝试获取操作的结果 - 从<code>Future&lt;?&gt;.get()</code>返回的对象是依赖于实现的,并且任何使用它将导致非便携式行为。</span>
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果
<code>Dispatch</code>实例的配置有任何错误
</dd>
</dl> </li>
</ul> <a name="invokeOneWay-java.lang.Object-">
<!-- --> </a><a name="invokeOneWay-T-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>invokeOneWay</h4> <pre>void invokeOneWay(<a href="../../../javax/xml/ws/Dispatch.html" title="type parameter in Dispatch">T</a> msg)</pre>
<div class="block">
<span>使用单向交互模式调用服务操作。</span>
<span>操作调用在逻辑上是非阻塞的,受底层协议的功能的限制,不会返回任何结果。</span>
<span>当使用的协议是SOAP / HTTP时该方法必须阻塞直到接收到HTTP响应代码或发生错误。</span>
<p> <span>根据使用协议绑定的要求,客户端负责确保<code>msg</code>对象。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>msg</code> - 将形成用于调用操作的消息或消息的有效内容的对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果
<code>Dispatch</code>实例的配置有任何错误或调用期间发生错误。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>