request  
 
Nom de la variable :

request

 
Nom de l'interface :

javax.servlet.http.HttpServletRequest

 
Etend :

javax.servlet.ServletRequest

 
Implémentée par :

Classe interne dépendante du container

 
Type de page JSP :

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

 
Description

La variable request se voit affectée une référence à une classe interne dépendante du container ; cette classe implémente une interface dépendante du protocole qui étend l'interface javax.servlet.ServletRequest. HTTP étant le seul protocole pris en charge par JSP 1.1, la classe implémente toujours l'interface javax.servlet.http.HttpServletRequest. Les descriptions de méthode figurant dans cette section incluent les méthodes des deux interfaces.

getAttribute()  
public Object getAttribute(String name)

Renvoie la valeur de l'attribut nommé sous forme d'Object, ou bien la valeur null s'il n'existe aucun attribut pour le nom donné.

getAttributeNames()  
public java.util.Enumeration getAttributeNames()

Renvoie une Enumeration contenant les noms des attributs disponibles pour cette demande. L'Enumeration est vide si la demande ne possède aucun attribut.

getAuthType()  
public String getAuthType()

Renvoie le nom du modèle d'authentification permettant de protéger le servlet (par exemple, BASIC ou SSL), ou la valeur null si le servlet n'est pas protégé.

getCharacterEncoding()  
public String getCharacterEncoding()

Renvoie le nom de la méthode de codage des caractères utilisée dans le corps de la demande, ou la valeur null si la demande ne spécifique aucune méthode de codage de caractères.

getContentLength()  
public int getContentLength()

Renvoie la longueur, en octets, du corps de la demande (si le flux d'entrée permet d'y accéder), ou la valeur -1 si la longueur est inconnue.

getContentType()  
public String getContentType()

Renvoie le type MIME du corps de la demande, ou la valeur null si le type est inconnu.

getContextPath()  
public String getContextPath()

Renvoie la portion de l'URI de la demande indiquant le contexte de la demande.

getCookies()  
public Cookie[] getCookies()

Renvoie une table contenant tous les objets Cookie envoyés par le client avec cette demande, ou la valeur null si la demande ne contient aucun cookie.

getDateHeader()  
public long getDateHeader(String name)

Renvoie la valeur de l'en-tête de demande spécifié sous forme de valeur long correspondant à une valeur de date, ou la valeur -1 si l'en-tête n'est pas inclus dans la demande.

getHeader()  
public String getHeader(String name)

Renvoie la valeur de l'en-tête de demande spécifié sous forme de String, ou la valeur null si l'en-tête n'est pas inclus dans la demande.

getHeaderNames()  
public java.util.Enumeration getHeaderNames()

Renvoie tous les noms d'en-tête figurant dans cette demande sous forme d'une Enumeration d'objets String. L'Enumeration est vide si la demande ne possède aucun en-tête.

getHeaders()  
public java.util.Enumeration getHeaders(String name)

Renvoie toutes les valeurs de l'en-tête de demande spécifié sous forme d'une Enumeration d'objets String. L'Enumeration est vide si la demande ne contient pas l'en-tête spécifié.

getInputStream()  
public ServletInputStream getInputStream()
  throws java.io.IOException

Récupère le corps de la demande sous forme de données binaires à l'aide d'une classe ServletInputStream.

getIntHeader()  
public int getIntHeader(String name)

Renvoie la valeur de l'en-tête de demande spécifié sous forme de valeur String, ou la valeur -1 si l'en-tête n'est pas inclus dans la demande.

getLocale()  
public java.util.Locale getLocale()

Renvoie la variable Locale prioritaire dans laquelle le client acceptera le contenu, en fonction de l'en-tête Accept-Language.

getLocales()  
public java.util.Enumeration getLocales()

Renvoie une Enumeration d'objets Locale indiquant dans l'ordre décroissant et en commençant par les paramètres régionaux prioritaires, les paramètres régionaux acceptés par le client en fonction de l'en-tête Accept-Language.

getMethod()  
public String getMethod()

Renvoie le nom de la méthode HTTP avec laquelle la demande a été créée ; par exemple, GET, POST ou PUT.

getParameter()  
public String getParameter(String name)

Renvoie la valeur d'un paramètre de demande sous forme de String, ou la valeur null si le paramètre n'existe pas.

getParameterNames()  
public String getParameterNames()

Renvoie une Enumeration d'objets String contenant les noms des paramètres de cette demande.

getParameterValues()  
public String[] getParameterValues()

Renvoie une table des objets String contenant toutes les valeurs des paramètres de la demande donnée, ou la valeur null si le paramètre n'existe pas.

getPathInfo()  
public String getPathInfo()

