Ajout d'une étape de bloc à un travail par lots Java
Vous pouvez ajouter une étape de bloc au fichier xml d'un travail par lots Java™. Vous pouvez lire, traiter et écrire des éléments individuels dans l'étape de bloc et également redémarrer cette étape.
Avant de commencer
- Installez la fonction de traitement par lots Java pour WebSphere Application Server Developer Tools for Eclipse. Cette fonction est facultative. Vous pouvez l'installer depuis le menu Aide > Installer un logiciel WebSphere.
- Créez un projet par lots Java.
- Créez un travail Java par lots dans le projet Java par lots.
Pourquoi et quand exécuter cette tâche
Procédure
- Dans l'éditeur JSL (Job Specification Language), ouvrez le fichier xml de votre travail par lots Java.
L'éditeur JSL s'ouvre automatiquement si vous cliquez sur Terminer lorsque vous créez un travail par lots Java. Un fichier xml avec le même nom que le travail par lots s'affiche dans l'éditeur JSL.
Si vous ajoutez une étape dans un fichier XML existant de travail par lots Java, procédez comme suit pour ouvrir le fichier XML dans l'éditeur JSL :- Dans la vue Explorateur d'entreprise, sélectionnez le projet de travail par lots Java que vous avez créé.
- Sélectionnez src > META-INF > batch-jobs.
- Effectuez un double-clic sur le fichier xml de votre travail par lots Java.
Le fichier s'affiche dans l'éditeur JSL.
- Sélectionnez le noeud du travail sur l'onglet Aperçu ; cliquez sur Ajouter.
- Sélectionnez Etape ; cliquez sur OK.
- Facultatif : Modifiez l'ID dans la zone ID* de l'onglet Détails.
- Sélectionnez le noeud d'étape sur l'onglet Aperçu ; cliquez sur Ajouter.
- Sélectionnez Bloc ; cliquez sur OK.
Dans l'onglet d'aperçu de l'éditeur JSL, le noeud de bloc figure comme enfant de l'étape. Un noeud de programme de lecture et un noeud de programme d'écriture figurent comme enfants du noeud de bloc.
- Implémentez le noeud du programme de lecture.
- Sur l'onglet Aperçu, cliquez sur le noeud du programme de lecture.
L'onglet Détails du noeud de programme de lecture s'affiche.
- Créez ou incluez une classe de programme de lecture pour implémenter le noeud du programme de lecture.
Vous pouvez créer une classe de programme de lecture pour votre projet, en inclure une issue d'une autre étape de votre projet ou d'une étape de bloc d'un autre projet. Effectuez l'une des tâches suivantes :
- Créer une classe de de programme de lecture pour votre étape de bloc.
- Cliquez sur le lien à la référence dans l'onglet Détails.
L'assistant Créer une classe de programme de lecture d'éléments s'ouvre.
- Dans la zone Package Java, spécifiez le nom du package.
- Dans la zone Nom de classe, spécifiez le nom de la classe.
- Facultatif : dans la zone Superclasse, spécifiez le nom de la superclasse ou sélectionnez Utiliser la classe Java Batch abstraite comme superclasse.
- Facultatif : dans la zone Interfaces, ajoutez d'autres interfaces à implémenter par la classe.
- Pour Options de chargement d'artefact par lots, acceptez la valeur par défaut :
Utiliser le nom qualifié complet de la classe.
- Si vous sélectionnez l'option Utiliser le nom qualifié complet de la classe, l'environnement d'exécution traite la référence à l'artefact du lot comme un nom de classe et charge la référence via le chargeur de classe de contexte de l'unité d'exécution. Le chargement est effectué pour résoudre une référence à un artefact de lot lorsque le programme de chargement d'archive renvoie la valeur 'null' pour cette référence.
- Si vous sélectionnez l'option Utiliser l'injection de dépendance et de contexte (CDI), l'environnement d'exécution utilise le chargeur spécifique à l'implémentation CDI pour la résolution de la référence à l'artefact du lot en utilisant le nom de bean que vous spécifiez.
- Si vous sélectionnez l'option Ajouter la classe au fichier batch.xml, l'environnement d'exécution utilise le chargeur d'archive afin de résoudre la référence en recherchant l'identificateur spécifié dans le fichier batch.xml.
- Cliquez sur Terminer.
- Cliquez sur le lien à la référence dans l'onglet Détails.
- Utiliser une classe de programme de lecture existante pour implémenter l'étape de bloc.
- Cliquez sur Parcourir dans l'onglet Détails.
- Recherchez des classes par nom en sélectionnant Rechercher des classes, puis en entrant le nom de la classe.
- Sélectionnez le nom de la classe dans Eléments correspondants.
- En alternative à la recherche, si un fichier batch.xml existe, sélectionnez Parcourir les entrées du fichier batch.xml, puis sélectionnez l'une des entrées dans la table.
- Cliquez sur OK.
- Créer une classe de de programme de lecture pour votre étape de bloc.
- Sur l'onglet Aperçu, cliquez sur le noeud du programme de lecture.
- Implémenter le noeud du programme d'écriture.
- Sur l'onglet Aperçu, cliquez sur le noeud du programme d'écriture.
L'onglet Détails du noeud de programme d'écriture.
- Créez ou incluez une classe de programme d'écriture pour implémenter le noeud de programme d'écriture. Vous pouvez créer une classe de programme d'écriture pour votre projet, en inclure une issue d'une autre étape de votre projet ou d'une étape de bloc d'un autre projet. Effectuez l'une des tâches suivantes :
- Créer une classe de de programme d'écriture pour votre étape de bloc.
- Cliquez sur le lien à la référence dans l'onglet Détails.
L'assistant Créer une classe de programme d'écriture d'éléments s'ouvre.
Les descriptions suivantes sur l'assistant Créer une classe de programme d'écriture d'éléments sont identiques à celles de l'assistant Créer une classe de programme de lecture d'éléments. Les informations sont répétées ici dans le contexte correspondant.
- Dans la zone Package Java, spécifiez le nom du package.
- Dans la zone Nom de classe, spécifiez le nom de la classe.
- Facultatif : dans la zone Superclasse, spécifiez le nom de la superclasse ou sélectionnez Utiliser la classe Java Batch abstraite comme superclasse.
- Facultatif : dans la zone Interfaces, ajoutez d'autres interfaces à implémenter par la classe.
- Pour Options de chargement d'artefact par lots, acceptez la valeur par défaut : Utiliser le nom qualifié complet de la classe.
- Si vous sélectionnez l'option Utiliser le nom qualifié complet de la classe, l'environnement d'exécution traite la référence à l'artefact du lot comme un nom de classe et charge la référence via le chargeur de classe de contexte de l'unité d'exécution. Le chargement est effectué pour résoudre une référence à un artefact de lot lorsque le programme de chargement d'archive renvoie la valeur 'null' pour cette référence.
- Si vous sélectionnez l'option Utiliser l'injection de dépendance et de contexte (CDI), l'environnement d'exécution utilise le chargeur spécifique à l'implémentation CDI pour la résolution de la référence à l'artefact du lot en utilisant le nom de bean que vous spécifiez.
- Si vous sélectionnez l'option Ajouter la classe au fichier batch.xml, l'environnement d'exécution utilise le chargeur d'archive afin de résoudre la référence en recherchant l'identificateur spécifié dans le fichier batch.xml.
- Cliquez sur Terminer.
- Cliquez sur le lien à la référence dans l'onglet Détails.
- Utiliser une classe de programme d'écriture pour implémenter l'étape de bloc.
Les étapes suivantes sont identiques à celles décrites auparavant dans la classe de programme de lecture. Les informations sont répétées ici dans le contexte correspondant.
- Cliquez sur Parcourir dans l'onglet Détails.
- Recherchez des classes par nom en sélectionnant Rechercher des classes, puis en entrant le nom de la classe.
- Sélectionnez le nom de la classe dans Eléments correspondants.
- En alternative à la recherche, si un fichier batch.xml existe, sélectionnez Parcourir les entrées du fichier batch.xml, puis sélectionnez l'une des entrées dans la table.
- Cliquez sur OK.
- Créer une classe de de programme d'écriture pour votre étape de bloc.
- Sur l'onglet Aperçu, cliquez sur le noeud du programme d'écriture.
- Facultatif : Implémentez le noeud de processeur pour le noeud de bloc.
Le noeud de processeur est utilisé pour traiter les entrées pour l'étape de bloc.
- Sélectionnez le noeud de bloc sur l'onglet Aperçu ; cliquez sur Ajouter.
- Sélectionnez Processeur ; cliquez sur OK.
Sur l'onglet Aperçu de l'éditeur JSL, le noeud de processeur s'affiche en tant qu'enfant du noeud de bloc.
- Cliquez sur le lien à la référence dans l'onglet Détails.
L'assistant Créer une classe de programme de traitement d'éléments s'ouvre.
Les descriptions ci-après sur l'assistant Créer une classe de programme de traitement d'éléments sont identiques à celles de l'assistant Créer une classe de programme de lecture d'éléments wizard. Les informations sont répétées ici dans le contexte correspondant.
- Dans la zone Package Java, spécifiez le nom du package.
- Dans la zone Nom de classe, spécifiez le nom de la classe.
- Facultatif : Dans la zone Superclasse, spécifiez le nom de la superclasse.
- Facultatif : Dans la zone Interfaces, ajoutez d'autres interfaces à implémenter par la classe.
- Pour Options de chargement d'artefact par lots, acceptez la valeur par défaut : Utiliser le nom qualifié complet de la classe.
- Si vous sélectionnez l'option Utiliser le nom qualifié complet de la classe, l'environnement d'exécution traite la référence à l'artefact du lot comme un nom de classe et charge la référence via le chargeur de classe de contexte de l'unité d'exécution. Le chargement est effectué pour résoudre une référence à un artefact de lot lorsque le programme de chargement d'archive renvoie la valeur 'null' pour cette référence.
- Si vous sélectionnez l'option Utiliser l'injection de dépendance et de contexte (CDI), l'environnement d'exécution utilise le chargeur spécifique à l'implémentation CDI pour la résolution de la référence à l'artefact du lot en utilisant le nom de bean que vous spécifiez.
- Si vous sélectionnez l'option Ajouter la classe au fichier batch.xml, l'environnement d'exécution utilise le chargeur d'archive afin de résoudre la référence en recherchant l'identificateur spécifié dans le fichier batch.xml.
- Cliquez sur Terminer.
- Facultatif : Créez un point de contrôle sur le noeud de bloc afin de pouvoir redémarrer le noeud.
Vous pouvez créer un point de contrôle sur le noeud de bloc après le traitement d'un certain nombre d'enregistrements ou d'après un algorithme de point de contrôle.
- Créer un point de contrôle après le traitement d'un nombre d'enregistrements spécifique dans le bloc.
- Sélectionnez Elément pour la règle de point de contrôle.
- Spécifiez le nombre d'élément à traiter par bloc en indiquant une valeur pour Nombre d'éléments.
- Spécifiez le délai devant s'écouler avant un point de contrôle en indiquant une valeur pour time-limit.
- Créer pour le noeud un point de contrôle basé sur un algorithme de point de contrôle.
- Sélectionnez Personnalisée pour la règle de point de contrôle.
- Sur l'onglet Aperçu, cliquez sur Ajouter.
- Sélectionnez Algorithme de point de contrôle ; cliquez sur OK.
L'onglet Détails pour Algorithme de point de contrôle s'affiche.
- Créez ou incluez une classe d'algorithme de point de contrôle pour implémenter l'algorithme de point de contrôle.Vous pouvez créer une nouvelle classe d'algorithme de point de contrôle pour votre étape de bloc, en inclure une issue d'une autre étape dans votre projet ou en inclure une issue d'une étape d'algorithme de point de contrôle dans un autre projet. Effectuez l'une des procédures suivantes :
- Créez une classe d'algorithme de point de contrôle pour implémenter l'algorithme de point de contrôle.
- Cliquez sur le lien à la référence dans l'onglet Détails.
L'assistant Create Checkpoint Algorithm Class s'ouvre.
Les descriptions ci-après sur l'assistant Créer une classe d'algorithme de point de contrôle sont identiques à celles de l'assistant Créer une classe de programme de lecture d'éléments. Les informations sont répétées ici dans le contexte correspondant.
- Dans la zone Package Java, spécifiez le nom du package.
- Dans la zone Nom de classe, spécifiez le nom de la classe.
- Facultatif : dans la zone Superclasse, spécifiez le nom de la superclasse.
- Facultatif : dans la zone Interfaces, ajoutez d'autres interfaces à implémenter par la classe.
- Pour Options de chargement d'artefact par lots, acceptez la valeur par défaut : Utiliser le nom qualifié complet de la classe.
- Si vous sélectionnez l'option Utiliser le nom qualifié complet de la classe, l'environnement d'exécution traite la référence à l'artefact du lot comme un nom de classe et charge la référence via le chargeur de classe de contexte de l'unité d'exécution. Le chargement est effectué pour résoudre une référence à un artefact de lot lorsque le programme de chargement d'archive renvoie la valeur 'null' pour cette référence.
- Si vous sélectionnez l'option Utiliser l'injection de dépendance et de contexte (CDI), l'environnement d'exécution utilise le chargeur spécifique à l'implémentation CDI pour la résolution de la référence à l'artefact du lot en utilisant le nom de bean que vous spécifiez.
- Si vous sélectionnez l'option Ajouter la classe au fichier batch.xml, l'environnement d'exécution utilise le chargeur d'archive afin de résoudre la référence en recherchant l'identificateur spécifié dans le fichier batch.xml.
- Cliquez sur Terminer.
- Cliquez sur le lien à la référence dans l'onglet Détails.
- Utiliser une classe d'algorithme de point de contrôle existante pour implémenter l'algorithme de point de contrôle.
Les étapes suivantes sont identiques à celles décrites auparavant dans la classe de programme de lecture. Les informations sont répétées ici dans le contexte correspondant.
- Cliquez sur Parcourir dans l'onglet Détails.
- Recherchez des classes par nom en sélectionnant Rechercher des classes, puis en entrant le nom de la classe.
- Sélectionnez le nom de la classe dans Eléments correspondants.
- En alternative à la recherche, si un fichier batch.xml existe, sélectionnez Parcourir les entrées du fichier batch.xml, puis sélectionnez l'une des entrées dans la table.
- Cliquez sur OK.
- Créez une classe d'algorithme de point de contrôle pour implémenter l'algorithme de point de contrôle.
- Créer un point de contrôle après le traitement d'un nombre d'enregistrements spécifique dans le bloc.
- Cliquez sur Terminer.