Cette règle marque les éléments Context <Resource> trouvés dans le fichier META-INF/context.xml et qu'il peut être nécessaire de migrer.
Apache Tomcat permet la définition des éléments Context <Resource> aux emplacements suivants :
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 rapide est disponible dans le scanner de source. Le correctif rapide utilise les informations provenant des éléments Resource pour créer une référence de ressource ou d'environnement de ressource, selon les besoins, et un nom JNDI correspondant. Tomcat recommande, mais ne requiert pas, que la référence de ressource correspondante pour l'élément Resource soit définie dans le fichier WEB-INF/web.xml. Le correctif rapide effectue une recherche dans la liste des éléments resource-ref et resource-env-ref pour déterminer si l'entrée qui correspond au nom existe déjà. Si tel n'est pas le cas, une entrée est créée. Si l'élément Resource possède un attribut auth, un élément resource-ref est créé. Si l'élément Resource ne possède pas d'attribut auth, un élément resource-env-ref est créé. Dans les deux cas, la valeur name est utilisée comme nom JNDI et est définie dans les liaisons.
Par exemple, pour l'élément Resource dans le fichier META-INF/context.xml :|
<Resource name="jdbc/exampleDB" auth="Container" type="javax.sql.DataSource" description="Base de données exemple"> |
|
<resource-ref> <description> Base de données exemple</description> <res-ref-name>jdbc/exampleDB</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref> |
Par défaut, les ressources peuvent être partagées dans Tomcat. Si la portée n'est pas définie dans l'élément Resource, elle peut être associée à la valeur Shareable lorsqu'une nouvelle référence de ressource est créée pour le correctif rapide. 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 est un projet J2EE 1.4 ou de version antérieure, le correctif rapide signale 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 :