Java バッチ・ジョブへのチャンク・ステップの追加
Java™ バッチ・ジョブの XML ファイルにチャンク・ステップを追加できます。チャンク・ステップ内の個々の項目の読み取り、処理、書き込みのほか、チャンク・ステップの再開も実行できます。
始める前に
- WebSphere® Application Server Developer Tools for Eclipse の Java バッチ・フィーチャーをインストールします。このフィーチャーはオプションです。「ヘルプ」 > 「WebSphere ソフトウェアのインストール」からインストールできます。
- Java バッチ・プロジェクトを作成します。
- Java バッチ・プロジェクトで Java バッチ・ジョブを作成します。
このタスクについて
手順
- ジョブ定義言語 (JSL) エディターで、Java バッチ・ジョブの XML ファイルを開きます。
Java バッチ・ジョブを作成するときに「終了」をクリックすると、JSL エディターは自動的に開きます。バッチ・ジョブと同じ名前の XML ファイルが JSL エディターに表示されます。
既存の Java バッチ・ジョブの XML ファイルにステップを追加する場合は、以下のステップを実行して、XML ファイルを JSL エディターで開きます。- 「エンタープライズ・エクスプローラー」ビューで、作成した Java バッチ・プロジェクトを選択します。
- 「src」 > 「META-INF」 > 「batch-jobs」を選択します。
- Java バッチ・ジョブの XML ファイルをダブルクリックします。
ファイルが JSL エディターに表示されます。
- 「概要」タブでジョブ・ノードを選択して、「追加」をクリックします。
- 「ステップ」を選択して、「OK」をクリックします。
- オプション: 「詳細」タブの「ID*」フィールドの ID を変更します。
- 「概要」タブでステップ・ノードを選択して、「追加」をクリックします。
- 「チャンク」を選択して、「OK」をクリックします。
JSL エディターの「概要」タブに、チャンク・ノードがステップの子として表示されます。リーダー・ノードおよびライター・ノードはチャンク・ノードの子として表示されます。
- リーダー・ノードを実装します。
- 「概要」タブで、リーダー・ノードをクリックします。
リーダー・ノードの「詳細」タブが表示されます。
- リーダー・クラスを作成するか組み込み、リーダー・ノードを実装します。
プロジェクト用のリーダー・クラスを作成したり、プロジェクト内の別のステップからリーダー・クラスを組み込んだり、別のプロジェクト内のチャンク・ステップからリーダー・クラスを組み込んだりすることができます。以下のいずれかのタスクを実行します。
- チャンク・ステップ用のリーダー・クラスを作成します。
- 「詳細」タブの参照リンクをクリックします。
「項目リーダー・クラスの作成」ウィザードが表示されます。
- 「Java パッケージ」フィールドに、パッケージの名前を指定します。
- 「クラス名」フィールドに、クラスの名前を指定します。
- オプション: 「スーパークラス (Super class)」フィールドで、スーパークラスの名前を指定するか、「抽象 Java バッチ・クラスをスーパークラスとして使用します」を選択します。
- オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
- 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
- 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
- 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
- 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
- 「終了」をクリックします。
- 「詳細」タブの参照リンクをクリックします。
- 既存のリーダー・クラスを使用して、チャンク・ステップを実装します。
- 「詳細」タブで「参照」をクリックします。
- 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
- 「一致する項目」からクラス名を選択します。
- 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
- 「OK」をクリックします。
- チャンク・ステップ用のリーダー・クラスを作成します。
- 「概要」タブで、リーダー・ノードをクリックします。
- ライター・ノードを実装します。
- 「概要」タブで、ライター・ノードをクリックします。
ライター・ノードの「詳細」タブが表示されます。
- ライター・クラスを作成するか組み込み、ライター・ノードを実装します。 プロジェクト用のライター・クラスを作成したり、プロジェクト内の別のステップからライター・クラスを組み込んだり、別のプロジェクト内のチャンク・ステップからライター・クラスを組み込んだりすることができます。以下のいずれかのタスクを実行します。
- チャンク・ステップ用のライター・クラスを作成します。
- 「詳細」タブの参照リンクをクリックします。
「項目ライター・クラスの作成」ウィザードが表示されます。
「項目ライター・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。
- 「Java パッケージ」フィールドに、パッケージの名前を指定します。
- 「クラス名」フィールドに、クラスの名前を指定します。
- オプション: 「スーパークラス (Super class)」フィールドで、スーパークラスの名前を指定するか、「抽象 Java バッチ・クラスをスーパークラスとして使用します」を選択します。
- オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
- 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
- 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
- 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
- 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
- 「終了」をクリックします。
- 「詳細」タブの参照リンクをクリックします。
- 既存のライター・クラスを使用して、チャンク・ステップを実装します。
以下のステップは、先ほどリーダー・クラスについて説明したのと同じです。文脈上、ここでは同じ情報を繰り返します。
- 「詳細」タブで「参照」をクリックします。
- 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
- 「一致する項目」からクラス名を選択します。
- 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
- 「OK」をクリックします。
- チャンク・ステップ用のライター・クラスを作成します。
- 「概要」タブで、ライター・ノードをクリックします。
- オプション: チャンク・ノード用のプロセッサー・ノードを実装します。
プロセッサー・ノードは、チャンク・ステップへの入力を処理するために使用されます。
- 「概要」タブでチャンク・ノードを選択して、「追加」をクリックします。
- 「プロセッサー」を選択して、「OK」をクリックします。
JSL エディターの「概要」タブに、プロセッサー・ノードがチャンク・ノードの子として表示されます。
- 「詳細」タブの参照リンクをクリックします。
「項目プロセッサー・クラスの作成」ウィザードが表示されます。
「項目プロセッサー・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。
- 「Java パッケージ」フィールドに、パッケージの名前を指定します。
- 「クラス名」フィールドに、クラスの名前を指定します。
- オプション: 「スーパークラス (Super class)」フィールドに、スーパークラスの名前を指定します。
- オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
- 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
- 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
- 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
- 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
- 「終了」をクリックします。
- オプション: ノードを再始動できるように、チャンク・ノードのチェックポイントを指定します。
チャンク内の指定数のレコードの処理後に時点に、またはチェックポイント・アルゴリズムに従って、チャンク・ノードのチェックポイントを指定できます。
- チャンク内の指定数のレコードの処理後の時点に、チャンク・ノードのチェックポイントを指定します。
- チェックポイント・ポリシーの「項目」を選択します。
- 「項目カウント」に値を指定して、チャンクごとに処理する項目の数を指定します。
- 「時間制限」に値を指定して、チェックポイントが実行されるまでに経過する時間を指定します。
- チェックポイント・アルゴリズムに基づいて、ノードのチェックポイントを指定します。
- チェックポイント・ポリシーの「カスタム」を選択します。
- 「概要」タブで、「追加」をクリックします。
- 「チェックポイント・アルゴリズム」を選択して、「OK」をクリックします。
「チェックポイント・アルゴリズム」の「詳細」タブが表示されます。
- チェックポイント・アルゴリズム・クラスを作成するか組み込み、チェックポイント・アルゴリズムを実装します。チャンク・ステップ用の新規チェックポイント・アルゴリズム・クラスを作成したり、プロジェクト内の別のステップからチェックポイント・アルゴリズム・クラスを組み込んだり、別のプロジェクト内のチェックポイント・アルゴリズム・ステップからチェックポイント・アルゴリズム・クラスを組み込んだりすることができます。以下のいずれかのステップを実行します。
- チェックポイント・アルゴリズム・クラスを作成して、チェックポイント・アルゴリズムを実装します。
- 「詳細」タブの参照リンクをクリックします。
「チェックポイント・アルゴリズム・クラスの作成」ウィザードが表示されます。
「チェックポイント・アルゴリズム・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。
- 「Java パッケージ」フィールドに、パッケージの名前を指定します。
- 「クラス名」フィールドに、クラスの名前を指定します。
- オプション: 「スーパークラス (Super class)」フィールドに、スーパークラスの名前を指定します。
- オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
- 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
- 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
- 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
- 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
- 「終了」をクリックします。
- 「詳細」タブの参照リンクをクリックします。
- 既存のチェックポイント・アルゴリズム・クラスを使用して、チェックポイント・アルゴリズムを実装します。
以下のステップは、先ほどリーダー・クラスについて説明したのと同じです。文脈上、ここでは同じ情報を繰り返します。
- 「詳細」タブで「参照」をクリックします。
- 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
- 「一致する項目」からクラス名を選択します。
- 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
- 「OK」をクリックします。
- チェックポイント・アルゴリズム・クラスを作成して、チェックポイント・アルゴリズムを実装します。
- チャンク内の指定数のレコードの処理後の時点に、チャンク・ノードのチェックポイントを指定します。
- 「終了」をクリックします。