Développement J2EE - Notes sur l'édition

1.0 Introduction
2.0 Problèmes connus
   2.1 Ajout de fichiers de module à un projet d'application d'entreprise
   2.2 Eléments ald-dd (descripteurs de déploiement secondaires) dans les applications d'entreprise)
   2.3 Paramètres du chemin de compilation Java des projets EJB/Web/Client d'application
   2.4 Les espaces ne sont pas pris en charge dans les URI d'un fichier JAR d'un projet EAR
   2.5 Les noms de projet d'application d'entreprise ne doivent pas contenir de caractères DBCS
   2.6 Les projets binaires sont en lecture seule
   2.7 Création multiple d'exemples
   2.8 Mises à jour du chemin de compilation Java lors de la suppression de la dépendance sur un fichier JAR d'utilitaire
   2.9 La page Dépendance JAR Java ne parvient pas à mettre à jour le chemin de compilation Java
   2.10 Suppression automatique des liaisons WebSphere
   2.11 Prise en charge des tâches J2EE ANT
   2.12 Verrouillage de ressources dû à une validation JSP
   2.13 Réservation automatique à partir de ClearCase lors de l'importation et le remplacement de fichiers existants
   2.14 Erreur 'Description de projet non valide' lors de l'utilisation d'un emplacement de projet autre que celui par défaut pour un nouveau projet J2EE
   2.15 Support Ant sans en-tête J2EE : Application com.ibm.etools.j2ee.ant.RunAnt

1.0 Introduction

La perspective J2EE contient les vues à utiliser pour le développement des ressources des projets d'application d'entreprise, des projets EJB et des projets Web. Le présent fichier Readme décrit certains problèmes et restrictions connus, ainsi que les solutions associées aux outils de développement J2EE dans WebSphere Studio. Certains autres éléments associés aux vues J2EE et aux projets Web J2EE sont illustrés dans le fichier Readme des outils Web.

2.0 Problèmes connus

2.1 Ajout de fichiers de module à un projet d'application d'entreprise

