EJB2WebService 工具参考

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

语法

一旦设置了命令行,就可以使用以下语法和自变量来运行此工具:

注意: <EJB.ear> 必须是最后一个自变量。

自变量

必需自变量:

-project
指定项目名称。这用来在当前工作目录之下创建一个目录,生成的所有文件都将存储在这个目录中。 如果项目名称已存在,则将创建现有 EAR 文件的备份副本。例如,如果有称为 MyWebService 的项目,则 MyWebService.ear 文件将被重命名为 MyWebService.ear.backup。
-ri
指定企业 bean 的远程接口的名称。这必须是标准包名,例如,com.ibm.wsdk.testing.TestBeanRemote。
<EJB.ear>
指定现有 EAR 文件的标准路径名。此文件包含至少一个 EJB 模块 JAR 文件。使用 -g 选项来编译 EJB 类,以使所生成的 WSDL 文件中的部件名属性包含方法的正确参数名。

可选自变量:

-methods <method list>
指定要在 Web Service 中出现企业 bean 中的哪些公用非静态方法。缺省情况是包括所有这些方法。<method list> 中的方法必须由空格分隔。
-clientType <J2SE | Application | Servlet | EJB>
为指定的客户机类型生成框架实现类。此自变量只能与 -genMain 自变量配合使用。如果已经指定了 -server-side-only 自变量,则不能使用此自变量。
-genMain <name of main class>
指定要生成的 main 类的名称。此自变量只能与 -clientType 自变量配合使用。如果已经指定了 -server-side-only 自变量,则不能使用此自变量。
-host <hostName:portNumber>
指定主机名和端口号。缺省值是 localhost:6080
-contextRoot <ContextRoot>
指定 Web Service 的上下文根。此项的缺省值是 <ProjectName>。
-servicePortName <PortName>
指定 Web Service 的端口名。此项的缺省值是 EJB bean 的名称。

使用自变量 -host-contextRoot-servicePortName 来指定服务端点的 URL。格式如下:http://hostName:portNumber/<ContextRoot>/services/<PortName>。

-sei <interface.java>
指定预先编写的“服务端点接口”(Java™ 源代码文件)的标准路径名。如果未指定路径名,则此工具在运行时动态地生成一个服务端点接口。
-server-side-only
仅生成服务器端 helper 类。缺省情况是生成服务器端以及客户机端 helper 类。
-clientEJBName <EJB client filename>
使用客户机 EJB 文件中的信息来配置带有客户机应用程序名称的客户机端 webservicesclient.xml 描述符。如果没有提供此自变量,则必须手工编辑 webservicesclient.xml,然后才能将其添加至客户机 EJB 文件。
-style <style type>
生成具有由 <style type> 指定的 rpcdocwrapped 样式的 WSDL。缺省样式是 Wrapped
-use <bindings>
生成具有由 <bindings> 指定的 literalencoded 绑定的 WSDL。缺省值是 literal
-splitWsdl
生成未部署的单独接口和实现 WSDL 文档。缺省情况是创建一个既包含接口也包含实现信息的文档。
要点:如果选择使用此自变量,则将会生成 EAR 文件,但一旦将它导入到工作空间中并将它部署至“单元测试环境”或远程服务器,在服务器启动期间就会发生异常。此异常是由于路由器 Web 项目中缺少 WSDL 而引起的。要消除此错误,执行下列其中一种操作:
  • 使用“管理控制台”部署至独立的 WebSphere Application Server。
  • 使用整体式的 WSDL - 即,不使用 -splitWsdl 自变量。
  • 手工将 EJB 项目中 META-INF/wsdl 目录下的所有 WSDL 文件复制至路由器 Web 项目的 WEB-INF/wsdl
- wsSecDir <directory>
指定包含模板的目录的完整路径以通过 WS-Security 信息来配置所生成的部署描述符。此目录必须包含 ibm-webservices-bnd.xmiibm-webservices-ext.xmi 文件,如果正在生成客户机端绑定的话,还应包含 ibm-webservicesclient-bnd.xmiibm-webservicesclient-ext.xmi
-PkgtoNS <package> <namespace>
指示 Java 包至名称空间的映射。如果发现包没有名称空间,则会生成合适的名称空间名称。可重复此自变量以指定多个包的映射。
-voidReturn [ONEWAY | TWOWAY]
指示您想要 void return 方法是请求/响应操作(缺省值)还是单向操作。
-verbose
在工具运行时显示额外的信息。
-help
显示帮助信息。

注意:-deploy 选项不受支持。

父主题: 使用 EJB2WebService 工具创建 Web Service

相关任务
使用 EJB2WebService 工具创建 Web Service

相关参考
Java2WSDL 工具参考

使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.