创建存根命令
createEJBStubs 命令为 Java™ 归档 (JAR) 或企业归档 (EAR) 文件中打包的 Enterprise JavaBeans EJB V3.0 Bean 的远程接口创建存根类。它还提供了一个选项用来在位于目录或 JAR 文件中的接口类中创建单个存根类。提供了几个命令选项,用来以不同方式打包生成的存根类。请参阅本主题中后面的“语法和示例”部分以获取更多详细信息。
- createEJBStubs.bat - Windows 平台
- createEJBStubs.sh - 基于 Unix 的平台
- createEjbStubs - iSeries 平台
命令搜索输入的 JAR 或 EAR 文件,查找包含带有远程接口 Bean 的 EJB V3.0 模块。当找到远程接口时,生成相应的存根类,并按照指定的命令选项对其进行打包。当指定的输入是单一接口类时,工具假设此类是 EJB V3.0 远程接口类并生成远程存根类。
- Java Standard Edition (SE)“裸”客户机,其中 Java SE Java 虚拟机 (JVM) 是客户机环境。
- 版本早于 V7 或还未应用 EJB 3.0 功能包的 WebSphere Application Server 容器(Web 容器、EJB 容器或应用程序客户机容器)。
- 非 WebSphere Application Server 环境。
语法
createEJBStubs input_ class_ name | input_JAR_name | input_EAR_name [-help] [-newfile [new_file]] [-updatefile [update_file]] [-quiet] [-verbose] [-logfile log_file] [-appendlog] [-cp class_path] [-trace]- createEJBStubs
- 此命令为单一接口类文件、JAR 文件或 EAR 文件创建 EJB 存根类。当不使用任何自变量或只使用 -help 调用 createEJBStubs 命令时,此命令显示可以指定的选项列表,以及带有详细解释的调用示例列表。
- input_class_name 或 input_EAR_name 或 input_JAR_name
第一个参数是命令的必需元素。它必须包含要处理的源类、JAR 或 EAR 文件。
此参数可以是单一接口类的标准名称(例如 com.ibm.myRemoteInterface)。请注意,使用“.”字符分隔程序包名称段,类名称后不加路径名,而且不包括“.class”扩展名。对于此接口类输入,您必须使用类路径选项(例如-cp my_path, or -cp my_path/my_interfaces.jar)来指定查找接口类的位置。会将生成的存根类放置在包定义的目录结构中,开始是调用命令的当前目录。
此参数还可以是 JAR 或 EAR 文件。在这种情况下,必须指定路径(例如 my_path/my_Server_App.ear)。根据是否指定了 -updatefile 选项,生成的存根类将被放置在带 Bean 的相同单模块或多模块中,或者放置在带远程接口类的相同单模块或多模块中。此部分的后面包含了详细信息。
- -help
- 提供命令语法,包括可以指定的选项列表以及带有详细解释的调用示例列表。
- -newfile [new_file]
- 请求生成包含输入 JAR 或 EAR 中原有文件以及存根类的新文件。如果不指定此选项,那么将存根写回到原来的 JAR 或 EAR 文件中。如果指定了此选项但未提供 new_file 名称,那么通过在输入 JAR 或 EAR 文件名称后追加“_withStubs”来构造新文件名称。当第一个输入参数是接口类时,不允许使用此选项。
- -updatefile [update_file]
- 请求使用存根类更新的第二个文件(例如,除输入文件外的文件)。此选项还提供不同的打包行为。和远程接口类一样,将存根类打包在相同的单模块或多模块中。相反地,如果不指定此选项,那么在带有 Bean 类的相同单模块或多模块中打包存根类。如果指定了此选项但未提供 update_file 名称,那么只使用存根类更新原来的 JAR 或 EAR 文件。当第一个输入参数是接口类时,不允许使用此选项。
- -quiet
- 请求禁止消息。不能在指定 -verbose 或 -trace 选项的同时指定 -quiet 选项。仍显示错误消息。
- -verbose
- 要求输出更多参考消息。不能在指定 -quiet 或 -trace 选项的同时指定 -verbose 选项。
- -logfile log_file
- 要求将消息输出至日志文件及控制台。如果指定了此选项,那么还必须提供 log_file 名称。
- -appendlog
- 请求将消息追加到现有的日志文件。如果指定了此选项,那么还必须指定 -logfile 选项。
- -cp class_path
- 请求类装入器包含其他类或 jar 文件所在的指定类路径,这些类和文件是装入远程接口实例类所必需的。类路径可能包含多个段,其中每个路径与前一路径之间采用操作系统的缺省路径分隔符分隔。每个路径可以指定 JAR 文件或者目录。如果指定了此选项,那么还必须提供 class_path 名称。
- -trace
- 请求生成详细的跟踪输出。此选项的目的是收集 IBM® 服务使用的信息以解决问题。跟踪输出只采用英语。不能在指定 -quiet 或 -verbose 选项的同时指定该选项。
示例
createEJBStubs com.ibm.myRemoteInterface -cp my_path
生成一个远程接口类的存根类并将其放置在程序包定义的目录结构中,从当前目录位置开始。将使用 my_path 目录作为类路径。如果要处理的远程接口类位于 JAR 文件中,那么必须在类路径规范中使用 - cp my_path/my_interfaces.jar 语法。createEJBStubs my_path/my_beans.jar -newfile -quiet
在包含远程接口的 my_beans.jar 文件中生成所有级别的 3.0 企业 Bean 的存根类。因为 -newfile 选项中未指定 new_file 名称参数,所以生成的存根类和原来的 JAR 文件内容都将打包到名为 my_beans_withStubs.jar 的新 JAR 文件中。禁止除错误通知以外的输出消息。createEJBStubs my_path/my_Server_App.ear -logfile myLog.out
在包含远程接口的 my_Server_App.ear 文件中生成所有级别的 3.0 企业 Bean 的存根类。因为未指定 -newfile 选项,所以将生成的存根类将放置到原来的 EAR 文件中。因为未指定 -updatefile 选项,所以和 Bean 类一样将存根类打包到相同的单模块或多模块中。消息将写入 myLog.out 日志文件和命令窗口中。createEJBStubs my_path/my_Server_App.ear -updatefile my_path/my_Client_interfaces.jar
在包含远程接口的 my_Server_App.ear 文件中生成所有级别的 3.0 企业 Bean 的存根类。将生成的存根类放置在原来的 EAR 文件和 my_Client_interfaces.jar 文件中。因为指定了 -updatefile 选项,所以和远程接口类一样将存根类打包到相同的单模块或多模块中。createEJBStubs my_path/my_Server_App.ear -updatefile
在包含远程接口的 my_Server_App.ear 文件中生成所有级别的 3.0 企业 Bean 的存根类。因为 -updatefile 选项未提供可选的 update_file 名称参数,所以生成的存根类只放置在原来的 EAR 文件中。因为指定了 -updatefile 选项,所以和远程接口类一样将存根类打包到相同的单模块或多模块中。