Création ou modification d'une référence de ressource

Une référence de ressource permet à un fournisseur d'application d'accéder à une ressource (telle qu'une source de données, une URL ou un fournisseur JavaMail) en utilisant dans l'environnement d'exécution un nom logique et non le vrai nom de la ressource. Vous n'avez ainsi pas besoin de modifier le code d'application lorsque vous modifiez les configurations d'exécution de ressource.

Avant de commencer

Cette rubrique vous guide dans la mise à jour des références de ressources d'une application d'entreprise précédemment assemblée. La rubrique "Assemblage des applications" détaille la procédure d'assemblage.

Pourquoi et quand exécuter cette tâche

Les références de ressources sont déclarées dans le descripteur de déploiement par le fournisseur d'application. A un certain stade du processus de déploiement de l'application, vous devez lier la référence de ressource au nom proprement dit de la ressource dans l'environnement d'exécution. Lorsque vous créez une fabrique de connexions ou une source de données dans le serveur d'applications, ce dernier fournit un nom JNDI qu'un composant peut utiliser pour accéder à cette fabrique de connexions ou à cette source de données. Le serveur d'applications utilise un nom indirect avec le préfixe java:comp/env. Par exemple :
  • Lorsque vous créez une source de données, le nom JNDI par défaut est jdbc/nom_source_données.
  • Lorsque vous créez une fabrique de connexions, son nom par défaut est eis/nom_fabrique_connexions_j2c.
Si vous substituez une valeur personnalisée à ces valeurs, conservez le préfixe java:comp/env . Un nom JNDI indirect permet à l'infrastructure de gestion des connexions d'accéder à toutes les données de la référence de ressource associées à l'application. Cela vous permet de mieux gérer les ressources en fonction des paramètres d'authentification, de niveau d'isolement, de portée de partage et de contrôle de résolution.

Cette rubrique décrit comment mettre à jour les références de ressources d'une application d'entreprise à l'aide d'un outil d'assemblage. Après avoir défini la référence de ressource, vous pouvez procéder à une recherche JNDI JNDI indirecte à l'aide du contexte java:comp/env.

Procédure

  1. Démarrez un outil d'assemblage.
  2. Si vous ne l'avez pas encore fait, configurez l'outil d'assemblage afin qu'il fonctionne avec les modules Java EE (Java Platform, Enterprise Edition).
  3. Importez l'application d'entreprise (fichier EAR) que vous voulez modifier dans le projet EJB.
  4. Affichez les références de ressources correspondant au type du module :
    • Si un Enterprise JavaBean (EJB) utilise la référence de ressource :
      1. Développez le nom du fichier EAR.
      2. Développez la branche Modules EJB.
      3. Développez la branche du module EJB concerné.
      4. Développez la section correspondant à la nature de l'EJB (Beans session ou Beans entity).
      5. Développez la branche de l'EJB.
    • Si un servlet utilise la référence de ressource :
      1. Développez le nom du fichier EAR.
      2. Développez la branche Modules Web.
      3. Développez la branche du module Web concerné.
    • Si un client d'application utilise la référence de ressource :
      1. Développez le nom du fichier EAR.
      2. Développez la branche Clients d'application.
      3. Développez la branche du module client d'application concerné.
  5. Cliquez avec le bouton droit de la souris sur le module dont vous voulez modifier les références de ressources, puis sélectionnez Ouvrir avec > Editeur de descripteur de déploiement.
  6. Pour les servlets et clients d'application, cliquez sur Ajouter. Pour les modules EJB, sélectionnez le bean particulier et cliquez sur Ajouter.
  7. Sélectionnez l'option de référence de ressource et cliquez sur Suivant.
  8. Indiquez les paramètres de la référence de ressource, puis cliquez sur Terminer.
  9. Facultatif : Sélectionnez l'onglet Références et, sous Extensions WebSphere, sélectionnez un niveau d'isolation. Si vous choisissez de ne pas effectuer cette étape, le niveau d'isolation devient par défaut TRANSACTION_NONE.
  10. Facultatif : Sous Liaisons WebSphere, spécifiez un nom JNDI. Si vous décidez de ne pas effectuer cette étape, vous pouvez définir la liaison (ou la remplacer) lorsque l'application est déployée.
  11. Fermez l'éditeur de descripteur de déploiement et sauvegardez vos modifications.

Résultats

Les fichiers du module mis à jour sont affichés dans la vue Explorateur de projets.

Que faire ensuite

Vérifiez le contenu de l'application d'entreprise mis à jour dans la vue Explorateur de projets. Puis, déployez votre application d'entreprise.

Vous pouvez générer le code de déploiement EJB et déployer un module EJB vers un serveur cible en une étape. Dans la vue Explorateur de projets, cliquez avec le bouton droit de la souris sur le projet EJB, puis sélectionnez Déployer. Déploiement de modules EJB.


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=tatk_crtresref
Nom du fichier : tatk_crtresref.html