将区块步骤添加至 Java 批处理作业
您可以将区块步骤添加至 Java™ 批处理作业的 XML 文件。可以在区块步骤中读取、处理和写入各个项,并且还可以重新启动区块步骤。
开始之前
请完成下列任务:
- 为 WebSphere® Application Server Developer Tools for Eclipse 安装 Java 批处理功能部件。此功能部件是可选的。您可以从帮助 > 安装 WebSphere 软件来安装此功能部件。
- 创建一个 Java 批处理项目。
- 在该 Java 批处理项目中创建一个 Java 批处理作业。
关于此任务
过程
- 在作业规范语言 (JSL) 编辑器中,打开 Java 批处理作业的 XML 文件。
如果您在创建 Java 批处理作业时单击完成,那么 JSL 编辑器会自动打开。JSL 编辑器中会显示一个与批处理作业同名的 XML 文件。
如果您要将步骤添加至现有的 Java 批处理作业 XML 文件,请完成下列步骤,以便在 JSL 编辑器中打开该 XML 文件:- 在“企业资源管理器”视图中,选择您创建的 Java 批处理项目。
- 选择 src > META-INF > 批处理作业。
- 双击 Java 批处理作业的 XML 文件。
该文件将会显示在 JSL 编辑器中。
- 在概述选项卡上选择作业节点;单击添加。
- 选择步骤;单击确定。
- 可选: 更改详细信息选项卡的标识* 字段中的标识。
- 在概述选项卡上选择步骤节点;单击添加。
- 选择区块;单击确定。
在 JSL 编辑器的“概述”选项卡上,区块节点将显示为步骤的子代。读取器节点和写入器节点将显示为区块节点的子代。
- 实现读取器节点。
- 在“概述”选项卡上,单击读取器节点。
此时将会显示读取器节点的“详细信息”选项卡。
- 创建或包括一个用于实现读取器节点的读取器类。
您可以为项目创建读取器类,包括项目内的另一个步骤中的读取器类,或者包括另一个项目中的区块步骤中的读取器类。请完成下列其中一项任务:
- 为区块步骤创建读取器类。
- 在详细信息选项卡上单击引用链接。
此时将会显示“创建项读取器类”向导。
- 在 Java 包字段中,指定包的名称。
- 在类名字段中,指定类名。
- 可选:在超类字段中,指定超类的名称,或者选择使用抽象 Java 批处理类作为超类。
- 可选:在接口字段中,添加更多接口以供这个类实现。
- 对于批处理工件装入选项,请接受缺省值,即,使用类的标准名称。
- 如果您选择使用类的标准名称选项,那么运行时环境会将批处理工件引用视为类名,并通过线程上下文类装入器来装入该引用。进行装入是为了在归档装入器对批处理工件引用返回空值时解析该引用。
- 如果您选择使用上下文和依赖关系注入 (CDI) 选项,那么运行时环境会使用特定于 CDI 实现的装入器并通过使用您指定的 Bean 名称来解析批处理工件引用。
- 如果您选择将类添加至 batch.xml 文件选项,那么运行时环境会使用归档类装入器并通过在 batch.xml 文件中查找指定标识来解析引用。
- 单击完成。
- 在详细信息选项卡上单击引用链接。
- 使用现有的读取器类来实现区块步骤。
- 在“详细信息”选项卡上单击浏览。
- 通过选择搜索类并输入类名来按名称搜索类。
- 从匹配的项中选择类名。
- 搜索的替代方法是,如果 batch.xml 文件存在,请选择浏览 batch.xml 中的条目,然后从表中选择其中一个条目。
- 单击确定。
- 为区块步骤创建读取器类。
- 在“概述”选项卡上,单击读取器节点。
- 实现写入器节点。
- 在“概述”选项卡上,单击写入器节点。
此时将会显示写入器节点的“详细信息”选项卡。
- 创建或包括一个用于实现写入器节点的写入器类。 您可以为项目创建写入器类,包括项目内的另一个步骤中的写入器类,或者包括另一个项目中的区块步骤中的写入器类。请完成下列其中一项任务:
- 为区块步骤创建写入器类。
- 在详细信息选项卡上单击引用链接。
此时将会显示“创建项写入器类”向导。
下列关于“创建项写入器类”向导的描述与“创建项读取器类”向导的那些描述相同。在上下文中此处的信息重复。
- 在 Java 包字段中,指定包的名称。
- 在类名字段中,指定类名。
- 可选:在超类字段中,指定超类的名称,或者选择使用抽象 Java 批处理类作为超类。
- 可选:在接口字段中,添加更多接口以供这个类实现。
- 对于批处理工件装入选项,请接受缺省值,即,使用类的标准名称。
- 如果您选择使用类的标准名称选项,那么运行时环境会将批处理工件引用视为类名,并通过线程上下文类装入器来装入该引用。进行装入是为了在归档装入器对批处理工件引用返回空值时解析该引用。
- 如果您选择使用上下文和依赖关系注入 (CDI) 选项,那么运行时环境会使用特定于 CDI 实现的装入器并通过使用您指定的 Bean 名称来解析批处理工件引用。
- 如果您选择将类添加至 batch.xml 文件选项,那么运行时环境会使用归档类装入器并通过在 batch.xml 文件中查找指定标识来解析引用。
- 单击完成。
- 在详细信息选项卡上单击引用链接。
- 使用现有的写入器类来实现区块步骤。
下列步骤与前面的读取器类中描述的那些步骤相同。在上下文中此处的信息重复。
- 在“详细信息”选项卡上单击浏览。
- 通过选择搜索类并输入类名来按名称搜索类。
- 从匹配的项中选择类名。
- 搜索的替代方法是,如果 batch.xml 文件存在,请选择浏览 batch.xml 中的条目,然后从表中选择其中一个条目。
- 单击确定。
- 为区块步骤创建写入器类。
- 在“概述”选项卡上,单击写入器节点。
- 可选: 为区块节点实现处理器节点。
处理器节点用来处理区块步骤的输入。
- 在概述选项卡上选择区块节点;单击添加。
- 选择处理器;单击确定。
在 JSL 编辑器的“概述”选项卡上,处理器节点将显示为区块节点的子代。
- 在详细信息选项卡上单击引用链接。
此时将会显示“创建项处理器类”向导。
下列关于“创建项处理器类”向导的描述与“创建项读取器类”向导的那些描述相同。在上下文中此处的信息重复。
- 在 Java 包字段中,指定包的名称。
- 在类名字段中,指定类名。
- 可选: 在超类字段中,指定超类的名称。
- 可选: 在接口字段中,添加更多接口以供这个类实现。
- 对于批处理工件装入选项,请接受缺省值,即,使用类的标准名称。
- 如果您选择使用类的标准名称选项,那么运行时环境会将批处理工件引用视为类名,并通过线程上下文类装入器来装入该引用。进行装入是为了在归档装入器对批处理工件引用返回空值时解析该引用。
- 如果您选择使用上下文和依赖关系注入 (CDI) 选项,那么运行时环境会使用特定于 CDI 实现的装入器并通过使用您指定的 Bean 名称来解析批处理工件引用。
- 如果您选择将类添加至 batch.xml 文件选项,那么运行时环境会使用归档类装入器并通过在 batch.xml 文件中查找指定标识来解析引用。
- 单击完成。
- 可选: 对区块节点执行检查点操作,以便您可以重新启动该节点。
您可以在处理了区块中的指定记录数后或者根据检查点算法来对区块节点执行检查点操作。
- 在处理了区块中的指定记录数后对区块节点执行检查点操作。
- 针对检查点策略选择项。
- 通过为项计数提供值来指定每个区块要处理的项数。
- 通过为时间限制提供值来指定在执行检查点操作之前经过的时间长度。
- 根据检查点算法对节点执行检查点操作。
- 针对检查点策略选择定制。
- 在“概述”选项卡上,单击添加。
- 选择检查点算法;单击确定。
此时将会显示检查点算法的“详细信息”选项卡。
- 创建或包括一个用于实现检查点算法的检查点算法类。您可以为区块步骤创建新的检查点算法类,包括项目内的另一个步骤中的检查点算法类,或者包括另一个项目中的检查点算法步骤中的检查点算法类。请完成下列其中一组步骤:
- 创建一个用于实现检查点算法的检查点算法类。
- 在详细信息选项卡上单击引用链接。
此时将会显示“创建检查点算法类”向导。
下列关于“创建检查点算法类”向导的描述与“创建项读取器类”向导的那些描述相同。在上下文中此处的信息重复。
- 在 Java 包字段中,指定包的名称。
- 在类名字段中,指定类名。
- 可选:在超类字段中,指定超类的名称。
- 可选:在接口字段中,添加更多接口以供这个类实现。
- 对于批处理工件装入选项,请接受缺省值,即,使用类的标准名称。
- 如果您选择使用类的标准名称选项,那么运行时环境会将批处理工件引用视为类名,并通过线程上下文类装入器来装入该引用。进行装入是为了在归档装入器对批处理工件引用返回空值时解析该引用。
- 如果您选择使用上下文和依赖关系注入 (CDI) 选项,那么运行时环境会使用特定于 CDI 实现的装入器并通过使用您指定的 Bean 名称来解析批处理工件引用。
- 如果您选择将类添加至 batch.xml 文件选项,那么运行时环境会使用归档类装入器并通过在 batch.xml 文件中查找指定标识来解析引用。
- 单击完成。
- 在详细信息选项卡上单击引用链接。
- 使用现有的检查点算法类来实现检查点算法。
下列步骤与前面的读取器类中描述的那些步骤相同。在上下文中此处的信息重复。
- 在“详细信息”选项卡上单击浏览。
- 通过选择搜索类并输入类名来按名称搜索类。
- 从匹配的项中选择类名。
- 搜索的替代方法是,如果 batch.xml 文件存在,请选择浏览 batch.xml 中的条目,然后从表中选择其中一个条目。
- 单击确定。
- 创建一个用于实现检查点算法的检查点算法类。
- 在处理了区块中的指定记录数后对区块节点执行检查点操作。
- 单击完成。