使用 EJB2WebService 工具创建 Web Service

可以从命令行使用 EJB2WebService 工具来通过使用 IBM® WebSphere® 运行时环境从无状态会话 EJB bean 生成 Web service。注意:EJB2WebService13 命令支持 EJB V2.0 和 J2EE 1.3,而 EJB2WebService 命令支持 EJB 2.1 和 J2EE 1.4。

命令行设置

在使用 EJB2WebService 工具之前,必须设置 Web Service 命令行,如下所示:

  1. 从命令提示符切换至 Rational® Developer 产品的 bin 目录。
  2. 运行以下批处理脚本:
    • Windows®

      setupenv.bat

    • Linux:

      . setupenv.sh

  3. 切换至要创建 Web Service 的目录。我们将把此目录称为命令行测试目录。 Linux:必须具有对此目录的写访问权。

现在,可以使用 EJB2WebService 工具来创建具有导出的 EAR 文件的 Web Service 了。

创建 Web Service

注意:EJB2WebService 工具有两个版本。如果运行 EJB2WebService 命令,该命令将使用 J2EE 1.4。也可以使用 EJB2WebService13 命令,该命令将使用 J2EE 1.3。如果想要创建使用 J2EE 1.3 的 Web Service,则在下列任何命令中都可以用 EJB2WebService13 代替 EJB2WebService

要使用 EJB2WebService 工具来创建 Web Service,请在命令提示符处输入以下命令:

注意: <EJB.ear> 必须是最后一个自变量。请参阅 EJB2WebService 工具以获取可选自变量和必需自变量的列表。

提示:
  • 建议您指定可选自变量:-host <hostname:port>。命令的缺省端口是 6080,但是缺省 WebSphere Application Server 端口是 9080。
  • 请记录命令行测试目录路径和对 -project 指定的名称。您将需要此信息来部署和测试 Web Service。

示例

下面是如何使用 EJB2WebService 工具的示例:

EJB2WebService -host localhost:9080 -ri MyEJB.remoteInterface -project MyEJBProject MyEJB.ear

EJB2WebService 工具的主要输出是一个称为 <ProjectName>EAR.ear 的原始 EAR 文件的修改版本,它位于所生成的目录结构的根目录中。还在 <ProjectName> 下面生成 META-INF 目录。此目录存放所生成的 WSDL 文件和 Java™ 类等等。如果不指定 -server-side-only 自变量,则还将创建一个 client-side 目录,该目录包含一些额外的 Java 文件(包括用于复杂类型的序列化器和反序列化器类)。

一旦生成了 EAR 文件,就可以将其部署到服务器以供他人使用。

要点:如果选择使用 -splitWsdl 自变量,则将会生成 EAR 文件,但一旦将该文件导入工作空间并将它部署到“单元测试环境”或远程服务器,则在服务器启动时将会出现异常。此异常是由于路由器 Web 项目中缺少 WSDL 而引起的。要消除此错误,执行下列其中一种操作:
  • 使用“管理控制台”部署至独立的 WebSphere Application Server。
  • 使用整体式的 WSDL - 即,不使用 -splitWsdl 自变量。
  • 手工将 EJB 项目中 META-INF/wsdl 目录下的所有 WSDL 文件复制至路由器 Web 项目的 WEB-INF/wsdl
使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.