Lorsque vous importez un des types de fichier de module (fichier EJB JAR, WAR, RAR et de client d'application) dans un projet d'application d'entreprise, vous devez utiliser l'assistant d'importation correct et importer le fichier de module dans le type de projet approprié. N'effectuez pas l'importation dans le projet d'application d'entreprise. Si le fichier de module est importé dans le projet d'application d'entreprise, vous ne pourrez pas ajouter le module à l'application à l'aide de l'éditeur de descripteur de déploiement d'applications.

2.2 Eléments ald-dd (descripteurs de déploiement secondaires) dans les applications d'entreprise

La fonction alt-dd n'est pas prise en charge dans WebSphere Studio. Vous devez éditer les descripteurs de déploiement des modules contenus.

2.3 Paramètres du chemin de compilation Java des projets EJB/Web/Client d'application

Lorsque cela est possible, il est recommandé d'accepter les paramètres par défaut du chemin de compilation Java des types de projet J2EE. Pour configurer les dépendances entre les projets de l'application d'entreprise, utilisez plutôt l'éditeur Dépendances JAR pou la page de propriétés Dépendances JAR Java. L'attribut Chemin d'accès aux classes du fichier MANIFEST.MF (utilisé pour l'exécution du serveur) est ainsi synchronisé avec le chemin de compilation Java du projet (utilisé pour la compilation Java).

En général, les bibliothèques requises par un module doivent se trouver dans l'application d'entreprise ou être visibles depuis le serveur. Vous devez donc être prudent lorsque vous ajoutez des bibliothèques externes au chemin de compilation du projet, car ce projet risque de ne pas fonctionner sur le serveur. Supposons par exemple que vous vouliez référencer la bibliothèque off_the_shelf.jar dans un module WEB. Deux possibilités s'offrent à vous :

  1. Vous pouvez ajouter le fichier off_the_shelf.jar à l'application d'entreprise à l'aide de l'assistant d'importation du système de fichiers, puis utiliser l'éditeur Dépendances JAR pour que le module WEB dépende du fichier JAR ou
  2. Utiliser les propriétés du chemin de compilation Java du projet WEB pour ajouter le fichier JAR au chemin de compilation ; le serveur doit alors avoir accès au fichier JAR.

Pour appliquer cela à l'unité de test, éditez la configuration du serveur et ajoutez le fichier JAR au chemin des classes.

2.4 Les espaces ne sont pas pris en charge dans les URI d'un fichier JAR de projet EAR

Les espaces ne sont pas pris en charge dans les URI des fichiers JAR des modules ou utilitaires d'une application d'entreprise. L'attribut "Class-Path:" d'un fichier MANIFEST.MF d'un fichier JAR ou d'un module correspond à une liste de chemins relatifs d'un projet EAR dans laquelle les chemins sont séparés les uns des autres par un espace. Un fichier JAR ne peut pas référencer un autre fichier JAR du projet EAR si l'URI du fichier JAR référencé contient des espaces.

2.5 Les noms de projet d'application d'entreprise ne doivent pas contenir de caractères DBCS

Lorsque vous créez un projet d'application d'entreprise, il est recommandé de ne pas lui attribuer un nom comportant des caractères DBCS.

2.6 Les projets binaires sont en lecture seule

Les projets binaires créés par l'importation d'un fichier EAR (option disponible dans l'assistant d'importation) sont conçus de manière à être en lecture seule. Vous ne devez pas essayer de modifier le contenu d'un projet binaire. Toutefois, vous pouvez supprimer le projet binaire et le remplacer par une version source provenant d'un référentiel. La plupart des actions doivent être désactivées pour les projets binaires. Si vous utilisez des projets binaires, évitez les actions qui modifient le contenu du projet ou du fichier JAR.

2.7 Création multiple d'exemples

Pour créer plusieurs instances d'exemples d'application d'entreprise intégrés, il est nécessaire de renommer l'exemple de projet existant, ainsi que tous ses projets de module avant d'importer l'exemple à nouveau. Si vous ne suivez pas cette procédure, la deuxième importation remplacera les projets de module sans avertissement.

Dans la vue Hiérarchie J2EE, cliquez à l'aide du bouton droit de la souris sur chaque module à renommer et sélectionnez Renommer. Dans la boîte de dialogue qui s'affiche, entrez le nouveau nom et sélectionnez les options Renommer le module dans toutes les applications d'entreprise et Renommer les dépendances de modules qui font référence au projet sélectionné. Il est important d'utiliser l'option Renommer de la vue hiérarchie J2EE et de sélectionner ces deux options pour que les interdépendances du module ne soient pas modifiées.

2.8 Mises à jour du chemin de compilation Java lors de la suppression de la dépendance sur un fichier JAR d'utilitaire

Lors de la suppression de la dépendance d'un fichier JAR d'utilitaire, le projet Java correspondant n'est supprimé du chemin de compilation Java que si le fichier JAR dépendant est toujours référencé par le projet EAR.

Créez par exemple un projet EAR et un projet Web J2EE 1.3 avec l'exemple de projet Java JUnit. Ajoutez ensuite le projet JUnit comme fichier JAR d'utilitaire dans le projet EAR, puis ajoutez le projet JUnit comme dépendance JAR Java du projet Web.

Si vous voulez alors supprimer la dépendance entre le projet JUnit et le projet Web, supprimez d'abord la dépendance JAR Java du projet Web, puis supprimez le fichier JAR d'utilitaire du projet EAR. Suivez bien cette séquence pour que la procédure fonctionne correctement.

2.9 La page Dépendance JAR Java ne parvient pas à mettre à jour le chemin de compilation Java

La page Dépendances JAR Java n'est pas synchronisée avec la page du chemin de compilation Java dans la boîte de dialogue des propriétés du projet. Par conséquent, une modification appliquée dans l'une de ces pages risque de ne pas être prise en compte dans l'autre page (dans une même session de boîte de dialogue).

Par ailleurs, dans certains cas, lors du passage d'une page à une autre, la mise à jour effectuée dans une page peut annuler celle d'une autre page, lorsque le bouton OK est activé ou que le bouton Valider est sélectionné avant le bouton OK. En général, une dépendance JAR semble avoir été ajoutée sans que le projet n'ait été ajouté au chemin de compilation Java.

La solution consiste à rouvrir les boîtes de dialogue des propriétés, de passer à la page des dépendances JAR, à désélectionner, puis à resélectionner les fichiers JAR dépendants et à appuyer sur OK.

2.10 Suppression automatique des liaisons WebSphere

Lorsque vous supprimez un objet qui contient des liaisons WebSphere, l'objet de liaison est automatiquement supprimé. Par exemple, si vous supprimez un rôle de sécurité avec ses liaisons de la page Sécurité de l'éditeur de descripteur de déploiement d'applications, les liaisons du rôle de sécurité sont également supprimées. Si vous ajoutez alors un rôle de sécurité ayant le même nom, n'oubliez pas de le lier à nouveau si nécessaire.

2.11 Prise en charge des tâches J2EE ANT

Dans les versions 4.x, des tâches Ant et J2EE supplémentaires de l'espace de travail étaient disponibles en téléchargeant un fichier zip (com.ibm.ant.extras.zip) du Web. Ces tâches sont maintenant fournies dans le produit de base du plug-in com.ibm.etools.j2ee.ant.

Si vous disposez de compilations ANT basées sur l'ancien plug-in, vous devez les migrer en raison des modifications suivantes apportées aux versions 4.0.x :

  1. Les plug-in n'étant plus nommés "extra" comme c'était le cas lorsqu'ils étaient téléchargés pour les versions 4.0.x, l'exemple de fichier runAnt.bat utilisé pour une exécution sans en-tête a été mis à jour. L'ID de l'application de démarrage n'est plus "com.ibm.ant.extras.RunAnt", mais "com.ibm.etools.j2ee.ant.RunAnt". Les fichiers .bat existants utilisés pour démarrer l'espace de travail sans en-tête doivent être modifiés.
  2. La tâche utilJAR est maintenant déconseillée. Elle n'a été conservée que pour une question de compatibilité ; le support util JAR de l'éditeur d'applications doit être utilisé à sa place. En outre, la tâche a été simplifiée et certains paramètres ne sont plus applicables. Reportez-vous à la documentation sur les tâches pour plus d'informations.
  3. Un paramètre a été ajouté à la tâche d'exportation des ear, pour inclure le nouvel indicateur pris en charge par l'assistant, qui inclut les fichiers méta du projet lors de l'exportation. Cela est utile pour les projets binaires. Pour plus d'informations sur l'optimisation du développement à l'aide de projets binaires, reportez-vous à la documentation du produit.
  4. Le paramètre "use35rules" de la tâche EJBDeploy a été renommé "compatible35".

2.12 Suppression de ressources dû à une validation JSP

Si un projet Web a été récemment validé par le valideur JSP, des fichiers JAR de bibliothèque ou des fichiers de classe auxquels ce projet fait référence peuvent encore être en cours d'utilisation. Par conséquent, vous ne pourrez peut-être pas déplacer des fichiers de classe ou JAR (par exemple, si vous voulez supprimer le répertoire /WEB-INF/lib). Si un fichier JAR se trouvant dans un projet EAR est référencé par un projet Web en tant que dépendance Java JAR, il peut ne pas être possible de supprimer le projet EAR ou le fichier JAR se trouvant dans ce dernier. Pour "libérer" ces ressources afin de les utiliser dans des activités de gestion de fichiers, fermez le projet Web puis ouvrez-le à nouveau.

2.13 Réservation automatique à partir de ClearCase lors de l'importation et du remplacement de fichiers existants

Lorsque vous importez un module J2EE et que vous choisissez de remplacer les fichiers existants se trouvant dans ClearCase, il est nécessaire de libérer les fichiers avant de pouvoir les remplacer. Dès que l'importation détecte un fichier ou des fichiers dans ClearCase, une fenêtre d'avertissement s'affiche vous demandant de tenter de libérer les fichiers concernés. Si vous cliquez sur l'option permettant de sélectionner tous les fichiers, WebSphere Studio tente de libérer automatiquement les fichiers concernés ainsi que d'autres fichiers réservés rencontrés ultérieurement lors de l'opération d'importation.

2.14 Erreur 'Description de projet non valide' lors de l'utilisation d'un emplacement de projet autre que celui par défaut pour un nouveau projet J2EE

Lorsque vous créez un projet J2EE (incluant les projets Java, d'application d'entreprise, Web, EJB, client d'application et de connecteur), vous ne pouvez pas utiliser d'emplacement de projet déjà utilisé par un autre projet du plan de travail. Si vous choisissez un emplacement de projet utilisé par un autre projet, l'assistant affiche un message ou une boîte de dialogue d'erreur "Description de projet non valide". Si après réception de ce message, vous sélectionnez un emplacement de projet valide en cliquant sur Parcourir, la création du projet n'aboutira pas. Pour résoudre ce problème, il suffit de cliquer sur Annuler et d'ouvrir à nouveau l'assistant de création de projet.

2.15 Support Ant sans en-tête J2EE : Application com.ibm.etools.j2ee.ant.RunAnt

Lorsque vous exécutez des tâches Ant J2EE ou EJB, utilisez l'application com.ibm.etools.j2ee.ant.RunAnt et non l'application org.eclipse.ant.core.antRunner.

L'utilisation de RunAnt comporte deux avantages :

Retour au fichier Readme principal