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

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

Apache Tomcat autorise Context <ResourceLink> à 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. ResourceLink les informations définies dans les autres emplacements peuvent être copiées dans le META-INF/context.xml pour qu'elles puissent être traitées pour qu'il soit traité.

Le correctif automatisé utilisera les informations contenues dans le ResourceLink et crée une référence de ressource et un nom JNDI correspondant comme suit JNDI correspondant, comme suit :

• Le correctif automatisé recherchera dans la liste des resource-ref si l'entrée correspondant au nom existe déjà. si tel n'est pas le cas, une entrée est créée,
• :NONE. ResourceLink est utilisé pour l'attribut res-ref-name en web.xml
• :NONE. ResourceLink est utilisé pour l'attribut de type res-type en web.xml
• :NONE. ResourceLink est utilisé pour l'attribut global binding-name dans le fichier de liaison IBM
• :NONE. res-auth est fixé à Container
• :NONE. res-sharing-scope est réglé sur Partageable

Il convient de noter que les autres ResourceLink (usine, nom d'utilisateur et mot de passe) ne sont pas automatiquement migrés. Si votre application utilise ces attributs dans a ResourceLink vous devez alors créer une ressource unique dans la configuration du serveur, fournir à la ressource un nom JNDI unique et mettre à jour le fichier de IBM avec le nouveau nom JNDI.

Si le projet Web est un projet Java EE 5 ou de version ultérieure et que 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 lien vers des ressources 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.

Par exemple, étant donné un META-INF/Context.xml contenant les suivantes ResourceLink :

Le correctif automatisé mettra à jour ou créera un nouveau resource-ref dans le fichier web.xml comme dans cet exemple :

Le nom JNDI est ajouté au fichier de liaison IBM. Il référence la référence existante définie dans web.xml. Si le fichier de liaison n'existe pas, il est créé.

Vous devez aussi configurer la ressource dans la configuration de WebSphere Application Server.

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

• Apache Tomcat Référence de configuration - Liens de ressources.