response  
 
Nom de la variable :

response
 
Nom de l'interface :

javax.servlet.http.HttpServletResponse
 
Etend :

javax.servlet.ServletResponse
 
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 response 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.ServletResponse. HTTP étant le seul protocole pris en charge par JSP 1.1, la classe implémente toujours l'interface javax.servlet.http.HttpServletResponse. Les descriptions de méthode figurant dans cette section incluent les méthodes des deux interfaces.

 
Constantes 
public static final int SC_CONTINUE = 100;
public static final int SC_SWITCHING_PROTOCOLS = 101;
public static final int SC_OK = 200;
public static final int SC_CREATED = 201;
public static final int SC_ACCEPTED = 202;
public static final int SC_NON_AUTHORITATIVE_INFORMATION = 203;
public static final int SC_NO_CONTENT = 204;
public static final int SC_RESET_CONTENT = 205;
public static final int SC_PARTIAL_CONTENT = 206;
public static final int SC_MULTIPLE_CHOICES = 300;
public static final int SC_MOVED_PERMANENTLY = 301;
public static final int SC_MOVED_TEMPORARILY = 302;
public static final int SC_SEE_OTHER = 303;
public static final int SC_NOT_MODIFIED = 304;
public static final int SC_USE_PROXY = 305;
public static final int SC_TEMPORARY_REDIRECT = 307;
public static final int SC_BAD_REQUEST = 400;
public static final int SC_UNAUTHORIZED = 401;
public static final int SC_PAYMENT_REQUIRED = 402;
public static final int SC_FORBIDDEN = 403;
public static final int SC_NOT_FOUND = 404;
public static final int SC_METHOD_NOT_ALLOWED = 405;
public static final int SC_NOT_ACCEPTABLE = 406;
public static final int SC_PROXY_AUTHENTICATION_REQUIRED = 407;
public static final int SC_REQUEST_TIMEOUT = 408;
public static final int SC_CONFLICT = 409;
public static final int SC_GONE = 410;
public static final int SC_LENGTH_REQUIRED = 411;
public static final int SC_PRECONDITION_FAILED = 412;
public static final int SC_REQUEST_ENTITY_TOO_LARGE = 413;
public static final int SC_REQUEST_URI_TOO_LONG = 414;
public static final int SC_UNSUPPORTED_MEDIA_TYPE = 415;
public static final int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416;
public static final int SC_EXPECTATION_FAILED = 417;
public static final int SC_INTERNAL_SERVER_ERROR = 500;
public static final int SC_NOT_IMPLEMENTED = 501;
public static final int SC_BAD_GATEWAY = 502;
public static final int SC_SERVICE_UNAVAILABLE = 503;
public static final int SC_GATEWAY_TIMEOUT = 504;
public static final int SC_HTTP_VERSION_NOT_SUPPORTED = 505;
addCookie()  
public void addCookie(Cookie cookie)

Ajoute le cookie spécifié dans la réponse.

addDateHeader()  
public void addDateHeader(String headername, long date)

Ajoute un en-tête de réponse avec le nom et la valeur de date donnés. La date est spécifiée en millisecondes depuis l'époque (1er janvier 1970, 00:00:00 TMG).

addHeader()  
public void addHeader(String headername, String value)

Ajoute un en-tête de réponse avec le nom et la valeur spécifiés.

addIntHeader()  
public void addIntHeader(String headername, int value)

Ajoute un en-tête de réponse avec le nom et la valeur entière donnés.

containsHeader()  
public boolean containsHeader(String name)

Renvoie une valeur boolean indiquant si l'en-tête de réponse nommé a déjà été défini.

encodeRedirectURL()  
public String encodeRedirectURL(String url)

Code l'URL spécifiée pour l'utiliser dans la méthode sendRedirect() en y incluant l'ID de session. Si le codage (correction de l'URL) n'est pas nécessaire, elle renvoie l'URL non modifié.

encodeURL()  
public String encodeURL(String url)

Code l'URL spécifiée pour l'utiliser dans un élément de référence (par exemple, <a>) en y incluant l'ID de session. Si le codage (correction de l'URL) n'est pas nécessaire, elle renvoie l'URL non modifié.

flushBuffer()  
public void flushBuffer() throws IOException

Ecrit le contenu du corps de la réponse mis en mémoire tampon dans le client.

getBufferSize()  
public int getBufferSize()

Renvoie la taille actuelle de la mémoire tampon (en octets) utilisée pour la réponse, ou la valeur 0 si la mise en mémoire tampon n'est pas utilisée.

getCharacterEncoding()  
public String getCharacterEncoding()

Renvoie le nom du jeu de caractères utilisé pour le corps MIME envoyé dans la réponse.

getLocale()  
public Locale getLocale()

