Déploiement des applications SQLJ qui utilisent la persistance gérée par conteneur (CMP) avec l'outil ejbdeploy

Intégrez des instructions SQLJ (Structured Query Language in Java™) dans vos applications pour optimiser l'efficacité de vos transactions avec vos bases de données. Avant que vos applications ne puissent profiter du langage SQL pour Java, vous devez les déployer et personnaliser les profils SQLJ créés. Le serveur d'applications fournit des outils d'utilisation de SQLJ en tant que mécanisme de persistance pour les beans enterprise utilisant la persistance gérée par conteneur. Utilisez l'outil ejbdeploy pour déployer l'application.

Pourquoi et quand exécuter cette tâche

Vous pouvez déployer les applications SQLJ à l'aide de l'outil ejbdeploy afin de déployer l'application d'entreprise dans un environnement autonome.
Sinon, le serveur d'applications comprend la prise en charge améliorée du langage SQL pour Java pour les applications qui utilisent la persistance gérée par conteneur (CMP). Voici quelques-unes des nouvelles fonctions :
  • Déploiement de beans CMP lors de l'installation de l'application dans le serveur d'applications.
  • Personnalisation et liaison de profils SQLJ à l'aide de la console d'administration ou par scriptage.
  • Nouvelle personnalisation et liaison d'applications SQL pour Java sans avoir à réinstaller l'application.
Ces améliorations réduisent la complexité de l'installation, du déploiement et de la personnalisation des applications SQL pour Java pour la persistance gérée par le bean et la persistance gérée par conteneur. Pour plus d'informations, consultez la rubrique relative au déploiement des applications SQLJ qui utilisent la persistance gérée par conteneur.

Procédure

  1. Créez un mappage descendant à une base de données DB2.
  2. A partir de votre installation de DB2, copiez le fichier sqlj.zip dans un répertoire de votre poste de travail.
  3. Modifiez le chemin de génération Java du projet de fichier JAR de votre bean enterprise de sorte qu'il comporte le fichier sqlj.zip.
  4. Utilisez Rational Application Developer ou l'outil de conversion SQLJ de DB2 pour convertir automatiquement le langage SQL pour Java.
    • Utilisez Rational Application Developer :
      1. Dans le navigateur de projets, sélectionnez NOM_PROJET_JAR_EJB > DOSSIER_SOURCE > META-INF > backends > version_base de données.
      2. Ouvrez le fichier Map.mapxmi dans l'éditeur de mappage.
      3. Dans le panneau de présentation, sélectionnez le nom de votre projet JAR dans la colonne Beans enterprise. Vous devez sélectionner le nom du projet JAR, et non le nom de l'un des beans enterprise répertoriés.
      4. Dans le panneau Propriétés, développez SQLJ.
      5. Associez utilise SQLJ ? à la valeur True.
      6. Pour Module du traducteur, indiquez le chemin d'accès complet au fichier sqlj.zip de votre poste de travail.
      7. Sauvegardez le fichier Map.mapxmi.
      8. Exportez le fichier EAR (archive d'entreprise).
    • Utilisez l'outil de conversion SQLJ de DB2. Cet outil crée une version .java de votre fichier .sqlj, ainsi qu'un profil sérialisé, avec une extension .ser, qui sera utilisé ultérieurement lors du traitement. Pour plus d'informations sur l'outil de conversion SQLJ, consultez la documentation DB2.
  5. Déployez le fichier EAR à l'aide de l'outil ejbdeploy.
    1. Vérifiez que le répertoire racine_serveur_app/bin figure dans votre chemin d'accès aux classes.
    2. Exécutez l'utilitaire de commande ejbdeploy avec l'option -sqlj. La commande ejbdeploy génère un fichier EAR dont vous spécifiez le nom, ainsi qu'un script Ant nommé nom_application.ear.xml.
      Par exemple :
      ejbdeploy d:\nom_application.ear           
                working d:\deployed_nom_application.ear 
                -sqlj           
                -dbvendor DB2UDB_V81           
                -cp "C:\PROGRA~1\IBM\SQLLIB\java\sqlj.zip"
      Eviter les incidents Eviter les incidents: Fournissez l'emplacement du fichier sqlj.zip avec -cp (option du chemin d'accès aux classes) de l'outil de conversion SQLJ. La commande ejbdeploy n'accède pas au fichier sqlj.zip à partir du chemin d'accès aux classes de votre système.gotcha
  6. Sélectionnez l'option de personnalisation.
    • Utilisez la prise en charge SQLJ du serveur d'applications. Installez l'application déployée afin de personnaliser les profils SQLJ avec le serveur d'applications ou les scripts.
      1. Installez l'application d'entreprise dans le serveur d'applications.
        Eviter les incidents Eviter les incidents: Ne sélectionnez pas Déploiement de beans enterprise lors du processus d'installation de l'application dans la console d'administration. Si vous redéployez les beans enterprise à partir de la console d'administration, vous perdrez les modifications de personnalisation que vous avez apportées.gotcha
      2. Personnalisez les profils SQLJ.
        • Pour la prise en charge de la console d'administration, consultez la rubrique relative à la personnalisation et à la liaison des profils dans les applications SQL pour Java (SQLJ).
        • Pour la prise en charge des scripts, consultez la rubrique relative aux groupes de commandes de gestion des applications de l'objet AdminTask.
    • Personnalisez et liez les profils SQLJ à l'aide de l'outil db2sqljcustomize. Consultez la rubrique relative à la personnalisation et à la liaison des profils SQLJ avec l'outil db2sqljcustomize.

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