Java バッチ・ジョブへのチャンク・ステップの追加

Java™ バッチ・ジョブの XML ファイルにチャンク・ステップを追加できます。チャンク・ステップ内の個々の項目の読み取り、処理、書き込みのほか、チャンク・ステップの再開も実行できます。

始める前に

以下のタスクを実行します。
  • WebSphere® Application Server Developer Tools for Eclipse の Java バッチ・フィーチャーをインストールします。このフィーチャーはオプションです。「ヘルプ」 > 「WebSphere ソフトウェアのインストール」からインストールできます。
  • Java バッチ・プロジェクトを作成します。
  • Java バッチ・プロジェクトで Java バッチ・ジョブを作成します。

このタスクについて

ジョブ定義言語 (JSL) エディターを使用して、チャンク・ステップを作成します。チャンク・ステップのリーダー・ノードとライター・ノードを実装します。オプションで、入力項目を処理するためのプロセッサー・ノードを作成できます。また、オプションで、チャンク・ステップを再開するチェックポイントを指定できます。

手順

  1. ジョブ定義言語 (JSL) エディターで、Java バッチ・ジョブの XML ファイルを開きます。

    Java バッチ・ジョブを作成するときに「終了」をクリックすると、JSL エディターは自動的に開きます。バッチ・ジョブと同じ名前の XML ファイルが JSL エディターに表示されます。

    既存の Java バッチ・ジョブの XML ファイルにステップを追加する場合は、以下のステップを実行して、XML ファイルを JSL エディターで開きます。
    1. 「エンタープライズ・エクスプローラー」ビューで、作成した Java バッチ・プロジェクトを選択します。
    2. 「src」 > 「META-INF」 > 「batch-jobs」を選択します。
    3. Java バッチ・ジョブの XML ファイルをダブルクリックします。

      ファイルが JSL エディターに表示されます。

  2. 「概要」タブでジョブ・ノードを選択して、「追加」をクリックします。
  3. 「ステップ」を選択して、「OK」をクリックします。
  4. オプション: 「詳細」タブの「ID*」フィールドの ID を変更します。
  5. 「概要」タブでステップ・ノードを選択して、「追加」をクリックします。
  6. 「チャンク」を選択して、「OK」をクリックします。

    JSL エディターの「概要」タブに、チャンク・ノードがステップの子として表示されます。リーダー・ノードおよびライター・ノードはチャンク・ノードの子として表示されます。

  7. リーダー・ノードを実装します。
    1. 「概要」タブで、リーダー・ノードをクリックします。

      リーダー・ノードの「詳細」タブが表示されます。

    2. リーダー・クラスを作成するか組み込み、リーダー・ノードを実装します。

      プロジェクト用のリーダー・クラスを作成したり、プロジェクト内の別のステップからリーダー・クラスを組み込んだり、別のプロジェクト内のチャンク・ステップからリーダー・クラスを組み込んだりすることができます。以下のいずれかのタスクを実行します。

      • チャンク・ステップ用のリーダー・クラスを作成します。
        1. 「詳細」タブの参照リンクをクリックします。

          「項目リーダー・クラスの作成」ウィザードが表示されます。

        2. 「Java パッケージ」フィールドに、パッケージの名前を指定します。
        3. 「クラス名」フィールドに、クラスの名前を指定します。
        4. オプション: 「スーパークラス (Super class)」フィールドで、スーパークラスの名前を指定するか、「抽象 Java バッチ・クラスをスーパークラスとして使用します」を選択します。
        5. オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
        6. 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
          • 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
          • 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
          • 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
        7. 「終了」をクリックします。
      • 既存のリーダー・クラスを使用して、チャンク・ステップを実装します。
        1. 「詳細」タブで「参照」をクリックします。
        2. 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
        3. 「一致する項目」からクラス名を選択します。
        4. 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
        5. 「OK」をクリックします。
  8. ライター・ノードを実装します。
    1. 「概要」タブで、ライター・ノードをクリックします。

      ライター・ノードの「詳細」タブが表示されます。

    2. ライター・クラスを作成するか組み込み、ライター・ノードを実装します。
      プロジェクト用のライター・クラスを作成したり、プロジェクト内の別のステップからライター・クラスを組み込んだり、別のプロジェクト内のチャンク・ステップからライター・クラスを組み込んだりすることができます。以下のいずれかのタスクを実行します。
      • チャンク・ステップ用のライター・クラスを作成します。
        1. 「詳細」タブの参照リンクをクリックします。

          「項目ライター・クラスの作成」ウィザードが表示されます。

          「項目ライター・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。

        2. 「Java パッケージ」フィールドに、パッケージの名前を指定します。
        3. 「クラス名」フィールドに、クラスの名前を指定します。
        4. オプション: 「スーパークラス (Super class)」フィールドで、スーパークラスの名前を指定するか、「抽象 Java バッチ・クラスをスーパークラスとして使用します」を選択します。
        5. オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
        6. 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
          • 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
          • 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
          • 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
        7. 「終了」をクリックします。
      • 既存のライター・クラスを使用して、チャンク・ステップを実装します。

        以下のステップは、先ほどリーダー・クラスについて説明したのと同じです。文脈上、ここでは同じ情報を繰り返します。

        1. 「詳細」タブで「参照」をクリックします。
        2. 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
        3. 「一致する項目」からクラス名を選択します。
        4. 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
        5. 「OK」をクリックします。
  9. オプション: チャンク・ノード用のプロセッサー・ノードを実装します。

    プロセッサー・ノードは、チャンク・ステップへの入力を処理するために使用されます。

    1. 「概要」タブでチャンク・ノードを選択して、「追加」をクリックします。
    2. 「プロセッサー」を選択して、「OK」をクリックします。

      JSL エディターの「概要」タブに、プロセッサー・ノードがチャンク・ノードの子として表示されます。

    3. 「詳細」タブの参照リンクをクリックします。

      「項目プロセッサー・クラスの作成」ウィザードが表示されます。

      「項目プロセッサー・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。

    4. 「Java パッケージ」フィールドに、パッケージの名前を指定します。
    5. 「クラス名」フィールドに、クラスの名前を指定します。
    6. オプション: 「スーパークラス (Super class)」フィールドに、スーパークラスの名前を指定します。
    7. オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
    8. 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
      • 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
      • 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
      • 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
    9. 「終了」をクリックします。
  10. オプション: ノードを再始動できるように、チャンク・ノードのチェックポイントを指定します。

    チャンク内の指定数のレコードの処理後に時点に、またはチェックポイント・アルゴリズムに従って、チャンク・ノードのチェックポイントを指定できます。

    1. チャンク内の指定数のレコードの処理後の時点に、チャンク・ノードのチェックポイントを指定します。
      1. チェックポイント・ポリシーの「項目」を選択します。
      2. 「項目カウント」に値を指定して、チャンクごとに処理する項目の数を指定します。
      3. 「時間制限」に値を指定して、チェックポイントが実行されるまでに経過する時間を指定します。
    2. チェックポイント・アルゴリズムに基づいて、ノードのチェックポイントを指定します。
      1. チェックポイント・ポリシーの「カスタム」を選択します。
      2. 「概要」タブで、「追加」をクリックします。
      3. 「チェックポイント・アルゴリズム」を選択して、「OK」をクリックします。

        「チェックポイント・アルゴリズム」の「詳細」タブが表示されます。

      4. チェックポイント・アルゴリズム・クラスを作成するか組み込み、チェックポイント・アルゴリズムを実装します。
        チャンク・ステップ用の新規チェックポイント・アルゴリズム・クラスを作成したり、プロジェクト内の別のステップからチェックポイント・アルゴリズム・クラスを組み込んだり、別のプロジェクト内のチェックポイント・アルゴリズム・ステップからチェックポイント・アルゴリズム・クラスを組み込んだりすることができます。以下のいずれかのステップを実行します。
        • チェックポイント・アルゴリズム・クラスを作成して、チェックポイント・アルゴリズムを実装します。
          1. 「詳細」タブの参照リンクをクリックします。

            「チェックポイント・アルゴリズム・クラスの作成」ウィザードが表示されます。

            「チェックポイント・アルゴリズム・クラスの作成」ウィザードに関する以下の説明は、「項目リーダー・クラスの作成」ウィザードについての説明と同じです。文脈上、ここでは同じ情報を繰り返します。

          2. 「Java パッケージ」フィールドに、パッケージの名前を指定します。
          3. 「クラス名」フィールドに、クラスの名前を指定します。
          4. オプション: 「スーパークラス (Super class)」フィールドに、スーパークラスの名前を指定します。
          5. オプション: 「インターフェース」フィールドで、実装するクラスのインターフェースをさらに追加します。
          6. 「バッチ成果物ロード・オプション」については、「クラスの完全修飾名を使用」のデフォルト値を受け入れます。
            • 「クラスの完全修飾名を使用」オプションを選択すると、ランタイム環境は、バッチ成果物参照をクラス名として扱い、スレッド・コンテキスト・クラス・ローダーを介して参照をロードします。アーカイブ・ローダーがこの参照について NULL を返した場合に、バッチ成果物参照を解決するために、ロードが行われます。
            • 「Context and Dependency Injection (CDI) を使用」オプションを選択すると、ランタイム環境は、指定された Bean 名を使用してバッチ成果物参照を解決するために、CDI 実装固有のローダーを使用します。
            • 「クラスを batch.xml ファイルに追加」オプションを選択すると、ランタイム環境は、batch.xml ファイルに指定された ID を検索して参照を解決するために、アーカイブ・ローダーを使用します。
          7. 「終了」をクリックします。
        • 既存のチェックポイント・アルゴリズム・クラスを使用して、チェックポイント・アルゴリズムを実装します。

          以下のステップは、先ほどリーダー・クラスについて説明したのと同じです。文脈上、ここでは同じ情報を繰り返します。

          1. 「詳細」タブで「参照」をクリックします。
          2. 「クラスの検索」を選択してクラス名を入力し、名前でクラスを検索します。
          3. 「一致する項目」からクラス名を選択します。
          4. 検索に代わる手段として、batch.xml ファイルが存在する場合は、「batch.xml の項目の参照」を選択して、表から項目の 1 つを選択します。
          5. 「OK」をクリックします。
  11. 「終了」をクリックします。

タスクの結果

これで、Java バッチ・ジョブ用のチャンク・ステップが作成されました。チャンク・ステップの項目の読み取りと書き込みを実装し、オプションとして入力項目の処理を実装しました。また、オプションで、ステップを再開できるように、チャンク・ステップのチェックポイントを実装しました。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_add_chunk_step.html