Les objets implicites sont un ensemble de variables qui référencent des objets créés par défaut et sont disponibles dans la page JSP.
+-------------------+-------------------------------------------------------------------------------------------+ | Objets implicites | Type | +-------------------+-------------------------------------------------------------------------------------------+ | request | javax.servlet.http.HttpServletRequest | | response | javax.servlet.http.HttpServletResponse | +-------------------+-------------------------------------------------------------------------------------------+ | pageContext | javax.servlet.jsp.PageContext | | page | java.lang.Object | +-------------------+-------------------------------------------------------------------------------------------+ | application | javax.servlet.ServletContext | | session | javax.servlet.http.HttpSession | +-------------------+-------------------------------------------------------------------------------------------+ | config | javax.servlet.ServletConfig | +-------------------+-------------------------------------------------------------------------------------------+ | out | javax.servlet.jsp.JspWriter | +-------------------+-------------------------------------------------------------------------------------------+ | exception | java.lang.Throwable | +-------------------+-------------------------------------------------------------------------------------------+
Le conteneur de servlets ajoute implicitement les instructions de création de ces objets.
Les références créées sont affectées à des variables locales à la méthode _jspService.
public void _jspService( final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response) throws java.io.IOException, javax.servlet.ServletException { final javax.servlet.jsp.PageContext pageContext; final java.lang.Object page = this; final javax.servlet.ServletContext application; javax.servlet.http.HttpSession session = null; final javax.servlet.ServletConfig config; javax.servlet.jsp.JspWriter out = null; java.lang.Throwable exception = org.apache.jasper.runtime.JspRuntimeLibrary.getThrowable(request); if (exception != null) { response.setStatus(javax.servlet.http.HttpServletResponse.SC_INTERNAL_SERVER_ERROR); } // ... try { pageContext = _jspxFactory.getPageContext(this, request, response, null, true, 8192, true); application = pageContext.getServletContext(); session = pageContext.getSession(); config = pageContext.getServletConfig(); out = pageContext.getOut(); // ... } catch (java.lang.Throwable t) { // ... } finally { // ... } }

La variable "request" est envoyée en paramètre à la méthode _jspService.
C'est une référence vers une instance de la classe javax.servlet.http.HttpServletRequest.

La variable "response" est envoyée en paramètre à la méthode _jspService.
C'est une référence vers une instance de la classe javax.servlet.http.HttpServletResponse.

La variable "application" est une référence vers une instance de la classe javax.servlet.ServletContext.

La variable "session" est une référence vers une instance de la classe javax.servlet.http.HttpSession.

La variable "config" est une référence vers une instance de la classe javax.servlet.ServletConfig.

La variable "pageContext" est une référence sur l'instance de la classe de type javax.servlet.jsp.PageContext.
L'instance créée correspond à une implémentation de la classe javax.servlet.jsp.PageContext (spécifique aux conteneurs des servlets).
La classe offre un ensemble de méthodes pour accéder aux objets implicites de la page ainsi que des méthodes pour inclure ou rediriger vers d'autres ressources.
La classe offre aussi des méthodes pour gérer des attributs du scope de la page ainsi que les autres scopes (APPLICATION, SESSION, REQUEST).
Voici les méthodes qui permettent de gérer les attributs :
void setAttribute(java.lang.String ATTRIBUTE_NAME, java.lang.Object ATTRIBUTE_VALUE) void setAttribute(java.lang.String ATTRIBUTE_NAME, java.lang.Object ATTRIBUTE_VALUE, int ATTRIBUTE_SCOPE) void removeAttribute(java.lang.String ATTRIBUTE_NAME) void removeAttribute(java.lang.String ATTRIBUTE_NAME, int ATTRIBUTE_SCOPE) java.lang.Object getAttribute(java.lang.String ATTRIBUTE_NAME) java.lang.Object getAttribute(java.lang.String ATTRIBUTE_NAME, int ATTRIBUTE_SCOPE) java.lang.Object findAttribute(java.lang.String ATTRIBUTE_NAME) java.util.Enumeration<java.lang.String> getAttributeNamesInScope(int ATTRIBUTE_SCOPE) int getAttributesScope(java.lang.String ATTRIBUTE_NAME)

• void setAttribute(String ATTRIBUTE_NAME, Object ATTRIBUTE_VALUE)
  - ATTRIBUTE_NAME : Nom de l'attribut qui sera mappé avec l'objet (spécifié par le paramètre ATTRIBUTE_VALUE) dans le scope PAGE.
  - ATTRIBUTE_VALUE : si la valeur de ce paramètre est null, alors l'attribut sera supprimé (même effet que removeAttribute(String ATTRIBUTE_NAME)).
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  
  
• void setAttribute(String ATTRIBUTE_NAME, Object ATTRIBUTE_VALUE, int ATTRIBUTE_SCOPE)
  - ATTRIBUTE_NAME : Nom de l'attribut qui sera mappé avec l'objet (spécifié par le paramètre ATTRIBUTE_VALUE) dans le scope précisé avec le paramètre ATTRIBUTE_SCOPE.
  - ATTRIBUTE_VALUE : si la valeur de ce paramètre est null, alors l'attribut sera supprimé (même effet que removeAttribute(String ATTRIBUTE_NAME, int ATTRIBUTE_SCOPE)).
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  - Lance l'exception java.lang.IllegalArgumentException si le scope est invalide.
  - Lance l'exception java.lang.IllegalStateException si le scope est SESSION et la session est invalide.
  
  
• void removeAttribute(String ATTRIBUTE_NAME)
  - ATTRIBUTE_NAME : Nom de l'attribut à supprimer du scope PAGE.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  
  
• void removeAttribute(String ATTRIBUTE_NAME, int ATTRIBUTE_SCOPE)
  - ATTRIBUTE_NAME : Nom de l'attribut à supprimer du scope précisé avec le paramètre ATTRIBUTE_SCOPE.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  - Lance l'exception java.lang.IllegalArgumentException si le scope est invalide.
  - Lance l'exception java.lang.IllegalStateException si le scope est SESSION et la session est invalide.
  
  
• Object getAttribute(String ATTRIBUTE_NAME)
  - Retourne l'objet associé à l'attribut ATTRIBUTE_NAME.
  - Retourne null si aucun attribut avec ce nom n'existe dans le scope PAGE.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  
  
• Object getAttribute(String ATTRIBUTE_NAME, int ATTRIBUTE_SCOPE)
  - Retourne l'objet associé à l'attribut ATTRIBUTE_NAME.
  - Retourne null si aucun attribut avec ce nom n'existe dans le scope précisé avec le paramètre ATTRIBUTE_SCOPE.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  - Lance l'exception java.lang.IllegalArgumentException si le scope est invalide.
  - Lance l'exception java.lang.IllegalStateException si le scope est SESSION et la session est invalide.
  
  
• Object findAttribute(String ATTRIBUTE_NAME)
  - Retourne l'objet associé à l'attribut ATTRIBUTE_NAME si présent dans les scopes PAGE, REQUEST, SESSION, ou APPLICATION.
  - Retourne null si aucun attribut avec ce nom n'existe dans aucun scope.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  
  
• Enumeration<String> getAttributeNamesInScope(int ATTRIBUTE_SCOPE)
  - Retourne une énumération contenant les noms de tous les attributs du scope précisé avec le paramètre ATTRIBUTE_SCOPE.
  - Retourne une énumération vide si aucun attributs n'existent dans le scope précisé.
  - Lance l'exception java.lang.IllegalArgumentException si le scope est invalide.
  - Lance l'exception java.lang.IllegalStateException si le scope est SESSION et la session est invalide.
  
  
• int getAttributesScope(String ATTRIBUTE_NAME)
  - Retourne le scope associé à l'attribut ATTRIBUTE_NAME si présent dans les scopes PAGE, REQUEST, SESSION, ou APPLICATION.
  - Retourne 0 si aucun attribut avec ce nom n'existe dans aucun scope.
  - Lance l'exception java.lang.NullPointerException si la valeur du paramètre ATTRIBUTE_NAME est null.
  
  

Notes : Les valeurs du paramètre ATTRIBUTE_SCOPE sont définies dans la classe javax.servlet.jsp.PageContext :
- PageContext.PAGE_SCOPE (public static final int PAGE_SCOPE)
- PageContext.REQUEST_SCOPE (public static final int REQUEST_SCOPE)
- PageContext.SESSION_SCOPE (public static final int SESSION_SCOPE)
- PageContext.APPLICATION_SCOPE (public static final int APPLICATION_SCOPE)

Remarques concernant l'utilisation de ces méthodes :

• Le nom de l'attribut peut être n'importe quelle chaîne de caractères. Mais il est conseillé de composer le nom de l'attribut par le nom du domaine et le nom de l'application web, par exemple "com.mtitek.MYWEBAPPLI.MYATTRIBUTENAME".
  
  
• Il y a cependant des noms d'attributs qui sont réservés par la spécification Servlet et ne peuvent pas être utilisés. Cela concerne tous les noms qui sont préfixés par « java.* », « javax.* », et « sun.* ».
  
  
• Il n'est pas possible d'avoir deux attributs avec le même nom pour le même scope ; si la méthode setAttribute est appelée avec un nom d'un attribut déjà existant, alors la valeur de ce dernier sera remplacée par la nouvelle valeur.
  
  

La variable "page" est une référence sur l'instance de la page JSP créée par le conteneur de servlets.
Comme toute page JSP est convertie en une classe Servlet, il est possible de faire un cast explicite de cette variable vers une autre variable de type HttpServlet ou httpJspPage.
<% javax.servlet.http.HttpServlet httpServlet = (HttpServlet) page; javax.servlet.jsp.HttpJspPage httpJspPage = (HttpJspPage) page; %>

La variable "out" est utilisée pour écrire dans le buffer de sortie de la réponse.
La variable est de type javax.servlet.jsp.JspWriter et il se distingue du type java.io.PrintWriter par le fait qu'il permet de garder un buffer du contenu de la réponse jusqu'à la fin du traitement de la page.
À noter que la variable est utilisée implicitement pour l'écriture du texte statique de la page JSP ainsi que la partie dynamique.
Page JSP : "page1.jsp"
<html> <head> <title>page1.jsp</title> </head> <body> <% int a = 8; int b = 5; %> <%= a * b %> </body> </html>
Le code Java généré pour la page d'erreur est :
public void _jspService( final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response) throws java.io.IOException, javax.servlet.ServletException { final javax.servlet.jsp.PageContext pageContext; javax.servlet.jsp.JspWriter out = null; // ... try { pageContext = _jspxFactory.getPageContext(this, request, response, null, true, 8192, true); out = pageContext.getOut(); out.write("<html> \r\n"); out.write("<head> \r\n"); out.write("<title>page1.jsp</title> \r\n"); out.write("</head> \r\n"); out.write("<body> \r\n"); int a = 8; int b = 5; out.write(' '); out.write('\r'); out.write('\n'); out.print( a * b ); out.write(" \r\n"); out.write("</body> \r\n"); out.write("</html>"); // ... } catch (java.lang.Throwable t) { // ... } finally { // ... } }

La variable "exception" est créée uniquement pour les pages JSP marquées comme des pages d'erreurs :
<%@ page isErrorPage="true" %>
Le code Java généré pour la page d'erreur est :
public void _jspService( final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response) throws java.io.IOException, javax.servlet.ServletException { //... java.lang.Throwable exception = org.apache.jasper.runtime.JspRuntimeLibrary.getThrowable(request); if (exception != null) { response.setStatus(javax.servlet.http.HttpServletResponse.SC_INTERNAL_SERVER_ERROR); } //... }
Notes : la page d'erreur JSP est appelée indirectement par le conteneur de servlets lorsqu'une erreur survienne dans une page JSP et que cette page désigne explicitement une page d'erreur.

Page JSP : "page1.jsp"
<%@ page errorPage="errpage1.jsp" %> <html> <head> <title>page1.jsp</title> </head> <body> <% int a = 8; int b = 0; %> <%= a/b %> <!-- ArithmeticException: / by zero --> </body> </html>
Page d'erreur JSP : "errpage1.jsp"
<%@ page isErrorPage="true" %> <html> <head> <title>errpage1.jsp</title> </head> <body> <h1>error page 1</h1> <%= exception.toString() %> </body> </html>