pageContext  
 
Nom de la variable :

pageContext

 
Nom de la classe :

javax.servlet.jsp.PageContext

 
Etend :

Aucun

 
Implémente :

Aucun

 
Implémentée par :

Une sous-classe concrète de cette classe abstraite est fournie sous forme de classe interne dépendante du container.

 
Type de page JSP :

Disponible dans les pages JSP et dans les pages d'erreur

 
Description

Une instance PageContext permet d'accéder à toutes les étendues JSP ainsi qu'à plusieurs attributs page, elle permet également de placer un calque au-dessus des informations d'implémentation du container pour permettre à un container de générer des classes d'implémentation JSP portables. L'étendue de la page JSP est représentée par les attributs PageContext. Une instance unique de cet objet est créée par le container web et affectée à la variable pageContext pour chaque demande.

 
Constantes
public static final int PAGE_SCOPE = 1;
public static final int REQUEST_SCOPE = 2;
public static final int SESSION_SCOPE = 3;
public static final int APPLICATION_SCOPE = 4;
findAttribute()  
public abstract Object findAttribute(String name)

Recherche l'attribut nommé dans la page, demande, session (si valide) ainsi que les étendues de l'application dans l'ordre et renvoie la valeur associée. Si l'attribut est introuvable, renvoie la valeur null.

forward()  
public abstract void forward(String relativeUrlPath)
  throws ServletException, java.io.IOException

Envoie la demande actuelle à un autre composant actif de l'application, comme un servlet ou une page JSP. Si l'URI spécifié commence par une barre oblique, il est interprété comme un chemin de contexte ; sinon, il est interprété comme un chemin de page.

La réponse ne doit pas être modifiée une fois cette méthode appelée, la réponse étant soumise avant le renvoi de cette méthode.

getAttribute()  
public abstract Object getAttribute(String name)

Renvoie l'attribut Object associé au nom d'attribut spécifié dans l'étendue de la page, ou la valeur null si l'attribut est introuvable.

getAttribute()  
public abstract Object getAttribute(String name, int scope)

Renvoie l'attribut Object associé au nom d'attribut spécifié dans l'étendue spécifiée, ou la valeur null si l'attribut est introuvable. L'argument scope doit correspondre à l'une des valeurs int spécifiées par les variables de l'étendue statique PageContext.

getAttributeNamesInScope()  
public abstract java.util.Enumeration getAttributeNamesInScope(int scope)

Renvoie une Enumeration d'objets String contenant tous les noms d'attribut de l'étendue spécifiée. L'argument scope doit correspondre à l'une des valeurs int spécifiées par les variables de l'étendue statique PageContext.

getAttributesScope()  
public abstract int getAttributesScope(String name)

Renvoie l'une des valeurs int spécifiées par les variables de l'étendue statique PageContext pour l'étendue de l'objet associé au nom d'attribut spécifié, ou la valeur 0 si l'attribut est introuvable.

getException()  
public abstract Exception getException()

Renvoie l'exception Exception à l'origine de l'invocation de la page actuelle si l'attribut isErrorPage de la directive page est défini sur true.

getOut()  
public abstract JspWriter getOut()

Renvoie la classe JspWriter actuelle de la page. Si cette méthode est appelée par un gestionnaire de balises implémentant BodyTag ou qu'elle est imbriquée dans le corps d'un autre élément d'action, l'objet renvoyé peut correspondre à une instance de la sous-classe BodyContent.

getPage()  
public abstract Object getPage()

Renvoie l'objet Object qui représente l'instance de la classe d'implémentation JSP à laquelle cette variable PageContext est associée.

getRequest()  
public abstract ServletRequest getRequest()

Renvoie la ServletRequest actuelle.

getResponse()  
public abstract ServletResponse getResponse()

Renvoie la ServletResponse actuelle.

getServletConfig()  
public abstract ServletConfig getServletConfig()

Renvoie la ServletConfig de cette instance de classe d'implémentation de page JSP.

getServletContext()  
public abstract ServletContext getServletContext()

Renvoie la ServletContext de cette instance de classe d'implémentation de page JSP.

getSession()  
public abstract HttpSession getSession()

Renvoie la HttpSession actuelle, ou la valeur null si l'attribut session de la directive page est défini sur false.

handlePageException()  
public abstract void handlePageException(Exception e)
  throws ServletException, java.io.IOException

Cette méthode ne doit être appelée par la classe d'implémentation de page JSP que pour traiter des exceptions non gérées, soit en envoyant l'exception de demande à la page d'erreur spécifiée par l'attribut errorPage de la directive page, soit en exécutant une action dépendante de l'implémentation (si aucune page d'erreur n'est spécifiée).

include()  
public abstract void include(String relativeUrlPath)
  throws ServletException, java.io.IOException

Entraîne le traitement de la ressource spécifiée comme élément de la demande actuelle. La classe JspWriter actuelle est vidée avant d'invoquer la ressource cible, et la sortie du traitement de la ressource cible de la demande est écrite directement dans le scripteur de l'objet ServletResponse actuel. Si l'URI spécifié commence par une barre oblique, il est interprété comme un chemin de contexte ; sinon, il est interprété comme un chemin de page.

initialize()  
public abstract void initialize(Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)
  throws java.io.IOException, IllegalStateException, IllegalArgumentException

Cette méthode est appelée pour initialiser un objet PageContext de sorte qu'une classe d'implémentation JSP puisse l'utiliser pour envoyer une demande entrante. Cette méthode est généralement appelée à partir de la méthode JspFactory.getPageContext().

popBody()  
public JspWriter popBody()

Cette méthode ne doit être appelée par la classe d'implémentation JSP que pour réaffecter les précédentes classes JspWriter, enregistrées par la méthode pushBody() correspondante, comme classes JspWriter actuelles.

pushBody()  
public BodyContent pushBody()

Cette méthode ne doit être appelée par la classe d'implémentation JSP que pour obtenir un nouvel objet BodyContent et enregistrer la classe JspWriter actuelle sur la pile interne de l'objet PageContext.

release()  
public abstract void release()

Rétablit l'état interne d'un objet PageContext en activant toutes les références internes et en préparant l'objet PageContext à une éventuelle réutilisation en cas d'invocation ultérieure de la méthode initialize(). Cette méthode est généralement appelée à partir de la méthode JspFactory.releasePageContext().

removeAttribute()  
public abstract void removeAttribute(String name)
public abstract void removeAttribute(String name, int scope)

Supprime la référence de l'objet associée au nom d'attribut spécifié dans l'étendue de la page ou dans l'étendue spécifiée. L'argument scope doit correspondre à l'une des valeurs int spécifiées par les variables de l'étendue statique PageContext.

setAttribute()  
public abstract void setAttribute(String name, Object attribute)
public abstract void setAttribute(String name, Object o, int scope)

Enregistre l'objet et le nom d'attribut spécifié dans l'étendue de la page ou dans l'étendue spécifiée. L'argument scope doit correspondre à l'une des valeurs int spécifiées par les variables de l'étendue statique PageContext.

PageContext()  
public PageContext()

Crée une instance de la classe PageContext. En règle générale, la classe JspFactory crée et initialise l'instance.