uTools-Manuals/docs/java/javax/xml/ws/spi/ServiceDelegate.html

<div class="header">
<div class="subTitle">
     javax.xml.ws.spi 
   </div>
<h2 class="title" title="Class ServiceDelegate">Class ServiceDelegate</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>javax.xml.ws.spi.ServiceDelegate</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">ServiceDelegate</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>服务代表在内部由<code>Service</code>对象使用，以允许JAX-WS实现的可插拔性。</span>
<p> <span>每个<code>Service</code>对象都有自己的委托，使用<a href="../../../../javax/xml/ws/spi/Provider.html#createServiceDelegate-java.net.URL-javax.xml.namespace.QName-java.lang.Class-"><code>Provider.createServiceDelegate(java.net.URL, javax.xml.namespace.QName, java.lang.Class&lt;? extends javax.xml.ws.Service&gt;)</code></a>方法创建。</span> <span><code>Service</code>对象将其所有实例方法委托给其委托。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         JAX-WS 2.0 
       </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/ws/Service.html" title="javax.xml.ws中的类"><code>Service</code></a> ， <a href="../../../../javax/xml/ws/spi/Provider.html" title="javax.xml.ws.spi中的类"><code>Provider</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== 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="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#ServiceDelegate--">ServiceDelegate</a></span>()</code> </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="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>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#addPort-javax.xml.namespace.QName-java.lang.String-java.lang.String-">addPort</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> bindingId, <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> endpointAddress)</code>
<div class="block">
              为服务创建一个新的端口。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.ws.EndpointReference-java.lang.Class-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">createDispatch</a></span>(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个 
             <code>Dispatch</code>实例，供用户选择的对象使用。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.ws.EndpointReference-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">createDispatch</a></span>(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference, <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个用于JAXB生成的对象的 
             <code>Dispatch</code>实例。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.Service.Mode-">createDispatch</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode)</code>
<div class="block">
              创建一个 
             <code>Dispatch</code>实例，供用户选择的对象使用。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">createDispatch</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个 
             <code>Dispatch</code>实例，供用户选择的对象使用。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.namespace.QName-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-">createDispatch</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode)</code>
<div class="block">
              创建一个用于JAXB生成的对象的 
             <code>Dispatch</code>实例。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#createDispatch-javax.xml.namespace.QName-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">createDispatch</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context, <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个用于JAXB生成的对象的 
             <code>Dispatch</code>实例。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>abstract <a href="../../../../java/util/concurrent/Executor.html" title="interface in java.util.concurrent">Executor</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getExecutor--">getExecutor</a></span>()</code>
<div class="block">
              返回此 
             <code>Service</code>实例的执行程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>abstract <a href="../../../../javax/xml/ws/handler/HandlerResolver.html" title="interface in javax.xml.ws.handler">HandlerResolver</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getHandlerResolver--">getHandlerResolver</a></span>()</code>
<div class="block">
              返回配置的处理程序解析器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>abstract &lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPort-java.lang.Class-">getPort</a></span>(<a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface)</code>
<div class="block">
<code>getPort</code>方法返回一个代理。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>abstract &lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPort-java.lang.Class-javax.xml.ws.WebServiceFeature...-">getPort</a></span>(<a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
<code>getPort</code>方法返回一个代理。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>abstract &lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPort-javax.xml.ws.EndpointReference-java.lang.Class-javax.xml.ws.WebServiceFeature...-">getPort</a></span>(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
<code>getPort</code>方法返回一个代理。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>abstract &lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPort-javax.xml.namespace.QName-java.lang.Class-">getPort</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface)</code>
<div class="block">
<code>getPort</code>方法返回一个代理。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>abstract &lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPort-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.WebServiceFeature...-">getPort</a></span>(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName, <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface, <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
<code>getPort</code>方法返回代理。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>abstract <a href="../../../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a>&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getPorts--">getPorts</a></span>()</code>
<div class="block">
              返回 
             <code>Iterator</code> ，用于 
             <code>QName</code>服务分组的 
             <code>QName</code>个服务端点列表 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>abstract <a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getServiceName--">getServiceName</a></span>()</code>
<div class="block">
              获取此服务的名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>abstract <a href="../../../../java/net/URL.html" title="class in java.net">URL</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#getWSDLDocumentLocation--">getWSDLDocumentLocation</a></span>()</code>