Renvoie toutes les informations de chemin supplémentaires associées à l'URI envoyé par le client lorsque cette demande a été faite, ou la valeur null si aucune information de chemin supplémentaire n'est disponible. Pour une page JSP, cette méthode renvoie toujours la valeur null.

getPathTranslated()  
public String getPathTranslated()

Renvoie le résultat de getPathInfo() qui, une fois traduit, donne le chemin du système de fichiers correspondant. Renvoie la valeur null si getPathInfo() renvoie la valeur null.

getProtocol()  
public String getProtocol()

Renvoie le nom et la version du protocole utilisé par la demande sous la forme protocol/majorVersion.minorVersion ; par exemple, HTTP/1.1.

getQueryString()  
public String getQueryString()

Renvoie la chaîne de la demande contenue dans l'URI de demande à la suite du chemin.

getReader()  
public java.io.BufferedReader getReader() throws java.io.IOException

Récupère le corps de la demande sous forme de caractères à l'aide d'un BufferedReader.

getRemoteAddr()  
public String getRemoteAddr()

Renvoie l'adresse IP (Internet Protocol) du client qui a envoyé la demande.

getRemoteHost()  
public String getRemoteHost()

Renvoie le nom qualifié complet de l'hôte client qui a envoyé la demande ou, s'il est impossible de déterminer le nom d'hôte, l'adresse IP du client.

getRemoteUser()  
public String getRemoteUser()

Renvoie l'ID de connexion de l'utilisateur envoyant cette demande si l'utilisateur a été authentifié, ou la valeur null si l'utilisateur n'a pas été authentifié.

getRequestDispatcher()  
public RequestDispatcher getRequestDispatcher(String path)

Renvoie un objet RequestDispatcher agissant comme une classe enveloppante pour la ressource définie pour le chemin spécifié.

getRequestedSessionId()  
public String getRequestedSessionId()

Renvoie l'ID de session spécifié par le client.

getRequestURI()  
public String getRequestURI()

Renvoie la portion d'URI de cette demande, depuis le nom du protocole jusqu'à la chaîne de requête de la première ligne de la demande HTTP.

getScheme()  
public String getScheme()

Renvoie le nom du modèle (protocole) utiliser pour envoyer cette demande ; par exemple, http, https ou ftp.

getServerName()  
public String getServerName()

Renvoie le nom d'hôte du serveur qui a reçu la demande.

getServerPort()  
public int getServerPort()

Renvoie le numéro du port sur lequel la demande a été reçue.

getServletPath()  
public String getServletPath()

Renvoie la portion d'URI de cette demande qui appelle le servlet. Pour une page JSP, il s'agit du chemin de contexte complet de la page.

getSession()  
public HttpSession getSession()

Renvoie l'objet HttpSession actuel associé à cette demande. Si la demande n'a pas de session, un nouvel objet HttpSession est créé, associé à la demande puis renvoyé.

getSession()  
public HttpSession getSession(boolean create)

Renvoie l'objet HttpSession actuel associé à cette demande. S'il n'y a aucune session en cours et que la méthode create est définie sur true, un nouvel objet HttpSession est créé, associé à la demande puis renvoyé. Si la méthode create est définie sur false et que la demande n'est pas associée à une session, cette méthode renvoie la valeur null.

getUserPrincipal()  
public java.security.Principal getUserPrincipal()

Renvoie un objet Principal contenant le nom de l'utilisateur authentifié actuel.

isRequestedSessionIdFromCookie()  
public boolean isRequestedSessionIdFromCookie()

Vérifie si l'ID de session demandé a été envoyé comme un cookie.

isRequestedSessionIdFromURL()  
public boolean isRequestedSessionIdFromURL()

Vérifie si l'ID de session demandé a été envoyé comme élément de l'URL de la demande.

isRequestedSessionIdValid()  
public boolean isRequestedSessionIdValid()

Vérifie si l'ID de session demandé est encore valide.

isSecure()  
public boolean isSecure()

Renvoie une valeur boolean indiquant si cette demande a été envoyée à l'aide d'un canal sécurisé, par exemple HTTPS, ou non.

isUserInRole()  
public boolean isUserInRole(String role)

Renvoie une valeur boolean indiquant si l'utilisateur authentifié figure dans le rôle logique spécifié ou non.

removeAttribute()  
public void removeAttribute(String name)

Supprime l'attribut spécifié de la demande.

setAttribute()  
public Object setAttribute(String name, Object attribute)

Enregistre l'attribut spécifié dans la demande.

getRealPath() Déconseillé
public String getRealPath()

Depuis l'API Servlet 2.1, il est plutôt recommandé d'utiliser ServletContext.getRealPath(String).

isRequestSessionIdFromUrl() Déconseillé
public boolean isRequestSessionIdFromUrl()

Depuis l'API Servlet 2.1, il est plutôt recommandé d'utiliser isRequestedSessionIdFromURL().