Einem Java-Stapeljob einen Chunkabschnitt hinzufügen
Sie können der XML-Datei eines Java™-Stapeljobs einen Chunkabschnitt hinzufügen. Sie können einzelne Elemente im Chunkabschnitt lesen, verarbeiten und schreiben und außerdem den Chunkabschnitt erneut starten.
Vorbereitende Schritte
- Installieren Sie das Java-Stapelfeature für WebSphere Application Server Developer Tools for Eclipse. Dieses Feature ist optional. Sie können es über Hilfe > WebSphere-Software installieren installieren.
- Erstellen Sie ein Java-Stapelprojekt.
- Erstellen Sie einen Java-Stapeljob im Java-Stapelprojekt.
Informationen zu diesem Vorgang
Vorgehensweise
- Öffnen Sie im JSL-Editor die XML-Datei für Ihren Java-Stapeljob.
Der JSL-Editor wird automatisch geöffnet, wenn Sie bei der Erstellung eines Java-Stapeljobs auf Fertigstellen klicken. Im JSL-Editor wird eine XML-Datei mit demselben Namen wir der Stapeljob angezeigt.
Wenn Sie einer vorhandenen XML-Datei für einen Java-Stapeljob einen Abschnitt hinzufügen, führen Sie die folgenden Schritte aus, um die XML-Datei im JSL-Editor zu öffnen.- Wählen Sie in der Ansicht "Enterprise-Explorer" das erstellte Java-Stapelprojekt aus.
- Wählen Sie src > META-INF > batch-jobs aus.
- Klicken Sie doppelt auf die XML-Datei für Ihren Java-Stapeljob.
Die Datei wird im JSL-Editor angezeigt.
- Wählen Sie den Jobknoten auf der Registerkarte Übersicht aus und klicken Sie auf Hinzufügen.
- Wählen Sie Abschnitt aus und klicken Sie auf OK.
- Optional: Ändern Sie die ID im Feld ID* der Registerkarte Details.
- Wählen Sie den Abschnittsknoten auf der Registerkarte Übersicht aus und klicken Sie auf Hinzufügen.
- Wählen Sie Chunk aus und klicken Sie auf OK.
Auf der Registerkarte "Übersicht" im JSL-Editor wird der Chunkknoten als untergeordnetes Element des Abschnitts angezeigt. Es werden ein Readerknoten und ein Writerknoten als untergeordnete Elemente des Chunkknotens angezeigt.
- Implementieren Sie den Readerknoten.
- Klicken Sie auf der Registerkarte "Übersicht" auf den Readerknoten.
Die Registerkarte "Details" für den Readerknoten wird angezeigt.
- Erstellen Sie eine Readerklasse oder schließen Sie eine Readerklasse ein, um den Readerknoten zu implementieren.
Sie können eine Readerklasse für Ihr Projekt erstellen, eine Readerklasse aus einem anderen Abschnitt innerhalb Ihres Projekts einschließen oder eine Readerklasse aus einem Chunkabschnitt in einem anderen Projekt einschließen. Führen Sie eine der folgenden Aufgaben aus:
- Erstellen Sie eine Readerklasse für Ihren Chunkabschnitt.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
Der Assistent Item-Reader-Klasse erstellen wird angezeigt.
- Geben Sie im Feld Java-Paket den Namen des Pakets an.
- Geben Sie im Feld Klassenname den Namen der Klasse an.
- Optional: Geben Sie im Feld Superklasse den Namen der Superklasse an oder wählen Sie den Eintrag Abstrakte Java-Stapelklasse als Superklasse verwenden aus.
- Optional: Fügen Sie im Feld Schnittstellen weitere für diese Klasse zu implementierende Schnittstellen hinzu.
- Übernehmen Sie für Ladeoptionen für Stapelartefakt den Standardwert von
Vollständig qualifizierten Namen der Klasse verwenden.
- Wenn Sie die Option Vollständig qualifizierten Namen der Klasse verwenden auswählen, behandelt die Laufzeitumgebung den Stapelartefaktverweis als Klassennamen und lädt den Verweis mit dem Klassenladeprogramm für Threadkontexte. Das Laden findet statt, um einen Stapelartefaktverweis aufzulösen, wenn das Archivladeprogramm für diesen Verweis null zurückgibt.
- Wenn Sie die Option Kontext- und Abhängigkeitsinjektion (CDI) verwenden auswählen, verwendet die Laufzeitumgebung das implementierungsspezifische CDI-Ladeprogramm, um den Stapelartefaktverweis anhand des Bean-Namens aufzulösen, den Sie angeben.
- Wenn Sie die Option Klasse zur Datei "batch.xml" hinzufügen auswählen, verwendet die Laufzeitumgebung das Archivladeprogramm, um den Verweis aufzulösen, indem die angegebene ID in der Datei batch.xml gesucht wird.
- Klicken Sie auf Fertigstellen.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
- Verwenden Sie eine vorhandene Readerklasse, um den Chunkabschnitt zu implementieren.
- Klicken Sie auf der Registerkarte "Details" auf Durchsuchen.
- Suchen Sie anhand des Namens nach Klassen, indem Sie Nach Klassen suchen auswählen und anschließend den Klassennamen eingeben.
- Wählen Sie den Klassennamen unter Übereinstimmende Elemente aus.
- Wenn eine Datei vom Typ batch.xml vorhanden ist, können Sie als Alternative zur Suche die Option Einträge in "batch.xml" durchsuchen und anschließend einen der Einträge in der Tabelle auswählen.
- Klicken Sie auf OK.
- Erstellen Sie eine Readerklasse für Ihren Chunkabschnitt.
- Klicken Sie auf der Registerkarte "Übersicht" auf den Readerknoten.
- Implementieren Sie den Writerknoten.
- Klicken Sie auf der Registerkarte "Übersicht" auf den Writerknoten.
Die Registerkarte "Details" für den Writerknoten wird angezeigt.
- Erstellen Sie eine Writerklasse oder schließen Sie eine Writerklasse ein, um den Writerknoten zu implementieren. Sie können eine Writerklasse für Ihr Projekt erstellen, eine Writerklasse aus einem anderen Abschnitt innerhalb Ihres Projekts einschließen oder eine Writerklasse aus einem Chunkabschnitt in einem anderen Projekt einschließen. Führen Sie eine der folgenden Aufgaben aus:
- Erstellen Sie eine Writerklasse für Ihren Chunkabschnitt.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
Der Assistent Item-Writer-Klasse erstellen wird angezeigt.
Die folgenden Beschreibungen zum Assistenten Item-Writer-Klasse erstellen sind identisch mit denen für den Assistenten Item-Reader-Klasse erstellen. Die Informationen werden hier im Kontext wiederholt.
- Geben Sie im Feld Java-Paket den Namen des Pakets an.
- Geben Sie im Feld Klassenname den Namen der Klasse an.
- Optional: Geben Sie im Feld Superklasse den Namen der Superklasse an oder wählen Sie den Eintrag Abstrakte Java-Stapelklasse als Superklasse verwenden aus.
- Optional: Fügen Sie im Feld Schnittstellen weitere für diese Klasse zu implementierende Schnittstellen hinzu.
- Übernehmen Sie für Ladeoptionen für Stapelartefakt den Standardwert von
Vollständig qualifizierten Namen der Klasse verwenden.
- Wenn Sie die Option Vollständig qualifizierten Namen der Klasse verwenden auswählen, behandelt die Laufzeitumgebung den Stapelartefaktverweis als Klassennamen und lädt den Verweis mit dem Klassenladeprogramm für Threadkontexte. Das Laden findet statt, um einen Stapelartefaktverweis aufzulösen, wenn das Archivladeprogramm für diesen Verweis null zurückgibt.
- Wenn Sie die Option Kontext- und Abhängigkeitsinjektion (CDI) verwenden auswählen, verwendet die Laufzeitumgebung das implementierungsspezifische CDI-Ladeprogramm, um den Stapelartefaktverweis anhand des Bean-Namens aufzulösen, den Sie angeben.
- Wenn Sie die Option Klasse zur Datei "batch.xml" hinzufügen auswählen, verwendet die Laufzeitumgebung das Archivladeprogramm, um den Verweis aufzulösen, indem die angegebene ID in der Datei batch.xml gesucht wird.
- Klicken Sie auf Fertigstellen.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
- Verwenden Sie eine vorhandene Writerklasse, um den Chunkabschnitt zu implementieren.
Die folgenden Schritte sind identisch mit denen, die zuvor für die Readerklasse beschrieben wurden. Die Informationen werden hier im Kontext wiederholt.
- Klicken Sie auf der Registerkarte "Details" auf Durchsuchen.
- Suchen Sie anhand des Namens nach Klassen, indem Sie Nach Klassen suchen auswählen und anschließend den Klassennamen eingeben.
- Wählen Sie den Klassennamen unter Übereinstimmende Elemente aus.
- Wenn eine Datei vom Typ batch.xml vorhanden ist, können Sie als Alternative zur Suche die Option Einträge in "batch.xml" durchsuchen und anschließend einen der Einträge in der Tabelle auswählen.
- Klicken Sie auf OK.
- Erstellen Sie eine Writerklasse für Ihren Chunkabschnitt.
- Klicken Sie auf der Registerkarte "Übersicht" auf den Writerknoten.
- Optional: Implementieren Sie den Prozessorknoten für den Chunkknoten.
Der Prozessorknoten wird für die Verarbeitung von Chunkabschnittseingaben verwendet.
- Wählen Sie den Chunkknoten auf der Registerkarte Übersicht aus und klicken Sie auf Hinzufügen.
- Wählen Sie Prozessor aus und klicken Sie auf OK.
Auf der Registerkarte "Übersicht" im JSL-Editor wird der Prozessorknoten als untergeordnetes Element des Chunkknotens angezeigt.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
Der Assistent Item-Processor-Klasse erstellen wird angezeigt.
Die folgenden Beschreibungen zum Assistenten Item-Processor-Klasse erstellen sind identisch mit denen für den Assistenten Item-Reader-Klasse erstellen. Die Informationen werden hier im Kontext wiederholt.
- Geben Sie im Feld Java-Paket den Namen des Pakets an.
- Geben Sie im Feld Klassenname den Namen der Klasse an.
- Optional: Geben Sie im Feld Superklasse den Namen der Superklasse an.
- Optional: Fügen Sie im Feld Schnittstellen weitere für diese Klasse zu implementierende Schnittstellen hinzu.
- Übernehmen Sie für Ladeoptionen für Stapelartefakt den Standardwert von
Vollständig qualifizierten Namen der Klasse verwenden.
- Wenn Sie die Option Vollständig qualifizierten Namen der Klasse verwenden auswählen, behandelt die Laufzeitumgebung den Stapelartefaktverweis als Klassennamen und lädt den Verweis mit dem Klassenladeprogramm für Threadkontexte. Das Laden findet statt, um einen Stapelartefaktverweis aufzulösen, wenn das Archivladeprogramm für diesen Verweis null zurückgibt.
- Wenn Sie die Option Kontext- und Abhängigkeitsinjektion (CDI) verwenden auswählen, verwendet die Laufzeitumgebung das implementierungsspezifische CDI-Ladeprogramm, um den Stapelartefaktverweis anhand des Bean-Namens aufzulösen, den Sie angeben.
- Wenn Sie die Option Klasse zur Datei "batch.xml" hinzufügen auswählen, verwendet die Laufzeitumgebung das Archivladeprogramm, um den Verweis aufzulösen, indem die angegebene ID in der Datei batch.xml gesucht wird.
- Klicken Sie auf Fertigstellen.
- Optional: Setzen Sie den Prüfpunkt für den Chunkknoten so, dass Sie den Knoten erneut starten können.
Sie können den Prüfpunkt für den Chunkknoten entweder setzen, nachdem eine angegebene Anzahl von Datensätzen verarbeitet wurden oder nach einem Prüfpunktalgorithmus.
- Setzen Sie den Prüfpunkt für den Chunkknoten, nachdem eine angegebene Anzahl von Datensätzen im Chunk verarbeitet wurden.
- Wählen Sie für die Prüfpunktrichtlinie den Eintrag Element aus.
- Geben Sie die Anzahl der pro Chunk zu verarbeitenden Elemente an, indem Sie einen Wert für Elementanzahl angeben.
- Geben Sie den Zeitraum an, der vertreichen muss, bevor ein Prüfpunkt abgerufen wird, indem Sie einen Wert für Zeitlimit angeben.
- Setzen Sie den Prüfpunkt für den Knoten so, dass er auf einem Prüfpunktalgorithmus basiert.
- Wählen Sie für die Prüfpunktrichtlinie den Eintrag Angepasst aus.
- Klicken Sie auf der Registerkarte "Übersicht" auf Hinzufügen.
- Wählen Sie Prüfpunktalgorithmus aus und klicken Sie auf OK.
Die Registerkarte "Details" wird für den Prüfpunktalgorithmus angezeigt.
- Erstellen Sie eine Prüfpunktalgorithmusklasse oder schließen Sie eine ein, um den Prüfpunktalgorithmus zu implementieren. Sie können eine Prüfpunktalgorithmusklasse für Ihren Chunkabschnitt erstellen, eine Prüfpunktalgorithmusklasse aus einem anderen Abschnitt innerhalb Ihres Projekts einschließen oder eine Prüfpunktalgorithmusklasse aus einem Prüfpunktalgorithmusabschnitt in einem anderen Projekt einschließen. Führen Sie eine der folgenden Schrittgruppen aus:
- Erstellen Sie eine Prüfpunktalgorithmusklasse, um den Prüfpunktalgorithmus zu implementieren.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
Der Assistent Prüfpunktalgorithmusklasse erstellen wird angezeigt.
Die folgenden Beschreibungen zum Assistenten Prüfpunktalgorithmusklasse erstellen sind identisch mit denen für den Assistenten Item-Reader-Klasse erstellen. Die Informationen werden hier im Kontext wiederholt.
- Geben Sie im Feld Java-Paket den Namen des Pakets an.
- Geben Sie im Feld Klassenname den Namen der Klasse an.
- Optional: Geben Sie im Feld Superklasse den Namen der Superklasse an.
- Optional: Fügen Sie im Feld Schnittstellen weitere für diese Klasse zu implementierende Schnittstellen hinzu.
- Übernehmen Sie für Ladeoptionen für Stapelartefakt den Standardwert von
Vollständig qualifizierten Namen der Klasse verwenden.
- Wenn Sie die Option Vollständig qualifizierten Namen der Klasse verwenden auswählen, behandelt die Laufzeitumgebung den Stapelartefaktverweis als Klassennamen und lädt den Verweis mit dem Klassenladeprogramm für Threadkontexte. Das Laden findet statt, um einen Stapelartefaktverweis aufzulösen, wenn das Archivladeprogramm für diesen Verweis null zurückgibt.
- Wenn Sie die Option Kontext- und Abhängigkeitsinjektion (CDI) verwenden auswählen, verwendet die Laufzeitumgebung das implementierungsspezifische CDI-Ladeprogramm, um den Stapelartefaktverweis anhand des Bean-Namens aufzulösen, den Sie angeben.
- Wenn Sie die Option Klasse zur Datei "batch.xml" hinzufügen auswählen, verwendet die Laufzeitumgebung das Archivladeprogramm, um den Verweis aufzulösen, indem die angegebene ID in der Datei batch.xml gesucht wird.
- Klicken Sie auf Fertigstellen.
- Klicken Sie auf den Querverweis auf der Registerkarte Details.
- Verwenden Sie eine vorhandene Prüfpunktalgorithmusklasse, um den Prüfpunktalgorithmus zu implementieren.
Die folgenden Schritte sind identisch mit denen, die zuvor für die Readerklasse beschrieben wurden. Die Informationen werden hier im Kontext wiederholt.
- Klicken Sie auf der Registerkarte "Details" auf Durchsuchen.
- Suchen Sie anhand des Namens nach Klassen, indem Sie Nach Klassen suchen auswählen und anschließend den Klassennamen eingeben.
- Wählen Sie den Klassennamen unter Übereinstimmende Elemente aus.
- Wenn eine Datei vom Typ batch.xml vorhanden ist, können Sie als Alternative zur Suche die Option Einträge in "batch.xml" durchsuchen und anschließend einen der Einträge in der Tabelle auswählen.
- Klicken Sie auf OK.
- Erstellen Sie eine Prüfpunktalgorithmusklasse, um den Prüfpunktalgorithmus zu implementieren.
- Setzen Sie den Prüfpunkt für den Chunkknoten, nachdem eine angegebene Anzahl von Datensätzen im Chunk verarbeitet wurden.
- Klicken Sie auf Fertigstellen.