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

<div class="header">
<div class="subTitle">
     javax.xml.ws 
   </div>
<h2 class="title" title="Class Service">Class Service</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.Service</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public class <span class="typeNameLabel">Service</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span><code>Service</code>对象提供Web服务的客户端视图。</span>
<p> <span><code>Service</code>作为以下工厂：</span> </p>
<ul>
<li> <span>用于目标服务端点的代理。</span> </li>
<li> <span>实例<a href="../../../javax/xml/ws/Dispatch.html" title="javax.xml.ws中的接口"><code>Dispatch</code></a>用于远程操作的动态面向消息的调用。</span> </li>
</ul>
<p> <span>服务上可用的端口可以使用<code>getPorts</code>方法<code>getPorts</code> 。</span> <span>或者，您可以将服务端点接口传递到一元的<code>getPort</code>方法，并让运行时选择兼容的端口。</span> </p>
<p> <span>用于通过创建的所有对象处理程序链<code>Service</code>可以通过来设定<code>HandlerResolver</code> 。</span> </p>
<p> <span>可以在服务上设置<code>Executor</code> ，以便更好地控制用于分派异步回调的线程。</span> <span>例如，通过创建<code>ThreadPoolExecutor</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/spi/Provider.html" title="javax.xml.ws.spi中的类"><code>Provider</code></a> ， <a href="../../../javax/xml/ws/handler/HandlerResolver.html" title="javax.xml.ws.handler中的接口"><code>HandlerResolver</code></a> ， <a href="../../../java/util/concurrent/Executor.html" title="java.util.concurrent中的接口"><code>Executor</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/Service.Mode.html" title="enum in javax.xml.ws">Service.Mode</a></span></code>
<div class="block">
              动态客户端或服务的方向。 
            </div> </td>