<div class="block">
              获取此服务的WSDL文档的位置。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#setExecutor-java.util.concurrent.Executor-">setExecutor</a></span>(<a href="../../../../java/util/concurrent/Executor.html" title="interface in java.util.concurrent">Executor</a> executor)</code>
<div class="block">
              设置此 
             <code>Service</code>实例的执行程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/ws/spi/ServiceDelegate.html#setHandlerResolver-javax.xml.ws.handler.HandlerResolver-">setHandlerResolver</a></span>(<a href="../../../../javax/xml/ws/handler/HandlerResolver.html" title="interface in javax.xml.ws.handler">HandlerResolver</a> handlerResolver)</code>
<div class="block">
              设置 
             <code>HandlerResolver</code>这个 
             <code>Service</code>实例。 
            </div> </td>
</tr>
</tbody>
</table>
<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">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ServiceDelegate--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ServiceDelegate</h4> <pre>protected ServiceDelegate()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getPort-javax.xml.namespace.QName-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public abstract &lt;T&gt; T getPort(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                              <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface)</pre>
<div class="block">
<span><code>getPort</code>方法返回代理。</span>
<span>服务客户端使用此代理来调用目标服务端点上的操作。</span>
<span><code>serviceEndpointInterface</code>指定创建的动态代理实例支持的服务端点接口。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - WSDL服务描述中服务端点的合格名称 
           </dd>
<dd>
<code>serviceEndpointInterface</code> - 动态代理支持的服务端点接口 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持指定服务端点接口的Object Proxy实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 在以下情况下抛出此异常：</span>
<ul>
<li> <span>如果创建代理时出现错误</span> </li>
<li> <span>如果此方法需要缺少WSDL元数据</span> </li>
<li> <span>如果非法<code>serviceEndpointInterface</code>或<code>portName</code>指定</span> </li>
</ul>
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/lang/reflect/Proxy.html" title="class java.lang.reflect"><code>Proxy</code></a> ， <a href="../../../../java/lang/reflect/InvocationHandler.html" title="java.lang.reflect中的接口"><code>InvocationHandler</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getPort-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public abstract &lt;T&gt; T getPort(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                              <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface,
                              <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span><code>getPort</code>方法返回代理。</span>
<span>服务客户端使用此代理来调用目标服务端点上的操作。</span>
<span><code>serviceEndpointInterface</code>指定创建的动态代理实例支持的服务端点接口。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - WSDL服务描述中服务端点的合格名称 
           </dd>
<dd>
<code>serviceEndpointInterface</code> - 动态代理或实例支持的服务端点接口 
           </dd>
<dd>
<span><code>features</code> - 要在代理上配置的WebServiceFeatures的列表。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持指定服务端点接口的Object Proxy实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 在以下情况下抛出此异常：</span>
<ul>
<li> <span>如果创建代理时出现错误</span> </li>
<li> <span>如果此方法需要缺少WSDL元数据</span> </li>
<li> <span>如果非法<code>serviceEndpointInterface</code>或<code>portName</code>指定</span> </li>
<li> <span>如果启用了与该端口不兼容或不受支持的功能。</span> </li>
</ul>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/lang/reflect/Proxy.html" title="class java.lang.reflect"><code>Proxy</code></a> ， <a href="../../../../java/lang/reflect/InvocationHandler.html" title="java.lang.reflect中的接口"><code>InvocationHandler</code></a> ， <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getPort-javax.xml.ws.EndpointReference-java.lang.Class-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public abstract &lt;T&gt; T getPort(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference,
                              <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface,
                              <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span><code>getPort</code>方法返回代理。</span>
<span>参数endpointReference <code>endpointReference</code>将由返回的代理调用的端点。</span>
<span>如果有在任何参考参数<code>endpointReference</code> ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。</span>
<span><code>endpointReference's</code>地址必须用于端点上的调用。</span>
<span>参数<code>serviceEndpointInterface</code>指定返回的代理支持的服务端点接口。</span>
<span>在此方法的实施中，JAX-WS运行时系统需要选择协议绑定（和端口），并从与此相关联的WSDL相应地配置代理的责任<code>Service</code>实例或从元数据<code>endpointReference</code> 。</span>
<span>如果此<code>Service</code>实例具有WSDL，并且<code>endpointReference</code>元数据也具有WSDL，则必须使用此实例的WSDL。</span>
<span>如果这个<code>Service</code>实例没有WSDL，并且<code>endpointReference</code>确实有一个WSDL，那么可以使用<code>endpointReference</code>的WSDL。</span>
<span>返回的代理不应由客户机重新配置。</span>
<span>如果此<code>Service</code>实例具有与WSDL中包含的信息相匹配的已知代理端口，则返回该代理，否则抛出WebServiceException。</span>
<p> <span>调用此方法具有与以下相同的行为</span> </p>
<pre>  <span><code>port = service.getPort(portName, serviceEndpointInterface);</code></span> </pre>
<span>其中<code>portName</code>从的元数据检索<code>endpointReference</code>或从<code>serviceEndpointInterface</code>和与此相关的WSDL <code>Service</code>实例。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>endpointReference</code> - 将由返回的代理调用的目标服务端点的 
            <code>EndpointReference</code> 。 
           </dd>
