通过使用 IBM® WebSphere® 运行时环境,可以从命令行使用 Bean2WebService 工具来从 Java™ bean 生成 Web Service。
语法
一旦设置了命令行,就可以使用以下语法和自变量来运行此工具:
- Windows®:Bean2WebService
[<optional arguments>] -cp <Classpath> -project <ProjectName> <BeanName>
- Linux:Bean2WebService.sh [<optional arguments>] -cp
<Classpath> -project <ProjectName> <BeanName>
注: <BeanName> 必须是最后一个自变量。
自变量
必需自变量:
- -project <ProjectName>
- 指定项目名称。这用来在当前工作目录之下创建一个目录,生成的所有文件都将存储在这个目录中。
如果项目名称已存在,则将创建现有 EAR 文件的备份副本。例如,如果有称为 MyWebService 的项目,则 MyWebService.ear 文件将被重命名为 MyWebService.ear.backup。
- -cp <ClassPath>
- 指定 JAR 文件和目录的列表(JAR 文件和目录由特定于平台的路径定界字符分隔),此列表包含 Java bean 以及运行它所需的所有依赖项。
- <BeanName>
- 指定将作为 Web Service 公开的已编译 Java 类的标准包名。使用
- -g 选项来编译 Java 类,以使所生成的 WSDL 文件中的部件名属性包含方法的正确参数名。
可选自变量:
- -methods <method list>
- 指定要在 Web Service 中出现 Java bean 中的哪些公用非静态方法。缺省情况是包括所有这些方法。<method list> 中的方法必须由空格分隔。
- -clientType <J2SE | Application | Servlet | EJB>
- 为指定的客户机类型生成框架实现类。此自变量只能与
-genMain 自变量配合使用。如果已经指定了
-server-side-only 自变量,则不能使用此自变量。
- -genMain <name of main class>
- 指定要生成的 main 类的名称。此自变量只能与
-clientType 自变量配合使用。如果已经指定了
-server-side-only 自变量,则不能使用此自变量。
- -voidReturn [ONEWAY | TWOWAY]
- 指示您想要 void return 方法是请求/响应操作(缺省值)还是单向操作。
- -host <hostName:portNumber>
- 指定主机名和端口号。缺省值是 localhost:6080。
- -contextRoot <ContextRoot>
- 指定 Web Service 的上下文根。缺省值是 <ProjectName>。
- -servicePortName <PortName>
- 指定 Web Service 的端口名。缺省值是 Java bean 的名称。
使用自变量 -host、-contextRoot 和 -servicePortName 来指定服务端点的 URL。格式如下:http://HostName:PortNumber/<ContextRoot>/services/<PortName>
- -sei <endpoint interface>
- 指定预先编写的“服务端点接口”(Java 源代码文件)的标准路径名。如果不指定任何内容,则此工具在运行时动态地生成一个服务端点接口。
- -server-side-only
- 仅生成服务器端 helper 类。缺省情况是生成服务器端以及客户机端 helper 类。
- -clientEJBName <EJB client filename>
- 使用客户机 EJB 文件中的信息来配置带有客户机应用程序名称的客户机端
webservicesclient.xml 描述符。如果没有提供此选项,则必须手工编辑 webservicesclient.xml,然后才能将其添加至客户机 EJB 文件。
- -style <style type>
- 生成具有由 <style type> 指定的 RPC、Doc 或 Wrapped 样式的 WSDL。缺省样式是 Wrapped。
- -use <bindings>
- 生成具有由 <bindings> 指定的 literal 或 encoded 绑定的
WSDL。缺省值是 literal。
- -splitWsdl
- 生成未部署的单独接口和实现 WSDL 文档。缺省情况是创建一个既包含接口也包含实现信息的文档。
- - wsSecDir <directory>
- 指定包含模板的目录的完整路径以通过 WS-Security 信息来配置所生成的部署描述符。此目录必须包含 ibm-webservices-bnd.xmi 和
ibm-webservices-ext.xmi 文件,如果正在生成客户机端绑定的话,还应包含 ibm-webservicesclient-bnd.xmi 和
ibm-webservicesclient-ext.xmi。
- -PkgtoNS <package> <namespace>
- 指示 Java 包至名称空间的映射。如果发现包没有名称空间,则会生成合适的名称空间名称。可重复此自变量以指定多个包的映射。
- -verbose
- 在工具运行时显示额外的信息。
- -help
- 显示帮助信息。
注意:-deploy 选项不受支持。