Paramètres des métadonnées pour des modules

Utilisez cette page pour indiquer à un descripteur de déploiement Java Platform, Enterprise Edition (Java EE) enterprise bean (EJB), un descripteur de déploiement de module Web ou un module JCA resource adapter archive (RAR) qu'il doit ignorer les annotations spécifiant des informations de déploiement.

Pour afficher cette page de la console d'administration, cliquez sur Applications > Types d'application > WebSphere Enterprise Applications > nom_application > Métadonnées pour des modules. Cette page est identique à la page Métadonnées pour les modules des assistants d'installation et de mise à jour des applications.

Si votre application contient des modules Java EE 5 ou d'une version ultérieure, vous pouvez choisir de verrouiller le descripteur de déploiement d'un ou de plusieurs modules dans la page Métadonnées pour des modules. Si vous cochez une case attribut metadata-complete (si vous définissez l'attribut metadata-complete sur true) et si vous verrouillez les descripteurs de déploiement, le produit consigne la totalité du descripteur du module, notamment les informations de déploiement provenant des annotations, au format XML.

Les annotations sont un mécanisme standard permettant d'ajouter des métadonnées à des classes Java. Vous pouvez utiliser des métadonnées pour simplifier le développement et le déploiement d'artefacts Java EE 5 ou de versions ultérieures. Avant la création des annotations Java, les descripteurs de déploiement constituaient le mécanisme standard utilisé par les composants Java EE. Ces descripteurs de déploiement étaient mappés au format XML, ce qui facilitait leur conservation. Si vous choisissez de verrouiller les descripteurs de déploiement, le produit fusionne les métadonnées provenant d'annotations Java EE avec les métadonnées des descripteur de déploiement basés sur XML existants et conserve les résultats.

Lorsque des applications contiennent un grand nombre de classes Java, le temps de traitement du déploiement des annotations peut augmenter. Pour minimiser l'impact sur les performances, vous pouvez utiliser l'une des méthodes suivantes :

Déterminez si le module doit utiliser Java EE 5 ou 6. S'il n'a pas besoin d'utiliser Java EE 5 ou 6, les annotations des classes Java ne sont pas analysées.
Utilisez l'Attribut metadata-complete du descripteur de module si le module utilise Java EE 5 ou une version ultérieure et ne contient pas d'annotation. Cet attribut désactive le traitement des annotations pour le module, mais les modules Java EE 5 ou de version ultérieure peuvent toujours être placés dans le fichier de descripteur. Si vous migrez votre application, mais que vous n'ajoutez pas d'annotations, vous pouvez envisager d'utiliser cette valeur d'attribut.
Restructurez l'application pour placer les fichiers JAR de l'utilitaire dans des bibliothèques partagées si ces fichiers JAR ne contiennent pas d'informations d'annotation. Envisagez cette méthode si vous ne pouvez pas définir l'Attribut metadata-complete.
Déplacez les fichiers JAR contenus dans le répertoire WEB-INF/lib vers le répertoire racine du fichier d'archive d'entreprise. Il n'est pas facile d'effectuer des recherches dans les archives imbriquées, telles qu'un fichier JAR dans un fichier WAR (web application archive) se trouvant dans un fichier EAR en raison des niveaux de compression multiple.

Module

Indique le nom d'un module dans l'application installée (ou déployée).

Informations	Valeur
Type de données	Chaîne

URI

Indique l'emplacement du module par rapport à la racine du fichier EAR.

Informations	Valeur
Type de données	Chaîne

Attribut metadata-complete

Indique s'il faut écrire le descripteur de déploiement complet du module, y compris les informations de déploiement issues des annotations, au format XML.

Par défaut, aucune case attribut metadata-complete n'est cochée et le produit ne consigne aucune donnée d'annotation dans un descripteur de déploiement de module.

Si vos modules ne possèdent pas l'attribut metadata-complete ou si l'attribut metadata-complete a la valeur false, vous pouvez cocher une case indiquant au produit de consigner les données d'annotation dans un descripteur de déploiement de module.

Eviter les incidents : Si votre application Java EE version 5 ou ultérieure utilise des annotations et une bibliothèque partagée, ne sélectionnez pas l'attribut metadata-complete. Lorsque l'application utilise des annotations et une bibliothèque partagée, si vous affectez à l'attribut metadata-complete la valeur true, le produit représente de manière incorrecte une annotation @EJB dans le descripteur de déploiement sous la forme <ejb-ref>> au lieu de <ejb-local-ref>>. Pour les modules Web, quand vous affectez à l'attribut metadata-complete la valeur true, il se produit des erreurs InjectionException. Si vous devez sélectionner attribut metadata-complete (définir l'attribut metadata-complete sur true), vous pouvez éviter d'éventuelles erreurs en n'utilisant pas directement la bibliothèque partagée, mais en la plaçant dans le répertoire classes ou lib du serveur d'applications, ou encore en définissant intégralement les métadonnées dans les descripteurs de déploiement.gotcha

Après avoir coché une case, vous ne pouvez plus la décocher et le module n'apparaît plus dans la liste des modules de cette page. Si vous cochez toutes les cases, le lien menant à cette page n'apparaît plus sur la page Paramètres des applications d'entreprise.

Informations	Valeur
Type de données	Booléen
Valeur par défaut	false (non sélectionné)

Nom du fichier : urun_rapp_metadata_lockdd.html