Création d'une application utilisant le support d'activité métier des services Web

Pour créer un composant d'application qui utilise la prise en charge d'activité métier, vous devez définir Exécuter des méthodes EJB sous une portée d'activité métier dans le descripteur de déploiement du composant d'application concerné, et le cas échéant, créer et spécifier un gestionnaire de compensation pour l'application à utiliser en cas d'erreur. Ensuite, vous construisez le composant dans l'application puis déployez l'application sur un serveur pour lequel la prise en charge d'activité métier est activée. Le composant d'application peut être soit un bean enterprise ou un service Web qui est implémenté sous la forme d'un bean enterprise.

Avant de commencer

Pour plus d'informations sur l'édition de descripteurs de déploiement en utilisant Rational Application Developer, consultez la documentation relative à Rational Application Developer.

Pourquoi et quand exécuter cette tâche

Effectuez cette tâche pour une application qui s'exécute sur un serveur activé pour l'activité métier, afin d'utiliser la prise en charge de cette dernière lors de son exécution et d'effectuer un travail qui peut être ensuite compensé par un gestionnaire de compensation. Si l'application requiert une compensation lorsque une portée d'activité métier se termine, l'application transfert indirectement les données requises par le processus de compensation vers un gestionnaire de compensation à l'aide de l'API d'activité métier. Les données requises par le processus de compensation peuvent être sous forme d'un objet sérialisable ou d'un objet SDO.

Procédure

  1. Concevez le composant d'application qui requiert la prise en charge d'activité métier. Définissez notamment les exigences de composant d'application pour la compensation et les activités proches. Si le composant d'application requiert une compensation, définissez la nature des données dans l'objet sérialisable ou SDO que le composant d'application transfert au gestionnaire de compensation.
  2. A l'aide des informations de conception de l'application, créez le gestionnaire de compensation pour le composant d'application si nécessaire. Ce gestionnaire définit la logique proche et de compensation qui s'applique pour l'exécution d'une portée d'activité métier que le gestionnaire lui a ajouté par le biais d'un composant d'application.
    1. Ouvrez l'outil d'assemblage WebSphere Application Server sélectionné.
    2. Créez une nouvelle classe Java™ pour implémenter l'interface adéquate en fonction du format des données requises par le processus de compensation :
      • Pour un objet sérialisable, implémentez l'interface com.ibm.websphere.wsba.serializable.CompensationHandler.
      • Pour un objet SDO, implémentez l'interface com.ibm.websphere.wsba.CompensationHandler.
    3. Implémentez les méthodes close et compensate sur le nouvel objet gestionnaire de compensation pour effectuer les actions adéquates en fonction des données SDO ou sérialisables transmises au gestionnaire lorsqu'il est appelé.
    La classe de gestionnaire de compensation est maintenant prête pour le référencement par le composant d'application et pour l'assemblage dans une application.
  3. Ouvrez le composant d'application dans l'outil d'assemblage.
  4. Ouvrez le descripteur de déploiement pour le composant d'application dans l'afficheur de descripteur de déploiement.
  5. Déroulez jusqu'à la section Compensation et cochezExécuter des méthodes EJB sous une portée d'activité métier.
  6. Dans la zone de texte Classe de gestionnaire de compensation, entrez le nom de classe complet de la classe de gestionnaire de compensation que vous avez précédemment créée.
  7. Sauvegardez le descripteur de déploiement.
  8. Générez l'application, y compris le composant d'application et le gestionnaire de compensation. Si l'application est un service Web, elle doit être compatible avec la norme 109 Java Specification Request (JSR).
  9. Déployez l'application sur un serveur d'applications qui est activé pour l'activité métier.

Résultats

L'application est désormais activée pour l'activité métier et peut utiliser le support d'activité métier lors de l'exécution via l'API d'activité métier. Le composant d'application possède un gestionnaire de compensation associé et peut donc appeler les méthodes setCompensationDataImmediate et setCompensationDataAtCommit lors de l'exécution pour ajouter le gestionnaire de compensation à la portée de l'activité métier. Pour plus d'informations sur ces méthodes, voir les rubriques relatives à l'API d'activité métier. Si l'unité de travail avec laquelle la portée d'activité métier est associée est défaillante, le gestionnaire de compensation met en place des actions pour corriger l'erreur.

Que faire ensuite

Assurez-vous que la classe de gestionnaire de compensation se trouve bien dans le chemin de classes d'application de l'environnement d'exécution WebSphere Application Server.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tjta_wsba_app
Nom du fichier : tjta_wsba_app.html