</tr>
</tbody>
</table> </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="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/Service.html#Service-java.net.URL-javax.xml.namespace.QName-">Service</a></span>(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation, <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</code> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.html#Service-java.net.URL-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">Service</a></span>(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation, <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName, <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</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="t1"><span><a href="javascript:show(1);">静态方法</a></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>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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>static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.html#create-javax.xml.namespace.QName-">create</a></span>(<a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</code>
<div class="block">
              创建一个 
             <code>Service</code>实例。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.html#create-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">create</a></span>(<a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName, <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个 
             <code>Service</code>实例。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.html#create-java.net.URL-javax.xml.namespace.QName-">create</a></span>(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation, <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</code>
<div class="block">
              创建一个 
             <code>Service</code>实例。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.html#create-java.net.URL-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">create</a></span>(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation, <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName, <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</code>
<div class="block">
              创建一个 
             <code>Service</code>实例。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>&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/Service.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="i6">
<td class="colFirst"><code><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/Service.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="i7">
<td class="colFirst"><code>&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/Service.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="i8">
<td class="colFirst"><code>&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/Service.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="i9">
<td class="colFirst"><code><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/Service.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="i10">
<td class="colFirst"><code><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/Service.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="i11">
<td class="colFirst"><code><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/Service.html#getExecutor--">getExecutor</a></span>()</code>
<div class="block">
              返回此 
             <code>Service</code>实例的执行程序。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code><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/Service.html#getHandlerResolver--">getHandlerResolver</a></span>()</code>
<div class="block">
              返回配置的处理程序解析器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>&lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i14">
<td class="colFirst"><code>&lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i15">
<td class="colFirst"><code>&lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i16">
<td class="colFirst"><code>&lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i17">
<td class="colFirst"><code>&lt;T&gt; T</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i18">
<td class="colFirst"><code><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/Service.html#getPorts--">getPorts</a></span>()</code>
<div class="block">
              返回 
             <code>Iterator</code> ，用于 
             <code>QName</code>服务分组的服务端点QName的列表 
            </div> </td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code><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/Service.html#getServiceName--">getServiceName</a></span>()</code>
<div class="block">
              获取此服务的名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code><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/Service.html#getWSDLDocumentLocation--">getWSDLDocumentLocation</a></span>()</code>
<div class="block">
              获取此服务的WSDL文档的位置。 
            </div> </td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="i22">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/Service.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="Service-java.net.URL-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>Service</h4> <pre>protected Service(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation,
                  <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</pre> </li>
</ul> <a name="Service-java.net.URL-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>Service</h4> <pre>protected Service(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation,
                  <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName,
                  <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</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 &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 &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-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public &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 &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> - 要在代理上配置的WebServiceFeatures的列表。</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="getPort-javax.xml.ws.EndpointReference-java.lang.Class-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPort</h4> <pre>public &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运行时系统负责选择协议绑定（和端口），并从与该<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>返回的代理不应由客户机重新配置。</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="addPort-javax.xml.namespace.QName-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>addPort</h4> <pre>public 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> - 绑定的字符串标识符。 
           </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 &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>和<code>javax.activation.DataSource</code> ，这取决于所使用的绑定。</span>
</dd>
<dd>
<span><code>mode</code> - 控制创建的调度实例是消息还是有效负载，即客户端是否使用完整的协议消息或消息有效载荷。</span>
<span>例如，当使用SOAP协议时，此参数控制客户端是否使用SOAP消息或SOAP主体的内容。</span>
<span>当类型为SOAPMessage时，模式必须为MESSAGE。</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 &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 &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 <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 <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 <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>如果endpointReference中有<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 <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 <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>的服务端点列表 
           <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 <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 <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 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 <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="blockList">
<li class="blockList"> <h4>setExecutor</h4> <pre>public 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> <a name="create-java.net.URL-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create</h4> <pre>public static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a> create(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation,
                             <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</pre>
<div class="block">
<span>创建一个<code>Service</code>实例。</span>
<span>指定的WSDL文档位置和服务限定名必须唯一标识<code>wsdl:service</code>元素。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>wsdlDocumentLocation</code> - 
            <code>URL</code>为服务的WSDL文档位置 
           </dd>
<dd>
<code>serviceName</code> - 
            <code>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> - 创建指定服务时是否有任何错误。 
           </dd>
</dl> </li>
</ul> <a name="create-java.net.URL-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create</h4> <pre>public static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a> create(<a href="../../../java/net/URL.html" title="class in java.net">URL</a> wsdlDocumentLocation,
                             <a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName,
                             <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span>创建一个<code>Service</code>实例。</span>
<span>创建的实例配置了Web服务功能。</span>
<span>指定的WSDL文档位置和服务限定名称必须唯一标识<code>wsdl:service</code>元素。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>wsdlDocumentLocation</code> - 
            <code>URL</code> ，用于服务的WSDL文档位置 
           </dd>
<dd>
<code>serviceName</code> - 
            <code>QName</code>为服务 
           </dd>
<dd>
<span><code>features</code> - 必须在服务上配置的Web Service功能。</span>
<span>如果提供程序不了解某项功能，则必须抛出WebServiceException。</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> - 创建指定服务时是否有任何错误。 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.2 
           </dd>
</dl> </li>
</ul> <a name="create-javax.xml.namespace.QName-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>create</h4> <pre>public static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a> create(<a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName)</pre>
<div class="block">
            创建一个 
           <code>Service</code>实例。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>serviceName</code> - 
            <code>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> - 创建指定服务时是否有任何错误 
           </dd>
</dl> </li>
</ul> <a name="create-javax.xml.namespace.QName-javax.xml.ws.WebServiceFeature...-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>create</h4> <pre>public static <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a> create(<a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> serviceName,
                             <a href="../../../javax/xml/ws/WebServiceFeature.html" title="class in javax.xml.ws">WebServiceFeature</a>... features)</pre>
<div class="block">
<span>创建一个<code>Service</code>实例。</span>
<span>创建的实例配置了Web服务功能。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>serviceName</code> - 
            <code>QName</code>为服务 
           </dd>
<dd>
<span><code>features</code> - 必须在服务上配置的Web Service功能。</span>
<span>如果提供程序不了解某项功能，则必须抛出WebServiceException。</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> - 创建指定服务时是否有任何错误 
           </dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
             JAX-WS 2.2 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>