JavaTM Platform
Standard Ed. 6

javax.xml.ws
注释类型 WebServiceRef


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

WebServiceRef 注释用于定义 Web 服务及其(可选)注入目标的引用。 对于 Java EE 5 来说 Web 服务引用属于资源。

从以下版本开始:
JAX-WS 2.0
另请参见:
Resource

可选元素摘要
 String mappedName
          此资源必须映射到的特定产品名称。
 String name
          资源的 JNDI 名称。
 Class type
          资源的 Java 类型。
 Class value
          服务类,总是扩展 javax.xml.ws.Service 的类型。
 String wsdlLocation
          指向 Web 服务 WSDL 文档的 URL。
 

name

public abstract String name
资源的 JNDI 名称。对于字段注释,默认为字段名称。对于方法注释,默认为与该方法相对应的 JavaBeans 属性名称。对于类注释,没有默认值,必须指定该项。

默认值:
""

type

public abstract Class type
资源的 Java 类型。对于字段注释,默认为字段的类型。对于方法注释,默认为 JavaBeans 属性的类型。对于类注释,没有默认值,必须指定该项。

默认值:
java.lang.Object.class

mappedName

public abstract String mappedName
此资源必须映射到的特定产品名称。此资源的名称(由 name 元素定义或默认)是使用该资源的应用程序组件的本地名称。(它的名称位于 JNDI java:comp/env 名称空间中。)许多应用程序服务器都提供一种方式将这些本地名称映射到应用程序服务器已知的资源名称。此映射的名称通常是全局 JNDI 名称,但是也可以是任何形式的名称。

应用程序服务器不需要支持任何特殊形式或映射名称的类型,也不需要具有使用映射名称的能力。映射的名称与产品有关,并且通常与安装有关。任何对映射名称的使用都不可移植。

默认值:
""

value

public abstract Class value
服务类,总是扩展 javax.xml.ws.Service 的类型。只要引用的类型是服务端点接口,就必须指定此元素。

默认值:
java.lang.Object.class

wsdlLocation

public abstract String wsdlLocation
指向 Web 服务 WSDL 文档的 URL。如果没有指定,则使用在资源类型上由注释指定的 WSDL 位置。

默认值:
""

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策