在 Apache Geronimo 应用程序中实现和部署 Web 服务

核心提示： 一个 Web Service Definition Language（Web 服务定义语言，WSDL）文档，在 Apache Geronimo 应用程序中实现和部署 Web 服务(2)，描述服务接口和端口，一个服务端点接口，这个接口是 EJB 的远程接口，但是用 java.rmi.Remote

一个 Web Service Definition Language（Web 服务定义语言，WSDL）文档，描述服务接口和端口。

一个服务端点接口，它由服务器部分实现，用于在客户机上调用服务方法。来自 WSDL 的绑定映射到这个端点接口，WSDL 绑定是 WSDL 的一部分，定义了 Web 服务的协议。

Java API for XML-based RPC（JAX-RPC）描述符，包含从 XML 到 Java 技术的不同映射，比如将来自 WSDL 文档的 XML Schema Definition（XSD）类型映射到 Java 类型，以及将 XML 元素映射到端点接口方法参数。

服务实现 —— EJB 或 servlet。

Web 服务部署描述符 webservices.xml。

以下几节开发这些工件，为 Geronimo 构建一个支持 Web 服务的应用程序。

创建 Web 服务

首先，开发 Web 服务本身。为此，必须在同一个文件夹中创建以下工件。（稍后给出每个步骤的细节。）

生成或开发 WSDL。在这个例子中，使用来自 Sun J2EE 参考实现的 wscompile 工具。

开发端点接口。它是基于 EJB 远程接口开发的。

用 JAX-RPC 映射将 WSDL 类型映射为 Java 类型。JAX-RPC 映射是使用 wscompile 工具生成的。

实现端点接口。

在部署描述符中配置 Web 服务引用。这包括在 web.xml 部署描述符中添加一节。

下面详细描述每个步骤。

第一个步骤是在 WSDL 文件中描述 Web 服务。在这个例子中，因为 Web 服务提供的功能与业务逻辑 EJB 相同，所以可以从 EJB 接口生成 WSDL，然后进行手工编辑。[注意，到编写本文时，Geronimo 对于构建 J2EE Web 服务还没有完善的工具支持（Axis 特定的 Web 服务例外，这种 Web 服务可以使用 Axis 工具生成]。

要从端点接口生成 WSDL，必须先开发一个接口。这个接口声明 Web 服务实现的方法。JAX-RPC 规范对这个接口有一些限制。简单地说，这个接口应该扩展 java.rmi.Remote —— 所有方法都声明为抛出 java.rmi.RemoteException。最后，参数和返回值是 JAX-RPC 兼容的（在我们的例子中，它们是具有默认构造函数的 JavaBean 和原始类型）。简单地说，在示例应用程序中，这个接口是 EJB 的远程接口，但是用 java.rmi.Remote 替换了父接口 javax.ejb.EJBObject，并删除了调用者名称参数。