Servlet/JSP - Éléments du descripteur de déploiement (web.xml)

Servlet/JSP | Éléments du descripteur de déploiement (web.xml)

Éléments de <servlet>
1. <servlet-name>
2. <servlet-class>

Éléments de <servlet>
<servlet> [0 ou plusieurs] <description> [0 ou plusieurs] <display-name> [0 ou plusieurs] <icon> [0 ou plusieurs] <small-icon> [0 ou 1] <large-icon> [0 ou 1] <servlet-name> [toujours 1] <servlet-class> | <jsp-file> [toujours 1] <init-param> [0 ou plusieurs] <description> [0 ou 1] <param-name> [toujours 1] <param-value> [toujours 1] <load-on-startup> [0 ou 1] <run-as> [0 ou 1] <description> [0 ou plusieurs] <role-name> [toujours 1] <security-role-ref> [0 ou plusieurs] <description> [0 ou plusieurs] <role-name> [toujours 1] <role-link> [0 ou 1]
Important : L'ordre des éléments dans <servlet> est important.
1. <servlet-name>
  L'élément <servlet-name> définit un nom logique pour la servlet.
  Ce nom peut être utilisé par les requêtes http par exemple; le conteneur Web va charger la classe de la servlet associée à ce nom.
  
  Notes :
  - Le nom doit être unique pour l'application web (fichier web.xml).
  - Le nom peut être différent du nom de la classe Java.
  
  <servlet> <servlet-name>MyServlet1Name1</servlet-name> <servlet-class>com.mtitek.servlets.test1.MyServlet1</servlet-class> </servlet>
  Note: La méthode getServletName(), définie dans l'interface ServletConfig et implémentée dans GenericServlet, donne la valeur de cet élément (MyServlet1Name1).
2. <servlet-class>
  L'élément <servlet-class> définit le nom complet (y compris le nom du package) d'une classe servlet.
  
  Notes:
  - les parties du nom du package doivent être séparés par des points (com.mtitek.servlets.test1.).
  - le nom de la classe ne doit pas avoir l'extension .class.
  <servlet> <servlet-name>MyServlet1Name1</servlet-name> <servlet-class>com.mtitek.servlets.test1.MyServlet1</servlet-class> </servlet> <servlet> <servlet-name>MyServlet1Name2</servlet-name> <servlet-class>com.mtitek.servlets.test1.MyServlet1</servlet-class> </servlet>
  Comme montré dans l'exemple ci-dessus, la valeur de l'élément <servlet-class> n'a pas besoin d'être unique ; la classe "com.mtitek.servlets.test1.MyServlet1" a deux noms différents (MyServlet1Name1 & MyServlet1Name2).
  
  Ceci est important quand on a besoin de :
  - forcer le conteneur Web à exécuter une instance séparée de la servlet (sinon le conteneur Web peut décider d'utiliser la même instance de la servlet (recyclage) pour traiter différentes requêtes qui ciblent le même nom logique d'une servlet).
  - fournir des paramètres d'initialisation différents à une servlet.
  
  La méthode getServletName() peut être utilisée pour savoir quelle instance est en cours d'exécution.
  
  Note: La classe doit étendre HttpServlet (ou GenericServlet) sinon vous obtiendrez une erreur lorsque le conteneur Web essaiera d'exécuter la classe :
  HTTP Status 500 - java.lang.ClassCastException: com.mtitek.servlets.test1.MyServlet1 cannot be cast to javax.servlet.Servlet org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:462) org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:100) org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:562) org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:395) org.apache.coyote.http11.Http11AprProcessor.process(Http11AprProcessor.java:306) org.apache.coyote.http11.Http11AprProtocol$Http11ConnectionHandler.process(Http11AprProtocol.java:323) org.apache.tomcat.util.net.AprEndpoint$SocketProcessor.run(AprEndpoint.java:1719) java.util.concurrent.ThreadPoolExecutor$Worker.runTask(ThreadPoolExecutor.java:886) java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:908) java.lang.Thread.run(Thread.java:619)