Ajout d'une étape de batchlet à un travail par lots Java

Vous pouvez ajouter une étape de batchlet dans le fichier XML d'un travail par lots Java™. Utilisez une étape de batchlet pour effectuer des traitements orientés tâche tels que l'exécution d'une commande ou le transfert d'un fichier.

Avant de commencer

Une étape de batchlet est lancée une seule fois, s'exécute jusqu'à la fin, et renvoie un état de sortie. A la différence d'une étape de bloc, l'étape de batchlet ne lit pas, ne traite pas, et n'écrit pas d'éléments individuels, lesquels sont des enregistrements de données.

Effectuez les tâches suivantes :
  • 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

Utilisez l'éditeur JSL (Job Specification Language) pour créer l'étape de batchlet. Créez ensuite une classe de batchlet et ajoutez-la à l'étape de batchlet pour implémenter cette étape.

Procédure

  1. 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 :
    1. Dans la vue Explorateur d'entreprise, sélectionnez le projet de travail par lots Java que vous avez créé.
    2. Sélectionnez src > META-INF > batch-jobs.
    3. Effectuez un double-clic sur le fichier XML de votre travail par lots Java.

      Le fichier s'affiche dans l'éditeur JSL.

  2. Sélectionnez le noeud du travail sur l'onglet Aperçu ; cliquez sur Ajouter.
  3. Sélectionnez Etape ; cliquez sur OK.
  4. Facultatif : Modifiez l'ID dans la zone ID* de l'onglet Détails.
  5. Sélectionnez le noeud d'étape sur l'onglet Aperçu ; cliquez sur Ajouter.
  6. Sélectionnez Batchlet ; cliquez sur OK.
  7. Incluez une classe de batchlet pour implémenter l'étape de batchlet.

    Vous pouvez créer une nouvelle classe de batchlet pour votre projet, utiliser une classe de batchlet existante dans votre projet ou en utiliser une issue d'un autre projet et figurant dans le chemin de classes de votre projet. Effectuez l'une des tâches suivantes :

    1. Créez une classe pour implémenter cette étape de batchlet.
      1. Cliquez sur le lien à la référence dans l'onglet Détails.

        L'assistant Nouvelle classe de bachlet s'ouvre.

      2. Dans la zone Package Java, spécifiez le nom du package.
      3. Dans la zone Nom de classe, spécifiez le nom de la classe.
      4. Facultatif : dans la zone Superclasse, spécifiez le nom de la superclasse.
      5. Facultatif : dans la zone Interfaces, ajoutez d'autres interfaces à implémenter par cette classe.
      6. 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.
    2. Utilisez une classe de batchlet existante pour implémenter l'étape de batchlet.
      1. Cliquez sur Parcourir dans l'onglet Détails.
      2. Recherchez des classes par nom en sélectionnant Rechercher des classes, puis en entrant le nom de la classe.
      3. Sélectionnez le nom de la classe dans Eléments correspondants.
      4. 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.
      5. Cliquez sur OK.
  8. Cliquez sur Terminer.

Résultats

Vous avez créé une étape de batchlet pour un travail par lots Java. Vous avez inclus une classe de batchlet dans l'étape de batchlet pour pouvoir implémenter cette étape dans le travail par lots Java. Vous avez créé la classe de batchlet ou utilisé une classe existante.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_add_batchlet_step.html