Création d'un bean Java J2C

Après avoir créé des liaisons de données Java IMS, vous devez créer un bean Java qui communique avec IMS via l'architecture J2EE Connector.

Ce bean Java comprend une méthode qui soumet une requête à IMS pour exécuter la transaction IMS. Cette méthode utilise les liaisons de données Java pour générer les messages d'entrée et de sortie pour la transaction. Un bean Java J2C peut comprendre plusieurs méthodes exécutant une transaction IMS ainsi que plusieurs liaisons de données pour différents messages d'entrée et de sortie. Le code généré pour le bean Java J2C utilise l'interface CCI fournie par l'adaptateur de ressources IMS TM pour communiquer avec IMS.

Pour créer un bean Java J2C qui exécute une transaction IMS, procédez comme suit :

  1. Pour démarrer l'assistant dynamique J2C, dans la barre de menus, sélectionnez Fichier > Nouveau > Autre > J2C.
  2. Développez le dossier J2C, sélectionnez Bean Java J2C, et cliquez sur Suivant.
  3. Sur la page Sélection des adaptateurs de ressources, sélectionnez la version de l'adaptateur de ressources IMS TM que vous souhaitez utiliser. Vous pouvez sélectionner l'adaptateur de ressources IMS TM JCA 1.0, IMS Connector for Java (IBM : 9.1.0.1.1) ou l'adaptateur de ressources IMS TM JCA 1.5, IMS Connector for Java (IBM : 9.1.0.2).
  4. Cliquez sur Suivant.
  5. Sur la page Propriétés de connexion, cochez la case Géré.
    Remarque : Il existe deux façons de créer des connexions entre l'adaptateur de ressources IMS TM, utilisé par votre bean Java, et IMS Connect. Cet exemple n'est pas une application à deux niveaux et seule une connexion gérée est donc applicable.
    • Les connexions gérées sont créées par une construction de l'architecture J2EE Connector appelée fabrique de connexions et gérées par le serveur d'application. Votre bean Java accède à une fabrique de connexions grâce à une interface JNDI (Java Naming and Directory Interface). Les connexions gérées sont recommandées. L'adaptateur de ressources IMS TM et le gestionnaire de connexions du serveur d'application fonctionnent conjointement afin de gérer de manière efficace les connexions en fournissant un pool de connexions et en permettant la réutilisation et la persistance des connexions.
    • Les connexions non gérées sont obtenues directement via l'adaptateur de ressources IMS, sans aucune collaboration avec le serveur d'applications. Les connexions non gérées sont généralement utilisées par des applications à deux niveaux et ne sont pas intégrées à un pool ou réutilisées. En outre, les connexions socket non gérées entre l'adaptateur de ressources IMS TM et IMS Connect ne sont pas persistantes, ce qui provoque une surcharge supplémentaire lors de l'ouverture et de la fermeture du socket pour chaque utilisation par une application.
  6. Sur la page Propriétés de connexion, en regarde de la zone de nom de la recherche JNDI, cliquez sur Nouveau. Ceci définit une nouvelle instance de serveur. Pour définir une nouvelle instance de serveur, l'adaptateur de ressources que vous avez sélectionné à l'étape 3, est déployé sur l'instance du serveur. Pour créer une nouvelle instance de serveur dans votre espace de travail, procédez comme suit :
    1. Dans l'assistant de recherche JNDI, sur la page Sélection de l'instance de serveur, sélectionnez Nouveau.
    2. Sur la page Définir un nouveau serveur, sélectionnez le type de serveur que vous souhaitez créer. Par exemple, Serveur WebSphere 6.0. Cliquez ensuite sur Suivant.
    3. Sur la page Paramètres du serveur WebSphere, acceptez les valeurs par défaut.
    4. Cliquez sur Terminer. L'adaptateur de ressources que vous avez sélectionné à l'étape 3 est déployé sur l'instance de votre serveur.
    5. Sur la page Sélection de l'instance du serveur, cliquez sur Suivant.
  7. Créez et configurez une fabrique de connexions J2C pour l'instance de serveur que vous venez de créer. L'assistant Fabriques de connexions J2C vous permet de sélectionner une fabrique de connexions J2C à partir de celles définies pour l'adaptateur de ressources sélectionné à l'étape 3. Vous pouvez également fournir le nom de recherche JNDI d'une fabrique de connexions qui n'existe pas encore et la définir ultérieurement. Pour créer et configurer une fabrique de connexions J2C pour votre instance de serveur, procédez comme suit :
    1. Sur la page Fabrique de connexions J2C, entrez un nom JND pour votre nouvelle fabrique de connexions. Par exemple, imsCFac.
    2. Configurez votre fabrique de connexions. Pour les connexions TCP/IP à IMS Connect, attribuez des valeurs un moins pour les zones suivantes :
      • Dans la zone Nom d'hôte :, entrez le nom d'hôte TCP/IP d'IMS Connect que votre application utilisera. Par exemple : MYHOST.MYCOMPANY.COM
      • Dans la zone Numéro de port :, entrez le numéro de port. Par exemple, 9999.
      • Dans la zone Nom de magasin de données :, entrez le magasin de données IMS cible. Par exemple, IMSA.
    3. Cliquez sur Terminer. L'instance du serveur est démarrée et initialisée.
  8. Après avoir configuré votre instance de serveur et que votre serveur a démarré, le nom JNDI de la fabrique de connexions s'affiche dans la zone de nom de recherche JNDI. Cliquez sur Suivant.
  9. Sur la page Propriétés de sortie du bean Java J2C, procédez comme suit :
    1. Pour le nom de projet Java, cliquez sur Nouveau.
    2. Sélectionnez Projet Java comme type de projet, et cliquez sur Suivant.
    3. Sur la page Créer un projet Java, entrez PhoneBookJ2CBean comme nouveau nom de projet Java, acceptez toutes les autres valeurs par défaut et cliquez sur Terminer.
    4. A côté du nom de package Java, cliquez sur Nouveau.
    5. Sur la page Package Java, entrez sample.ims comme nouveau nom de package Java et cliquez sur Terminer.
    6. Pour le nom d'interface, spécifiez PB.
    7. Pour le nom de liaison, acceptez la valeur par défaut de PBImpl.
    8. Cliquez sur Suivant.
  10. Pour créer une méthode qui exécute la transaction, utilisez l'assistant Méthodes Java et procédez comme suit :
    1. Cliquez sur Ajouter pour ajouter une méthode Java à votre bean Java J2C.
    2. Sur la page Ajouter une méthode Java, entrez runPB comme nom de la méthode Java puis cliquez sur Suivant.
    3. Sur la page Méthode Java, cliquez sur Parcourir en regard de la zone Type d'entrée.
    4. Dans la fenêtre Sélectionner un type de données, entrez un astérisque (*) dans la zone de saisie pour afficher les types de données disponibles.
    5. Dans la zone Types correspondant, sélectionnez INPUTMSG et cliquez sur OK pour utiliser la liaison de données INPUTMSG pour la méthode, runPB.
    6. En regard de la zone Type de sortie, cliquez sur Parcourir.
    7. Dans la fenêtre Sélectionner un type de données, entrez un astérisque (*) dans la zone de saisie pour afficher les types de données disponibles.
    8. Dans la zone Types correspondants, sélectionnez OUTPUTMSG, puis cliquez sur OK pour utiliser la liaison de données OUTPUTMSG pour la méthode, runPB.
    9. Cliquez sur Terminer.
  11. L'assistant Méthodes Java affiche une nouvelle méthode, runPB (INPUTMSG : OUTPUTMSG) dans la liste des méthodes pour le bean Java. Assurez-vous que cette méthode est sélectionnée.
  12. Dans les propriétés InteractionSpec pour 'runPB', spécifiez les valeurs IMSInteractionSpec. Pour cet exemple, acceptez toutes les valeurs par défaut puis cliquez sur Terminer.
Vous avez maintenant un bean Java J2C dans le projet, PhoneBookJ2CBean, que vous pouvez déployer sur une ou plusieurs applications J2EE en utilisant différentes ressources J2EE.

Vos commentaires