<dd>
<code>serviceEndpointInterface</code> - 服务端点接口。 
           </dd>
<dd>
<span><code>features</code> - 要在代理上配置的<code>WebServiceFeatures</code>的列表。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持指定服务端点接口的Object Proxy实例。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -</span>
<ul>
<li> <span>如果在创建代理时出现错误。</span> </li>
<li> <span>如果此方法需要缺少WSDL元数据。</span> </li>
<li> <span>如果<code>endpointReference</code>元数据与此<code>Service</code>实例的<code>serviceName</code>不匹配。</span> </li>
<li> <span>如果<code>portName</code>不能从WSDL或提取<code>endpointReference</code>元数据。</span> </li>
<li> <span>如果无效<code>endpointReference</code>指定。</span> </li>
<li> <span>如果无效<code>serviceEndpointInterface</code>指定。</span> </li>
<li> <span>如果启用了与该端口不兼容或不受支持的功能。</span> </li>
</ul>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
</dl> </li>
</ul> <a name="getPort-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public abstract &lt;T&gt; T getPort(<a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface)</pre>
<div class="block">
<span><code>getPort</code>方法返回代理。</span>
<span>参数<code>serviceEndpointInterface</code>指定返回的代理支持的服务端点接口。</span>
<span>在实现该方法时，JAX-WS运行时系统负责选择协议绑定（和端口）并相应地配置代理。</span>
<span>返回的代理不应由客户机重新配置。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>serviceEndpointInterface</code> - 服务端点接口 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持指定服务端点接口的对象实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -</span>
<ul>
<li> <span>如果在创建代理时出现错误</span> </li>
<li> <span>如果此方法需要缺少WSDL元数据</span> </li>
<li> <span>如果非法<code>serviceEndpointInterface</code>指定</span> </li>
</ul>
</dd>
</dl> </li>
</ul> <a name="getPort-java.lang.Class-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public abstract &lt;T&gt; T getPort(<a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; serviceEndpointInterface,
                              <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span><code>getPort</code>方法返回代理。</span>
<span>参数<code>serviceEndpointInterface</code>指定返回的代理支持的服务端点接口。</span>
<span>在实现该方法时，JAX-WS运行时系统负责选择协议绑定（和端口）并相应地配置代理。</span>
<span>返回的代理不应由客户机重新配置。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>serviceEndpointInterface</code> - 服务端点接口 
           </dd>
<dd>
<span><code>features</code> -数组<code>WebServiceFeatures</code>配置上的代理。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             支持指定服务端点接口的对象实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -</span>
<ul>
<li> <span>如果在创建代理时出现错误</span> </li>
<li> <span>如果此方法需要缺少WSDL元数据</span> </li>
<li> <span>如果非法<code>serviceEndpointInterface</code>指定</span> </li>
<li> <span>如果启用了与该端口不兼容或不受支持的功能。</span> </li>
</ul>
</dd>
<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/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="addPort-javax.xml.namespace.QName-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addPort</h4> <pre>public abstract void addPort(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                             <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> bindingId,
                             <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> endpointAddress)</pre>
<div class="block">
<span>为服务创建一个新的端口。</span>
<span>以这种方式创建的端口不包含WSDL端口类型信息，只能用于创建<code>Dispatch</code>实例。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - 目标服务端点的合格名称 
           </dd>
<dd>
<code>bindingId</code> - 绑定的URI标识符。 
           </dd>
