Utiliser des descripteurs de déploiement Java EE pour définir les programmes d'écoute de cycle de vie

Cette règle marque tous les éléments Context <Listener> dans le fichier META-INF/context.xml.

Dans Apache Tomcat, les objets Java qui doivent savoir si leur contexte est démarré ou arrêté sont déclarés via l'inclusion d'un élément Listener dans le contexte. Le nom de classe spécifié dans l'élément Listener implémente l'interface org.apache.catalina.LifecycleListener. Cette classe est informée de l'occurrence des événements de cycle de vie correspondants. Notez que la règle Ne pas utiliser d'API ni de packages Apache Tomcat marque les occurrences de l'utilisation de org.apache.catalina.LifecycleListener.

La fonctionnalité Java EE analogue est disponible avec javax.servlet.ServletContextListener et ServletContextEvent et les entrées Listener correspondantes dans le fichier web.xml.

Tomcat permet la définition des éléments Context <Listener> aux emplacements suivants :

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

L'outil de migration ne marque les éléments Listener que dans le fichier META-INF/context.xml. Vous pouvez copier les informations Listener définies à d'autres emplacements dans le fichier META-INF/context.xml en vue de leur traitement.

L'action recommandée consiste à convertir les fichiers Java qui utilisent org.apache.catalina.LifecycleListener pour qu'ils utilisent javax.servlet.ServletContextListener et que les entrées de programme d'écoute appropriées soient ajoutées au fichier web.xml de l'application.

Pour plus d'informations sur les programmes d'écoute de cycle de vie de servlet, voir :

• Section Servlet Life Cycle dans le tutoriel Java EE 6.

Pour plus d'informations sur les programmes d'écoute de cycle de vie dans Tomcat, voir :

• Apache Tomcat Configuration Reference - Lifecycle Listeners.