Java™ API for XML-Based Web Services (JAX-WS) 是下一代 Web Service 编程模型。通过 JAX-WS,并使用动态代理和 Java 注释,借助于 Java 应用程序的更不依赖于平台的特征,简化 Web Service 和客户机的开发。
启用 WebSphere JAX-WS 运行时环境
您可以创建自顶向下或自底向上 Java Web Service 和客户机。使用 JAX-WS 运行时环境的 EJB Web Service 生成仅受 WebSphere® Application Server V7.0 及更高版本和 WebSphere Application Server Liberty 概要文件 V8.5.5 及更高版本支持。
缺省情况下,在 WebSphere Application Server V7.0 及更高版本中已启用 JAX-WS 运行时。创建 Web 项目时,只要选择您的 WebSphere Application Server 版本的缺省配置,就将选择正确的构面。
JAX-WS Web Service 工件
JAX-WS Web Service 包含在 Web 归档 (WAR) 文件内或企业归档 (EAR) 文件中的 WAR 模块内。支持 JAX-WS 的 WAR 文件包括:
- WEB-INF/web.xml 文件。
- web.xml 不含 Servlet 或 Servlet 映射元素。WebSphere Application Server 运行时会在装入模块时动态地定义它们。
- 带注释的类,用于实现应用程序模块中包含的 Web Service。
- 带注释的类必须至少包含一个包括 @javax.jws.WebService 注释的 Web Service 实现类。与 Web Service 相关的注释的定义和规范由
JAX-WS 和 JSR-181 规范提供。Web Service 实现类可以存在于 WEB-INF/classes 目录中,也可以存在于 WAR 文件的 WEB-INF/lib 目录中包含的 Java 归档 (JAR) 文件中。
- (可选)Web 服务描述语言 (WSDL) 文档,用于描述包含在应用程序模块中的 Web Service。
- 可选择在 JAX-WS 应用程序封装中包括 WSDL 文档。如果省略特定 Web Service 的 WSDL 文档,那么 WebSphere Application Server 运行时环境时将根据
Web Service 实现类中包含的注释动态构造 WSDL 定义。如果省略 WSDL 文档,那么必须包括 @javax.jws.WebService 注释并可以选择包括 @WebMethod、@WebParam、@WebResult 和 @SOAPBinding 注释。