<dd>
<code>endpointAddress</code> - 作为URI的目标服务端点的地址 
           </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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../javax/xml/ws/soap/SOAPBinding.html#SOAP11HTTP_BINDING"><code>SOAPBinding.SOAP11HTTP_BINDING</code></a> ， 
            <a href="../../../../javax/xml/ws/soap/SOAPBinding.html#SOAP12HTTP_BINDING"><code>SOAPBinding.SOAP12HTTP_BINDING</code></a> ， 
            <a href="../../../../javax/xml/ws/http/HTTPBinding.html#HTTP_BINDING"><code>HTTPBinding.HTTP_BINDING</code></a>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.Service.Mode-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt; createDispatch(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                                               <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type,
                                               <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode)</pre>
<div class="block">
            创建一个 
           <code>Dispatch</code>实例，供用户选择的对象使用。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - 目标服务端点的合格名称 
           </dd>
<dd>
<span><code>type</code> - 用于消息或消息有效载荷的对象类。</span>
<span>需要实现支持<code>javax.xml.transform.Source</code>和<code>javax.xml.soap.SOAPMessage</code> 。</span>
</dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
<span>模式必须<code>MESSAGE</code>当类型是<code>SOAPMessage</code> 。</span>
</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>Source</code></a> ， <a href="../../../../javax/xml/soap/SOAPMessage.html" title="javax.xml.soap中的类"><code>SOAPMessage</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.namespace.QName-java.lang.Class-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt; createDispatch(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                                               <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type,
                                               <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode,
                                               <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
            创建一个用于用户选择的对象的 
           <code>Dispatch</code>实例。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - 目标服务端点的合格名称 
           </dd>
<dd>
<span><code>type</code> - 用于消息或消息有效载荷的对象类。</span>
<span>需要实施支持<code>javax.xml.transform.Source</code>和<code>javax.xml.soap.SOAPMessage</code> 。</span>
</dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
<span>模式必须<code>MESSAGE</code>当类型是<code>SOAPMessage</code> 。</span>
</dd>
<dd>
<span><code>features</code> - 要在代理上配置的<code>WebServiceFeatures</code>的列表。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</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>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>Source</code></a> ， <a href="../../../../javax/xml/soap/SOAPMessage.html" title="javax.xml.soap中的类"><code>SOAPMessage</code></a> ， <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.ws.EndpointReference-java.lang.Class-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract &lt;T&gt; <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;T&gt; createDispatch(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference,
                                               <a href="../../../../java/lang/Class.html" title="class in java.lang">类</a>&lt;T&gt; type,
                                               <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode,
                                               <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span>创建一个<code>Dispatch</code>实例，供用户选择的对象使用。</span>
<span>如果有在任何参考参数<code>endpointReference</code> ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。</span>
<span><code>endpointReference's</code>地址必须用于端点上的调用。</span>
<span>在实现此方法时，JAX-WS运行时系统负责选择协议绑定（和端口），并从与此<code>Service</code>实例相关联的WSDL或从<code>Service</code>的元数据相应地<code>endpointReference</code> 。</span>
<span>如果此<code>Service</code>实例具有WSDL，并且<code>endpointReference</code>在其元数据中也具有WSDL，则必须使用此实例的WSDL。</span>
<span>如果这个<code>Service</code>实例没有WSDL，并且<code>endpointReference</code>确实有一个WSDL，那么可以使用<code>endpointReference</code>的WSDL。</span>
<span>一个实现必须能够检索<code>portName</code>从<code>endpointReference</code>元。</span>
<p> <span>此方法的行为与调用相同</span> </p>
<pre>  <span><code>dispatch = service.createDispatch(portName, type, mode, features);</code></span> </pre>
<span>其中<code>portName</code>从WSDL或检索<code>EndpointReference</code>元数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>endpointReference</code> -该 
            <code>EndpointReference</code>用于将由返回调用的目标服务端点 
            <code>Dispatch</code>对象。 
           </dd>
<dd>
<span><code>type</code> - 用于消息或消息有效载荷的对象类。</span>
<span>需要实施支持<code>javax.xml.transform.Source</code>和<code>javax.xml.soap.SOAPMessage</code> 。</span>
</dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
<span>模式必须<code>MESSAGE</code>当类型是<code>SOAPMessage</code> 。</span>
</dd>
<dd>
<span><code>features</code> -数组<code>WebServiceFeatures</code>配置上的代理。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             调度实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -</span>
<ul>
<li> <span>如果此方法需要缺少WSDL元数据。</span> </li>
<li> <span>如果<code>endpointReference</code>元数据与与此<code>Service</code>实例相关<code>portName</code>的WSDL的<code>serviceName</code>或<code>portName</code>不匹配。</span> </li>
<li> <span>如果<code>portName</code>不能从<code>EndpointReference</code>元数据确定。</span> </li>
<li> <span>如果有任何错误，创建<code>Dispatch</code>对象。</span> </li>
<li> <span>如果启用了与该端口不兼容或不受支持的功能。</span> </li>
</ul>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/transform/Source.html" title="javax.xml.transform中的接口"><code>Source</code></a> ， <a href="../../../../javax/xml/soap/SOAPMessage.html" title="javax.xml.soap中的类"><code>SOAPMessage</code></a> ， <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.namespace.QName-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt; createDispatch(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                                                <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context,
                                                <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode)</pre>
<div class="block">
            创建一个用于JAXB生成的对象的 
           <code>Dispatch</code>实例。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - 目标服务端点的合格名称 
           </dd>
<dd>
<code>context</code> - 用于编组和解组消息或消息有效载荷的JAXB上下文。 
           </dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
</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>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/bind/JAXBContext.html" title="javax.xml.bind中的类"><code>JAXBContext</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.namespace.QName-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt; createDispatch(<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> portName,
                                                <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context,
                                                <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode,
                                                <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
            创建一个用于JAXB生成的对象的 
           <code>Dispatch</code>实例。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>portName</code> - 目标服务端点的合格名称 
           </dd>
<dd>
<code>context</code> - 用于编组和解组消息或消息有效载荷的JAXB上下文。 
           </dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
</dd>
<dd>
<span><code>features</code> - 要在代理上配置的<code>WebServiceFeatures</code>的列表。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</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>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/bind/JAXBContext.html" title="javax.xml.bind中的类"><code>JAXBContext</code></a> ， <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="createDispatch-javax.xml.ws.EndpointReference-javax.xml.bind.JAXBContext-javax.xml.ws.Service.Mode-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createDispatch</h4> <pre>public abstract <a href="../../../../javax/xml/ws/Dispatch.html" title="interface in javax.xml.ws">Dispatch</a>&lt;<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a>&gt; createDispatch(<a href="../../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> endpointReference,
                                                <a href="../../../../javax/xml/bind/JAXBContext.html" title="class in javax.xml.bind">JAXBContext</a> context,
                                                <a href="../../../../javax/xml/ws/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a> mode,
                                                <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span>创建一个用于JAXB生成的对象的<code>Dispatch</code>实例。</span>
<span>如果有在任何参考参数<code>endpointReference</code> ，则这些参考参数必须显示为SOAP标头，指示它们是参照参数，对发送到端点的所有消息。</span>
<span><code>endpointReference's</code>地址必须用于端点上的调用。</span>
<span>在实现此方法时，JAX-WS运行时系统负责选择协议绑定（和端口），并从与此<code>Service</code>实例相关联的WSDL或从<code>Service</code>的元数据相应地<code>endpointReference</code> 。</span>
<span>如果此<code>Service</code>实例具有WSDL，并且<code>endpointReference</code>在其元数据中也具有WSDL，则必须使用此实例的WSDL。</span>
<span>如果此<code>Service</code>实例没有WSDL，并且<code>endpointReference</code>确实有一个WSDL，则可以使用<code>endpointReference</code>的WSDL。</span>
<span>一个实现必须能够检索<code>portName</code>从<code>endpointReference</code>元。</span>
<p> <span>此方法与调用相同</span> </p>
<pre>  <span><code>dispatch = service.createDispatch(portName, context, mode, features);</code></span> </pre>
<span>其中<code>portName</code>是从WSDL或<code>endpointReference</code>元数据<code>endpointReference</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>endpointReference</code> -该 
            <code>EndpointReference</code>用于将由返回调用的目标服务端点 
            <code>Dispatch</code>对象。 
           </dd>
<dd>
<code>context</code> - 用于编组和解组消息或消息有效载荷的JAXB上下文。 
           </dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即用户是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制用户是否使用SOAP消息或SOAP主体的内容。</span>
</dd>
<dd>
<span><code>features</code> - 要在代理上配置的<code>WebServiceFeatures</code>数组。</span>
<span>支持的功能不是在<code>features</code>参数将其默认值。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             调度实例 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -</span>
<ul>
<li> <span>如果此方法需要缺少WSDL元数据。</span> </li>
<li> <span>如果<code>endpointReference</code>元数据与与此<code>Service</code>实例相关<code>portName</code>的WSDL的<code>serviceName</code>或<code>portName</code>不匹配。</span> </li>
<li> <span>如果<code>portName</code>不能从<code>EndpointReference</code>元数据确定。</span> </li>
<li> <span>如果有任何错误在创建<code>Dispatch</code>对象。</span> </li>
<li> <span>如果启用了与此端口不兼容或不受支持的功能。</span> </li>
</ul>
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.1 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/bind/JAXBContext.html" title="javax.xml.bind中的类"><code>JAXBContext</code></a> ， <a href="../../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getServiceName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getServiceName</h4> <pre>public abstract <a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> getServiceName()</pre>
<div class="block">
            获取此服务的名称。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             此服务的合格名称 
           </dd>
</dl> </li>
</ul> <a name="getPorts--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPorts</h4> <pre>public abstract <a href="../../../../java/util/Iterator.html" title="interface in java.util">Iterator</a>&lt;<a href="../../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a>&gt; getPorts()</pre>
<div class="block">
            返回 
           <code>Iterator</code>的 
           <code>QName</code> s服务端点列表 
           <code>QName</code>服务分组 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             返回 
            <code>java.util.Iterator</code> ，元素类型为 
            <code>javax.xml.namespace.QName</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> - 如果此Service类无法访问所需的WSDL元数据 
           </dd>
</dl> </li>
</ul> <a name="getWSDLDocumentLocation--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getWSDLDocumentLocation</h4> <pre>public abstract <a href="../../../../java/net/URL.html" title="class in java.net">URL</a> getWSDLDocumentLocation()</pre>
<div class="block">
            获取此服务的WSDL文档的位置。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             此服务的WSDL文档的位置的URL 
           </dd>
</dl> </li>
</ul> <a name="getHandlerResolver--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getHandlerResolver</h4> <pre>public abstract <a href="../../../../javax/xml/ws/handler/HandlerResolver.html" title="interface in javax.xml.ws.handler">HandlerResolver</a> getHandlerResolver()</pre>
<div class="block">
            返回配置的处理程序解析器。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             HandlerResolver 
            <code>HandlerResolver</code>被这个 
            <code>Service</code>实例使用，如果没有一个 
            <code>null</code> 。 
           </dd>
</dl> </li>
</ul> <a name="setHandlerResolver-javax.xml.ws.handler.HandlerResolver-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setHandlerResolver</h4> <pre>public abstract void setHandlerResolver(<a href="../../../../javax/xml/ws/handler/HandlerResolver.html" title="interface in javax.xml.ws.handler">HandlerResolver</a> handlerResolver)</pre>
<div class="block">
<span>设置<code>HandlerResolver</code>这个<code>Service</code>实例。</span>
<p> <span>处理程序解析器（如果存在）将为创建的每个代理或分派实例调用一次，并且解析器返回的处理程序链将在实例上设置。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>handlerResolver</code> -该 
            <code>HandlerResolver</code>用于所有随后创建的代理/调度对象。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../javax/xml/ws/handler/HandlerResolver.html" title="javax.xml.ws.handler中的接口"><code>HandlerResolver</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getExecutor--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getExecutor</h4> <pre>public abstract <a href="../../../../java/util/concurrent/Executor.html" title="interface in java.util.concurrent">Executor</a> getExecutor()</pre>
<div class="block">
<span>返回此<code>Service</code>实例的执行程序。</span>
<span>执行器用于需要回调的所有异步调用。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>java.util.concurrent.Executor</code>用于调用回调。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/util/concurrent/Executor.html" title="java.util.concurrent中的接口"><code>Executor</code></a></span>
</dd>
</dl> </li>
</ul> <a name="setExecutor-java.util.concurrent.Executor-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>setExecutor</h4> <pre>public abstract void setExecutor(<a href="../../../../java/util/concurrent/Executor.html" title="interface in java.util.concurrent">Executor</a> executor)</pre>
<div class="block">
<span>设置此<code>Service</code>实例的执行程序。</span>
<span>执行器用于需要回调的所有异步调用。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>executor</code> - 用于调用回调的 
            <code>java.util.concurrent.Executor</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/SecurityException.html" title="class in java.lang">SecurityException</a></code> - 如果实例不支持以安全原因设置执行程序（例如缺少必需的权限）。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../../java/util/concurrent/Executor.html" title="java.util.concurrent中的接口"><code>Executor</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>