mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 15:52:45 +08:00
241 lines
11 KiB
HTML
241 lines
11 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.xml.ws
|
||
</div>
|
||
<h2 class="title" title="Annotation Type WebServiceRef">Annotation Type WebServiceRef</h2>
|
||
</div><div class="contentContainer">
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre><a href="../../../java/lang/annotation/Target.html" title="annotation in java.lang.annotation">@Target</a>(<a href="../../../java/lang/annotation/Target.html#value--">value</a>={<a href="../../../java/lang/annotation/ElementType.html#TYPE">TYPE</a>,<a href="../../../java/lang/annotation/ElementType.html#METHOD">METHOD</a>,<a href="../../../java/lang/annotation/ElementType.html#FIELD">字段</a>})
|
||
<a href="../../../java/lang/annotation/Retention.html" title="annotation in java.lang.annotation">@Retention</a>(<a href="../../../java/lang/annotation/Retention.html#value--">value</a>=<a href="../../../java/lang/annotation/RetentionPolicy.html#RUNTIME">RUNTIME</a>)
|
||
<a href="../../../java/lang/annotation/Documented.html" title="annotation in java.lang.annotation">@Documented</a>
|
||
public @interface <span class="memberNameLabel">WebServiceRef</span></pre>
|
||
<div class="block">
|
||
<span><code>WebServiceRef</code>注释用于定义对Web服务的引用，（可选）定义其注入目标。</span>
|
||
<span>它可以用于注入服务和代理实例。</span>
|
||
<span>这些注入的引用不是线程安全的。</span>
|
||
<span>如果引用由多个线程访问，则通常的同步技术可以用于支持多个线程。</span>
|
||
<p> <span>Web服务引用是Java EE 5意义上的资源。</span> <span>使用元注释<a href="../../../javax/xml/ws/spi/WebServiceFeatureAnnotation.html" title="javax.xml.ws.spi中的注释"><code>WebServiceFeatureAnnotation</code>注释</a>的注释（例如<a href="../../../javax/xml/ws/soap/Addressing.html" title="javax.xml.ws.soap中的注释"><code>Addressing</code></a> ）可以与WebServiceRef结合<code>WebServiceRef</code> 。</span> <span>创建的引用必须配置注释的Web服务功能。</span> </p>
|
||
<p> <span>例如，在下面的代码中，注入的<code>StockQuoteProvider</code>代理必须启用WS-Addressing，如<a href="../../../javax/xml/ws/soap/Addressing.html" title="javax.xml.ws.soap中的注释"><code>Addressing</code></a>注释所指定。</span> </p>
|
||
<pre> <span><code> public class MyClient { @Addressing @WebServiceRef(StockQuoteService.class) private StockQuoteProvider stockQuoteProvider; ... } </code></span> </pre>
|
||
<p> <span>如果JAX-WS实现遇到与注释不支持的或无法识别的注解<code>WebServiceFeatureAnnotation</code>一个与指定<code>WebServiceRef</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/annotation/Resource.html" title="javax.annotation中的注释"><code>Resource</code></a> ， <a href="../../../javax/xml/ws/spi/WebServiceFeatureAnnotation.html" title="javax.xml.ws.spi中的注释"><code>WebServiceFeatureAnnotation</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- =========== ANNOTATION TYPE OPTIONAL MEMBER SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="annotation.type.optional.element.summary">
|
||
<!-- --> </a> <h3>Optional Element Summary</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Optional Element Summary table, listing optional elements, and an explanation">
|
||
<caption>
|
||
<span>Optional Elements</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Optional Element and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code><a href="../../../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/WebServiceRef.html#lookup--">lookup</a></span></code>
|
||
<div class="block">
|
||
解析为目标Web服务引用的便携式JNDI查找名称。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/WebServiceRef.html#mappedName--">mappedName</a></span></code>
|
||
<div class="block">
|
||
该资源应映射到的产品特定名称。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/WebServiceRef.html#name--">name</a></span></code>
|
||
<div class="block">
|
||
资源的JNDI名称。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/WebServiceRef.html#type--">type</a></span></code>
|
||
<div class="block">
|
||
资源的Java类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code><a href="../../../java/lang/Class.html" title="class in java.lang">类</a><? extends <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/WebServiceRef.html#value--">value</a></span></code>
|
||
<div class="block">
|
||
服务类，一个类型扩展
|
||
<code>javax.xml.ws.Service</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/ws/WebServiceRef.html#wsdlLocation--">wsdlLocation</a></span></code>
|
||
<div class="block">
|
||
指向Web服务的WSDL文档的URL。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="details">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ============ ANNOTATION TYPE MEMBER DETAIL =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="annotation.type.element.detail">
|
||
<!-- --> </a> <h3>Element Detail</h3> <a name="name--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>name</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> name</pre>
|
||
<div class="block">
|
||
<span>资源的JNDI名称。</span>
|
||
<span>对于字段注释，默认值为字段名称。</span>
|
||
<span>对于方法注释，默认值为与该方法对应的JavaBeans属性名称。</span>
|
||
<span>对于类注释，没有默认值，必须指定。</span>
|
||
<span>JNDI名称可以是绝对的（具有任何逻辑命名空间）或相对于JNDI <code>java:comp/env</code>命名空间。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
“”
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="type--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>type</h4> <pre>public abstract <a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> type</pre>
|
||
<div class="block">
|
||
<span>资源的Java类型。</span>
|
||
<span>对于字段注释，默认是字段的类型。</span>
|
||
<span>对于方法注释，默认值是JavaBeans属性的类型。</span>
|
||
<span>对于类注释，没有默认值，必须指定。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
java.lang.Object.class
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="mappedName--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>mappedName</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> mappedName</pre>
|
||
<div class="block">
|
||
<span>该资源应映射到的产品特定名称。</span>
|
||
<span>该资源的名称由<code>name</code>元素或默认值定义，是使用该资源的应用程序组件本地的名称。</span>
|
||
<span>（当指定了相对的JNDI名称时，它是JNDI <code>java:comp/env</code>命名空间中的一个名称）许多应用程序服务器提供了一种将这些本地名称映射到应用程序服务器已知的资源名称的方法。</span>
|
||
<span>此映射名称通常是<i>全局</i> JNDI名称，但可以是任何形式的名称。</span>
|
||
<p> <span>应用程序服务器不需要支持任何特定形式或类型的映射名称，也不支持使用映射名称的功能。</span> <span>映射名称取决于产品，通常依赖于安装。</span> <span>不使用映射名称是可移植的。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
“”
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="value--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>value</h4> <pre>public abstract <a href="../../../java/lang/Class.html" title="class in java.lang">类</a><? extends <a href="../../../javax/xml/ws/Service.html" title="class in javax.xml.ws">Service</a>> value</pre>
|
||
<div class="block">
|
||
<span>服务类，一个类型扩展<code>javax.xml.ws.Service</code> 。</span>
|
||
<span>只要引用的类型是服务端点接口，必须指定此元素。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
javax.xml.ws.Service.class
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="wsdlLocation--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>wsdlLocation</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> wsdlLocation</pre>
|
||
<div class="block">
|
||
<span>指向Web服务的WSDL文档的URL。</span>
|
||
<span>如果未指定，则使用资源类型上的注释指定的WSDL位置。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
“”
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="lookup--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>lookup</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> lookup</pre>
|
||
<div class="block">
|
||
解析为目标Web服务引用的便携式JNDI查找名称。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
JAX-WS 2.2
|
||
</dd>
|
||
</dl>
|
||
<dl>
|
||
<dt>
|
||
Default:
|
||
</dt>
|
||
<dd>
|
||
“”
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |