mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-16 23:57:30 +08:00
291 lines
16 KiB
HTML
291 lines
16 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.xml.ws
|
||
</div>
|
||
<h2 class="title" title="Class EndpointReference">Class EndpointReference</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.EndpointReference</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
已知直接子类：
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="javax.xml.ws.wsaddressing中的类">W3CEndpointReference</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">EndpointReference</span>
|
||
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
|
||
<div class="block">
|
||
<span>此类表示WS-Addressing EndpointReference，它是对Web服务端点的远程引用。</span>
|
||
<span>见<a href="http://www.w3.org/TR/2006/REC-ws-addr-core-20060509/">Web Services Addressing 1.0 - Core</a>对WS-Addressing的EndpointReferences更多信息。</span>
|
||
<p> <span>这个类是不可变的，因为典型的Web服务开发者不需要关心它的内容。</span> <span>Web服务开发人员应该严格使用此类作为引用远程Web服务端点的机制。</span> <span>请参阅客户端可以使用的<a href="../../../javax/xml/ws/Service.html" title="javax.xml.ws中的类"><code>Service</code></a> API，以利用<code>EndpointReference</code> 。</span> <span>见<a href="../../../javax/xml/ws/Endpoint.html" title="javax.xml.ws中的类"><code>Endpoint</code></a>和<a href="../../../javax/xml/ws/BindingProvider.html" title="javax.xml.ws中的接口"><code>BindingProvider</code></a>如何的API <code>EndpointReferences</code>可以发表端点创建。</span> </p>
|
||
<p> <span>这个类具体实现将代表一个<code>EndpointReference</code>为解决特定版本。</span> <span>例如， <a href="../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="javax.xml.ws.wsaddressing中的类"><code>W3CEndpointReference</code></a>用于W3C Web服务寻址1.0 - 核心推荐。</span> <span>如果JAX-WS实现者需要支持不同版本的解决，他们应该自己写<code>EndpointReference</code>子类，该版本。</span> <span>这将允许JAX-WS实现创建供应商特定的<code>EndpointReferences</code> ，供应商可以使用它来标记不同版本的寻址。</span> </p>
|
||
<p> <span>那些希望传递或返回Web服务开发人员<code>EndpointReference</code>在SEI在Java方法应该使用的具体事例<code>EndpointReference</code>如<code>W3CEndpointReference</code> 。</span> <span>这样，从SEI映射的模式将更多地描述正在传递的端点引用的类型。</span> </p>
|
||
<p> <span>JAX-WS实现者有望使用<code><a href="../../../javax/xml/ws/EndpointReference.html#writeTo-javax.xml.transform.Result-"><code>writeTo(javax.xml.transform.Result)</code></a></code>方法从<code>EndpointReferece</code>中提取XML信息集。</span> </p>
|
||
<p> <span>JAXB将绑定这个类到xs：anyType。</span> <span>如果需要更好的绑定，Web服务开发人员应该使用一个具体的子类，如<a href="../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="javax.xml.ws.wsaddressing中的类"><code>W3CEndpointReference</code></a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
JAX-WS 2.1
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/ws/wsaddressing/W3CEndpointReference.html" title="javax.xml.ws.wsaddressing中的类"><code>W3CEndpointReference</code></a> ， <a href="../../../javax/xml/ws/Service.html" title="javax.xml.ws中的类"><code>Service</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/EndpointReference.html#EndpointReference--">EndpointReference</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="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="t3"><span><a href="javascript:show(4);">抽象方法</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><T> T</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/EndpointReference.html#getPort-java.lang.Class-javax.xml.ws.WebServiceFeature...-">getPort</a></span>(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><T> 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="i1">
|
||
<td class="colFirst"><code>static <a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/EndpointReference.html#readFrom-javax.xml.transform.Source-">readFrom</a></span>(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> eprInfoset)</code>
|
||
<div class="block">
|
||
从eprInfoset中
|
||
<code>eprInfoset</code>的信息集读取EndpointReference的工厂方法。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/EndpointReference.html#toString--">toString</a></span>()</code>
|
||
<div class="block">
|
||
显示EPR信息，方便调试。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/EndpointReference.html#writeTo-javax.xml.transform.Result-">writeTo</a></span>(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)</code>
|
||
<div class="block">
|
||
将此
|
||
<code>EndpointReference</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#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="EndpointReference--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>EndpointReference</h4> <pre>protected EndpointReference()</pre> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="readFrom-javax.xml.transform.Source-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>readFrom</h4> <pre>public static <a href="../../../javax/xml/ws/EndpointReference.html" title="class in javax.xml.ws">EndpointReference</a> readFrom(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> eprInfoset)</pre>
|
||
<div class="block">
|
||
<span>从eprInfoset中<code>eprInfoset</code>的信息集读取EndpointReference的工厂方法。</span>
|
||
<span>该方法委托给供应商具体实现的<a href="../../../javax/xml/ws/spi/Provider.html#readEndpointReference-javax.xml.transform.Source-"><code>Provider.readEndpointReference(javax.xml.transform.Source)</code></a>方法。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>eprInfoset</code> -
|
||
<code>EndpointReference</code>信息将被解组
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
来自
|
||
<code>eprInfoset</code>从未
|
||
<code>null</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> - 如果从
|
||
<code>eprInfoset</code>创建
|
||
<code>EndpointReference</code>发生错误
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果给出了
|
||
<code>null</code>
|
||
<code>eprInfoset</code>值。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="writeTo-javax.xml.transform.Result-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>writeTo</h4> <pre>public abstract void writeTo(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)</pre>
|
||
<div class="block">
|
||
将此
|
||
<code>EndpointReference</code>写入指定的信息集格式
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>result</code> - 用于写入信息集
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/xml/ws/WebServiceException.html" title="class in javax.xml.ws">WebServiceException</a></code> -如果有错误写
|
||
<code>EndpointReference</code>到指定的
|
||
<code>result</code> 。
|
||
</dd>
|
||
<dd>
|
||
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果给出了
|
||
<code>null</code>
|
||
<code>result</code>价值。
|
||
</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 <T> T getPort(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><T> 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>EndpointReference</code>实例中有任何参考参数，那么这些引用参数必须在发送到端点的所有消息上显示为SOAP头，表示它们是参考参数。</span>
|
||
<span>参数<code>serviceEndpointInterface</code>指定返回的代理支持的服务端点接口。</span>
|
||
<span><code>EndpointReference</code>实例指定将由返回的代理调用的端点。</span>
|
||
<span>在此方法的实施中，JAX-WS运行时系统需要选择协议绑定（和端口），并从元数据WSDL从该相应地配置代理的责任<code>EndpointReference</code>或从注解的<code>serviceEndpointInterface</code> 。</span>
|
||
<span>对于成功返回代理的方法，WSDL元数据必须可用，并且<code>EndpointReference</code>实例必须包含一个理解为<code>serviceName</code>元数据的实现。</span>
|
||
<p> <span>因为此端口不是从<code>Service</code>对象创建的，所以处理程序不会自动配置，并且无法为该端口获取或设置<code>HandlerResolver</code>和<code>Executor</code> 。</span> <span><code>BindingProvider().getBinding().setHandlerChain()</code>方法可用于手动配置此端口的处理程序。</span> </p>
|
||
</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>
|
||
支持指定服务端点接口的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>无效</span> </li>
|
||
<li> <span>如果非法<code>serviceEndpointInterface</code>指定</span> </li>
|
||
<li> <span>如果启用了与该端口不兼容或不受支持的功能。</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="../../../javax/xml/ws/WebServiceFeature.html" title="javax.xml.ws中的类"><code>WebServiceFeature</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="toString--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
|
||
<div class="block">
|
||
显示EPR信息，方便调试。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/Object.html#toString--">toString</a></code>在
|
||
<code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
对象的字符串表示形式。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |