將片段步驟新增至 Java 批次工作

您可以將片段步驟新增至 Java™ 批次工作的 XML 檔。您可以讀取、處理及寫入片段步驟中的個別項目,也可以重新啟動片段步驟。

開始之前

完成下列作業:
  • 安裝適用於 WebSphere® Application Server Developer Tools for Eclipse 的 Java 批次特性。這是選用的特性。您可以從說明 > 安裝 WebSphere 軟體中安裝它。
  • 建立 Java 批次專案。
  • 在 Java 批次專案中建立 Java 批次工作。

關於這項作業

使用「工作規格語言 (JSL)」編輯器來建立片段步驟。您將實作片段步驟的讀取器節點和寫出器步驟。您可以選擇性地建立處理器節點來處理輸入項目。您也可以選擇性地將片段步驟設置為檢查點,以重新啟動它。

程序

  1. 在「工作規格語言 (JSL)」編輯器中,開啟 Java 批次工作的 XML 檔。

    如果您在建立 Java 批次工作時按一下完成,則會自動開啟 JSL 編輯器。JSL 編輯器中會顯示與批次工作同名的 XML 檔。

    如果您要將步驟新增至現有的 Java 批次工作 XML 檔,請完成下列步驟,在 JSL 編輯器中開啟 XML 檔:
    1. 在「企業瀏覽器」視圖中,選取您已建立的 Java 批次專案。
    2. 選取 src > META-INF > batch-jobs。
    3. 按兩下 Java 批次工作的 XML 檔。

      檔案會顯示在 JSL 編輯器中。

  2. 在概觀標籤上選取工作節點,按一下新增。
  3. 選取步驟,按一下確定。
  4. 選擇性的: 在詳細資料標籤的 ID* 欄位中變更 ID。
  5. 在概觀標籤上選取步驟節點,按一下新增。
  6. 選取片段,按一下確定。

    在 JSL 編輯器的「概觀」標籤上,片段節點會顯示成步驟的子項。讀取器節點和寫出器節點會顯示成片段節點的子項。

  7. 實作讀取器節點。
    1. 在「概觀」標籤上,按一下讀取器節點。

      這時會顯示讀取器節點的「詳細資料」標籤。

    2. 建立或加入讀取器類別來實作讀取器節點。

      您可以為專案建立讀取器類別、從專案內的另一個步驟加入讀取器類別,或從另一個專案中的片段步驟加入讀取器類別。請完成下列其中一項作業:

      • 建立片段步驟的讀取器類別。
        1. 在詳細資料標籤上按一下參照鏈結。

          這時會顯示「建立項目讀取器類別」精靈。

        2. 在 Java 套件欄位中,指定套件的名稱。
        3. 在類別名稱欄位中,指定類別的名稱。
        4. 選用項目:在超類別欄位中,指定超類別的名稱,或選取使用抽象 Java 批次類別作為超類別。
        5. 選用項目:在介面欄位中,新增要由類別實作的更多介面。
        6. 在批次構件載入選項中,接受預設值:使用類別的完整名稱。
          • 如果您選取使用類別的完整名稱選項,執行時期環境會將批次構件參照視為類別名稱,並透過執行緒環境定義類別載入器來載入參照。此載入動作是為了當保存檔載入器傳回此參照的空值時,能夠解析批次構件參照。
          • 如果您選取使用環境定義和相依關係注入 (CDI) 選項,執行時期環境會使用 CDI 實作特定的載入器,根據您指定的 Bean 名稱來解析批次構件參照。
          • 如果您選取將類別新增至 batch.xml 檔選項,執行時期環境會使用保存檔載入器,在 batch.xml 檔中尋找指定的 ID 來解析參照。
        7. 按一下完成。
      • 使用現有的讀取器類別來實作片段步驟。
        1. 在「詳細資料」標籤上按一下瀏覽。
        2. 選取搜尋類別,然後輸入類別名稱,依名稱來搜尋類別。
        3. 從相符的項目中選取類別名稱。
        4. 除了搜尋,如果 batch.xml 檔存在,也可以選取瀏覽 batch.xml 中的項目,然後從表格中選取其中一個項目。
        5. 按一下確定。
  8. 實作寫出器節點。
    1. 在「概觀」標籤上,按一下寫出器節點。

      這時會顯示寫出器節點的「詳細資料」標籤。

    2. 建立或加入寫出器類別來實作寫出器節點。
      您可以為專案建立寫出器類別、從專案內的另一個步驟加入寫出器類別,或從另一個專案中的片段步驟加入寫出器類別。請完成下列其中一項作業:
      • 建立片段步驟的寫出器類別。
        1. 在詳細資料標籤上按一下參照鏈結。

          這時會顯示「建立項目寫出器類別」精靈。

          以下關於「建立項目寫出器類別」精靈的說明,與「建立項目讀取器類別」精靈的說明相同。為了配合上下文而在此重複顯示資訊。

        2. 在 Java 套件欄位中,指定套件的名稱。
        3. 在類別名稱欄位中,指定類別的名稱。
        4. 選用項目:在超類別欄位中,指定超類別的名稱,或選取使用抽象 Java 批次類別作為超類別。
        5. 選用項目:在介面欄位中,新增要由類別實作的更多介面。
        6. 在批次構件載入選項中,接受預設值:使用類別的完整名稱。
          • 如果您選取使用類別的完整名稱選項,執行時期環境會將批次構件參照視為類別名稱,並透過執行緒環境定義類別載入器來載入參照。此載入動作是為了當保存檔載入器傳回此參照的空值時,能夠解析批次構件參照。
          • 如果您選取使用環境定義和相依關係注入 (CDI) 選項,執行時期環境會使用 CDI 實作特定的載入器,根據您指定的 Bean 名稱來解析批次構件參照。
          • 如果您選取將類別新增至 batch.xml 檔選項,執行時期環境會使用保存檔載入器,在 batch.xml 檔中尋找指定的 ID 來解析參照。
        7. 按一下完成。
      • 使用現有的寫出器類別來實作片段步驟。

        下列步驟與先前在讀取器類別中說明的步驟相同。為了配合上下文而在此重複顯示資訊。

        1. 在「詳細資料」標籤上按一下瀏覽。
        2. 選取搜尋類別,然後輸入類別名稱,依名稱來搜尋類別。
        3. 從相符的項目中選取類別名稱。
        4. 除了搜尋,如果 batch.xml 檔存在,也可以選取瀏覽 batch.xml 中的項目,然後從表格中選取其中一個項目。
        5. 按一下確定。
  9. 選擇性的: 實作片段節點的處理器節點。

    處理器節點用來處理片段步驟的輸入。

    1. 在概觀標籤上選取片段節點,按一下新增。
    2. 選取處理器,按一下確定。

      在 JSL 編輯器的「概觀」標籤上,處理器節點會顯示成片段節點的子項。

    3. 在詳細資料標籤上按一下參照鏈結。

      這時會顯示「建立項目處理器類別」精靈

      以下關於「建立項目處理器類別」精靈的說明,與「建立項目讀取器類別」精靈的說明相同。為了配合上下文而在此重複顯示資訊。

    4. 在 Java 套件欄位中,指定套件的名稱。
    5. 在類別名稱欄位中,指定類別的名稱。
    6. 選擇性的: 在超類別欄位中,指定超類別的名稱。
    7. 選擇性的: 在介面欄位中,新增要由類別實作的更多介面。
    8. 在批次構件載入選項中,接受預設值:使用類別的完整名稱。
      • 如果您選取使用類別的完整名稱選項,執行時期環境會將批次構件參照視為類別名稱,並透過執行緒環境定義類別載入器來載入參照。此載入動作是為了當保存檔載入器傳回此參照的空值時,能夠解析批次構件參照。
      • 如果您選取使用環境定義和相依關係注入 (CDI) 選項,執行時期環境會使用 CDI 實作特定的載入器,根據您指定的 Bean 名稱來解析批次構件參照。
      • 如果您選取將類別新增至 batch.xml 檔選項,執行時期環境會使用保存檔載入器,在 batch.xml 檔中尋找指定的 ID 來解析參照。
    9. 按一下完成。
  10. 選擇性的: 將片段節點設置為檢查點,讓您可以重新啟動節點。

    您可以在處理片段中指定的記錄數之後,或根據檢查點演算法,將片段節點設置為檢查點。

    1. 在處理片段中指定的記錄數之後將片段節點設置為檢查點。
      1. 為檢查點原則選取項目
      2. 提供項目數的值,以指定每個片段要處理的項目數。
      3. 提供時間限制的值,以指定設置檢查點之前經過的時間量。
    2. 根據檢查點演算法將節點設置為檢查點。
      1. 為檢查點原則選取自訂。
      2. 在「概觀」標籤上,按一下新增。
      3. 選取檢查點演算法,按一下確定。

        這時會顯示檢查點演算法的「詳細資料」標籤。

      4. 建立或加入檢查點演算法類別來實作檢查點演算法。
        您可以為片段步驟建立新的檢查點演算法類別、從專案內的另一個步驟加入檢查點演算法類別,或從另一個專案中的檢查點演算法步驟加入檢查點演算法類別。請完成下列其中一組步驟:
        • 建立檢查點演算法類別來實作檢查點演算法。
          1. 在詳細資料標籤上按一下參照鏈結。

            這時會顯示「建立檢查點演算法類別」精靈。

            以下關於「建立檢查點演算法類別」精靈的說明,與「建立項目讀取器類別」精靈的說明相同。為了配合上下文而在此重複顯示資訊。

          2. 在 Java 套件欄位中,指定套件的名稱。
          3. 在類別名稱欄位中,指定類別的名稱。
          4. 選用項目:在超類別欄位中,指定超類別的名稱。
          5. 選用項目:在介面欄位中,新增要由類別實作的更多介面。
          6. 在批次構件載入選項中,接受預設值:使用類別的完整名稱。
            • 如果您選取使用類別的完整名稱選項,執行時期環境會將批次構件參照視為類別名稱,並透過執行緒環境定義類別載入器來載入參照。此載入動作是為了當保存檔載入器傳回此參照的空值時,能夠解析批次構件參照。
            • 如果您選取使用環境定義和相依關係注入 (CDI) 選項,執行時期環境會使用 CDI 實作特定的載入器,根據您指定的 Bean 名稱來解析批次構件參照。
            • 如果您選取將類別新增至 batch.xml 檔選項,執行時期環境會使用保存檔載入器,在 batch.xml 檔中尋找指定的 ID 來解析參照。
          7. 按一下完成。
        • 使用現有的檢查點演算法類別來實作檢查點演算法。

          下列步驟與先前在讀取器類別中說明的步驟相同。為了配合上下文而在此重複顯示資訊。

          1. 在「詳細資料」標籤上按一下瀏覽。
          2. 選取搜尋類別,然後輸入類別名稱,依名稱來搜尋類別。
          3. 從相符的項目中選取類別名稱。
          4. 除了搜尋,如果 batch.xml 檔存在,也可以選取瀏覽 batch.xml 中的項目,然後從表格中選取其中一個項目。
          5. 按一下確定。
  11. 按一下完成。

結果

您已建立 Java 批次工作的片段步驟。您已實作讀取及寫入片段步驟的項目,並選擇性地實作處理輸入項目。您也可以選擇性地實作片段步驟的檢查點,讓您可以重新啟動步驟。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_add_chunk_step.html