Création d'un bean J2C pour la connexion à IMS

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.

Pourquoi et quand exécuter cette tâche

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 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 J2C utilise l'interface CCI fournie par l'adaptateur de ressources IMS TM pour communiquer avec IMS.

Procédure

  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 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 voulez utiliser. Vous pouvez sélectionner IMS Connector for Java (IBM: 10.5.x) ou IMS Connector for Java (IBM: 11.3.0) et cliquer sur Suivant.
  4. Sur la page Propriétés de connexion, sélectionnez 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. IMS TM Resource Adapter 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.
  5. 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 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 voulez créer, par exemple Serveur WebSphere 7.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.
  6. Créez et configurez une fabrique de connexions J2C pour l'instance de serveur que vous avez créée. L'assistant Fabriques de connexions J2C vous permet de sélectionner une fabrique de connexions J2C à partir de celles qui ont été 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 JNDI 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 au 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.
  7. 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.
  8. Sur la page Propriétés de sortie du bean 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. En regard 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.
  9. 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 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.
  10. 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.
  11. 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.

Résultats

Vous avez maintenant un bean J2C dans le projet, PhoneBookJ2CBean, que vous pouvez déployer sur une ou plusieurs applications Java EE en utilisant différentes ressources Java EE.

Commentaires