Utiliser des descripteurs de déploiement Java EE et des liaisons WebSphere pour définir les références de ressource

Cette règle marque Context <Resource> éléments trouvés dans le fichier META-INF/context.xml qui peuvent nécessiter une migration.

Apache Tomcat autorise Context <Resource> à définir à ces endroits :

• dans le fichier META-INF/context.xml,
• dans le fichier XML d'application dans le répertoire conf de Tomcat,
• :NONE. <Host> dans l'élément conf/server.xml

Etant donné que l'outil de migration n'a pas forcément accès au répertoire de configuration Tomcat, l'outil de migration ne migre que le fichier META-INF/context.xml. Vous pouvez copier les informations de ressource définies à d'autres emplacements dans le fichier META-INF/context.xml en vue de leur traitement.

Un correctif automatisé prendra les informations de la Resource et crée une référence de ressource ou une référence d'environnement de ressources, selon le cas, et un nom JNDI correspondant. Tomcat recommande, mais n'exige pas, que la référence de ressource correspondante pour la correspondant à la référence de la ressource Resource soit défini dans le WEB-INF/web.xml. Le correctif automatisé recherchera la liste des resource-ref et resource-env-ref éléments pour vérifier si l'entrée correspondant au nom existe déjà. si tel n'est pas le cas, une entrée est créée, Si les propriétés Resource possède un élément auth un attribut resource-ref est créé. Si les propriétés Resource n'a pas d'élément auth un attribut resource-env-ref est créé. Dans les deux cas, le name valeur est également utilisée comme nom JNDI et est définie dans les liaisons.

Par exemple, compte tenu de ce qui suit Resource élément à partir du META-INF/context.xml fichier :

Le correctif automatisé créera le fichier correspondant <resource-ref> élément :

Par défaut, les ressources peuvent être partagées dans Tomcat. Si la portée n'est pas n'est pas définie sur le Resource l'élément, il est défini comme partageable lorsqu'une nouvelle référence de ressource est créée pour le le correctif automatisé. Si une référence de ressource correspondante existe déjà dans le fichier WEB-INF/web.xml, aucune modification n'est apportée.

Si le projet Web est un projet Java EE 5 ou de version ultérieure et le fichier WEB-INF/web.xml n'existe pas, le fichier WEB-INF/web.xml est créé et les nouveaux éléments de référence de ressource sont ajoutés. Si le projet web se trouve à l'adresse J2EE 1.4 ou à une adresse inférieure, le correcteur automatique signalera une erreur.

Vous devez aussi configurer la ressource dans la configuration WebSphere.

Pour plus d'informations sur la définition de ressources de contexte dans Tomcat, voir :

• Apache Tomcat Référence de configuration - Définitions des ressources.