Renvoie les paramètres régionaux affectés à la réponse. Il s'agit soit d'un objet Locale du paramètre régional par défaut du serveur, soit du paramètre Locale défini avec setLocale().

getOutputStream()  
public ServletOutputStream getOutputStream() throws IOException

Renvoie une ServletOutputStream adaptée pour écrire des données binaires dans la réponse. Cette méthode ne doit pas être utilisée dans une page JSP, les pages JSP n'étant pas prévues pour les données de texte.

getWriter()  
public PrintWriter getWriter throws IOException

Renvoie un objet PrintWriter capable d'envoyer un texte de caractères au client. Cette méthode ne doit pas être utilisée dans une page JSP, car elle pourrait perturber le mécanisme du scripteur du container. Utilisez plutôt la méthode PageContext pour obtenir la classe JspWriter actuelle.

isCommitted()  
public boolean isCommitted()

Renvoie une valeur boolean indiquant si la réponse nommée a été soumise.

reset()  
public void reset()

Efface toutes les données figurant dans la mémoire tampon ainsi que le code d'état et les en-têtes. Si la réponse a été soumise, cette méthode déclenche une exception IllegalStateException.

sendError()  
public void sendError(int status) throws IOException

Envoie une réponse d'erreur au client au moyen de l'état spécifié. Si la réponse a déjà été soumise, cette méthode déclenche une exception IllegalStateException. Si cette méthode a été utilisée, la réponse soumise doit être examinée et aucune donnée ne doit y être écrite.

sendError()  
public void sendError(int status, String message) throws IOException

Envoie une réponse d'erreur au client au moyen du code d'état spécifié et d'un message descriptif. Si la réponse a déjà été soumise, cette méthode déclenche une exception IllegalStateException. Si cette méthode a été utilisée, la réponse soumise doit être examinée et aucune donnée ne doit y être écrite.

sendRedirect()  
public void sendRedirect(String location) throws IOException

Envoie une réponse de redirection temporaire au client au moyen de l'URL de l'emplacement de redirection spécifié. Cette méthode peut accepter des URL relatives ; le container de servlet convertira l'URL relative en une URL absolue avant d'envoyer la réponse au client. Si la réponse a déjà été soumise, cette méthode déclenche une exception IllegalStateException. Si cette méthode a été utilisée, la réponse soumise doit être examinée et aucune donnée ne doit y être écrite.

setBufferSize()  
public void setBufferSize(int size)

Définit la taille de préférence de la mémoire tampon (en octets) pour le corps de la réponse. Le container de servlet utilise une mémoire tampon de la taille de celle demandée au minimum. La méthode getBufferSize() permet de connaître la taille de la mémoire tampon actuelle utilisée.

setContentLength()  
public void setContentLength(int length)

Définit la longueur (en octets) du corps du contenu de la réponse. Dans les servlets HTTP, cette méthode définit l'en-tête HTTP Content-Length. Cette méthode ne doit pas être utilisée dans une page JSP, car elle pourrait perturber le mécanisme du scripteur du container.

setContentType()  
public void setContentType(String type)

Définit le type de contenu de la réponse envoyée au client.

setDateHeader()  
public void setDateHeader(String headername, long date)

Définit un en-tête de réponse avec le nom et la valeur de date donnés. La date est spécifiée en millisecondes depuis l'époque (1er janvier 1970, 00:00:00 TMG). Si l'en-tête est déjà défini, la nouvelle valeur écrase la précédente.

setHeader()  
public void setHeader(String headername, String value)

Définit un en-tête de réponse avec le nom et la valeur donnés. Si l'en-tête est déjà défini, la nouvelle valeur écrase la précédente.

setIntHeader()  
public void setIntHeader(String headername, int value)

Définit un en-tête de réponse avec le nom et la valeur entière donnés. Si l'en-tête est déjà défini, la nouvelle valeur écrase la précédente.

setLocale()  
public void setLocale(Locale locale)

Définit les paramètres régionaux de la réponse en paramétrant les en-têtes (y compris le jeu de caractères Content-Type de l'en-tête) comme il convient.

setStatus()  
public void setStatus(int statuscode)

Définit le code d'état de cette réponse. Contrairement à la méthode sendError(), cette méthode ne définit que le code d'état ; elle n'ajoute pas de corps et ne soumet pas la réponse.

encodeRedirectUrl() Déconseillé
public String encodeRedirectUrl(String url)

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

encodeUrl() Déconseillé
public String encodeUrl(String url)

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

setStatus() Déconseillé
public void setStatus(int statuscode, String message)

Depuis l'API Servlet 2.1, il est recommandé d'utiliser la méthode setStatus(int) pour définir un code d'état et la méthode sendError(int, String) pour envoyer une erreur accompagnée d'une description. Cette méthode n'est pas conseillée en raison de la signification ambigüe du paramètre du message.