JavaTM Platform
Standard Ed. 6

javax.jws
注释类型 WebService


@Retention(value=RUNTIME)
@Target(value=TYPE)
public @interface WebService

将 Java 类标记为实现 Web Service,或者将 Java 接口标记为定义 Web Service 接口。


可选元素摘要
 String endpointInterface
          定义服务抽象 Web Service 协定的服务端点接口的完整名称。
 String name
          Web Service 的名称。
 String portName
          Web Service 的端口名称。
 String serviceName
          Web Service 的服务名称。
 String targetNamespace
          如果 @WebService.targetNamespace 注释是关于某一服务端点接口的,则 targetNamespace 用于 wsdl:portType(以及关联的 XML 元素)的名称空间。
 String wsdlLocation
          描述服务的预定义 WSDL 的位置。
 

name

public abstract String name
Web Service 的名称。

当映射到 WSDL 1.1 时,该名称被用作 wsdl:portType 的名称。

默认值:
""

targetNamespace

public abstract String targetNamespace
如果 @WebService.targetNamespace 注释是关于某一服务端点接口的,则 targetNamespace 用于 wsdl:portType(以及关联的 XML 元素)的名称空间。

如果 @WebService.targetNamespace 注释是关于某个没有引用服务端点接口(通过 endpointInterface 属性)的服务实现 bean 的,则 targetNamespace 既可以用于 wsdl:portType 也可以用于 wsdl:service(以及关联的 XML 元素)。

如果 @WebService.targetNamespace 注释是关于某个引用服务端点接口(通过 endpointInterface 属性)的服务实现 bean 的,则 targetNamespace 仅用于 wsdl:service(以及关联的 XML 元素)。

默认值:
""

serviceName

public abstract String serviceName
Web Service 的服务名称。

当映射到 WSDL 1.1 时,此名称被用作 wsdl:service 的名称。

不允许在端点接口上使用此成员值。

默认值:
""

portName

public abstract String portName
Web Service 的端口名称。

当映射到 WSDL 1.1 时,此名称被用作 wsdl:port 的名称。

不允许在端点接口上使用此成员值。

从以下版本开始:
2.0
默认值:
""

wsdlLocation

public abstract String wsdlLocation
描述服务的预定义 WSDL 的位置。

wsdlLocation 是引用预先存在的 WSDL 文件的 URL(相对或绝对)。wsdlLocation 值的存在指示服务实现 bean 将实现预先定义的 WSDL 协定。如果服务实现 bean 与此 WSDL 中声明的 portType 和绑定不一致,则 JSR-181 工具必须提供反馈。注意,单个 WSDL 文件可能包含多个 portType 和多个绑定。服务实现 bean 上的注释确定对应于 Web Service 的特定 portType 和绑定。

默认值:
""

endpointInterface

public abstract String endpointInterface
定义服务抽象 Web Service 协定的服务端点接口的完整名称。

此注释允许开发人员将接口协定与实现分离。如果此注释存在,则使用服务端点接口来确定抽象 WSDL 协定(portType 和绑定)。服务端点接口可以包含用来定制 Java 到 WSDL 的映射关系的 JSR-181 注释。
服务实现 bean 可以实现服务端点接口,但并不要求这样做。
如果此成员值不存在,则 Web Service 协定是根据服务实现 bean 上的注释生成的。如果目标环境需要一个服务端点接口,则将生成一个由实现定义的包,该包具有由实现定义的名称。

不允许在端点接口上使用此成员值。

默认值:
""

JavaTM Platform
Standard Ed. 6

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

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