javax.xml.ws

Annotation Type WebServiceRef

@Target(value={TYPE,METHOD,FIELD})
 @Retention(value=RUNTIME)
 @Documented
public @interface WebServiceRef

的 WebServiceRef注释是用来定义一个引用一个Web服务和（可选）为其注入的目标。它可以用来注入服务和代理实例。这些注入的引用不是线程安全的。如果引用的是由多个线程访问，通常的同步技术可以用来支持多线程。

Web服务引用在java EE 5感资源。注释（例如，Addressing）注明元注释WebServiceFeatureAnnotation可结合使用WebServiceRef。创建的引用必须配置与注释的Web服务功能。

例如，在以下代码中，注入StockQuoteProvider代理必须WS-Addressing启用指定的Addressing注释。

    public class MyClient {
       @Addressing
       @WebServiceRef(StockQuoteService.class)
       private StockQuoteProvider stockQuoteProvider;
       ...
    }
 

如果遇到一个不支持JAX-WS实现或无法识别的标注有WebServiceFeatureAnnotation是指定WebServiceRef，错误必须给予。

从以下版本开始：

JAX-WS 2

另请参见：

Resource， WebServiceFeatureAnnotation

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	lookup 一种便携式JNDI查找名称解析到目标Web服务引用。
String	mappedName 该资源应该映射到的特定产品名称。
String	name 资源的JNDI名称。
类<?>	type 资源的java类型。
类<? extends Service>	value 服务类，alwiays类型扩展 javax.xml.ws.Service。
String	wsdlLocation 一个URL指向WSDL文件的Web服务。

Element Detail

name

public abstract String name

资源的JNDI名称。对于字段注释，默认是字段名称。方法注释，默认是JavaBeans属性名对应的方法。对于类注释，没有默认值，这必须指定。JNDI名称可以是绝对的（任何逻辑命名空间）或相对 java:comp/env JNDI命名空间。

Default:

“”

type

public abstract 类<?> type

资源的java类型。对于字段注释，默认是字段的类型。方法注释，默认是JavaBeans属性的类型。对于类注释，没有默认值，这必须指定。

Default:

java.lang.object.class

mappedName

public abstract String mappedName

该资源应该映射到的特定产品名称。该资源的名称，定义由 name元或违约，是出了名的地方使用资源的应用组件。（当一个相对的JNDI名称指定，那么它的JNDI java:comp/env命名空间。名字）许多应用服务器提供了一种方法来映射这些地方名称资源已知的应用程序服务器名称。这个映射的名称通常是一个全球的JNDI名称，但可以是任何形式的名字。

应用程序服务器不需要支持任何特定形式或类型的映射名称，也不需要使用映射名称的能力。映射的名称是依赖于产品的，并且经常依赖于安装。没有映射的名称的使用是便携式的。

Default:

“”

value

public abstract 类<? extends Service> value

服务类，alwiays类型扩展 javax.xml.ws.Service。当引用的类型是服务端点接口时，必须指定此元素。

Default:

javax.xml.ws.service.class

wsdlLocation

public abstract String wsdlLocation

一个URL指向WSDL文件的Web服务。如果没有指定，通过对资源的注释类型指定的WSDL位置代替。

Default:

“”

lookup

public abstract String lookup

一种便携式JNDI查找名称解析到目标Web服务引用。

从以下版本开始：

JAX-WS 2.2

Default:

“”