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> éléments à définir dans ces emplacements:

dans le fichier META-INF/context.xml,
dans le fichier XML d'application dans le répertoire conf de Tomcat,
:NONE. <Host> dans le fichier 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 fichier META-INF/context.xml afin d'être traitées.

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:

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 L'attribut name est utilisé pour la res-ref-name dans web.xml
:NONE. ResourceLink L'attribut type est utilisé pour la res-type dans web.xml
:NONE. ResourceLink L'attribut global est utilisé pour l'attribut global binding-name dans le fichier de liaison IBM
:NONE. res-auth est défini sur Container
:NONE. res-sharing-scope est défini sur Shareable

Notez que l'autre ResourceLink Les attributs (fabrique, nom d'utilisateur et mot de passe) ne sont pas migrés automatiquement. Si votre application utilise ces attributs dans un ResourceLink , puis vous devrez créer une ressource unique dans la configuration du serveur, fournir à la ressource un nom JNDI unique et mettre à jour la Fichier de liaison 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, un fichier META-INF/Context.xml contenant les éléments suivants ResourceLink :

Le correctif automatisé mettra à jour ou créera un nouveau resource-ref dans le fichier web.xml similaire à l'exemple suivant:

< span class="Code"> < resource-ref id= "ResourceRef_1313785392722">
<res-ref-name>jdbc /SampleWeb</res-ref-name>
<res-type>javax.sql.DataSource</res-type>
<res-auth>Conteneur</res-auth>
<res-sharing-scope>Partagable</res-sharing-scope>
</resource-ref>

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 Configuration Reference - Resource Links.