Comment Ca Marche - Communauté informatique  
   
Accueil - Encyclopédie informatiqueTélécharger l'encyclopédieContribuer à cet article

Servlets - Cookies

Gérer les cookies avec des servlets Encyclopédie


Introduction aux cookies

Les cookies représentent un moyen simple de stocker temporairement des informations chez un client, afin de les récupérer ultérieurement. Concrètement il s'agit de fichiers texte stockés sur le disque dur du client après réception d'une réponse HTTP contenant des champs appropriés dans l'en-tête.

Les cookies font partie des spécifications du protocole HTTP. Le protocole HTTP permet d'échanger des messages entre le serveur et le client à l'aide de requêtes HTTP et de réponses HTTP.

Les requêtes et réponses HTTP contiennent des en-têtes permettant d'envoyer des informations particulières de façon bilatérale. Un de ces en-têtes est réservé à l'écriture de fichiers sur le disque: les cookies.

L'en-tête HTTP réservé à l'utilisation des cookies s'appelle Set-Cookie, il s'agit d'une simple ligne de texte de la forme:

Set-Cookie : NOM=VALEUR; domain=NOM_DE_DOMAINE; expires=DATE
Il s'agit donc d'une chaîne de caractères commençant par Set-Cookie : suivie par des paires clés-valeur sous la forme CLE=VALEUR et séparées par des virgules.

L'API servlet de Java propose un objet permettant de gérer de façon quasi-transparente l'usage des cookies, il s'agit de l'objet Cookie.

L'objet Cookie

La classe javax.servlet.http.Cookie permet de créer un objet Cookie encapsulant toutes les opérations nécessaires à la manipulation des cookies.

Ainsi, le constructeur de la classe Cookie crée un cookie avec un nom et une valeur initiaux passés en paramètre. Il est toutefois possible de modifier la valeur de ce cookie ultérieurement grâce à sa méthode setValue().

Conformément à la norme HTTP 1.1, le nom du cookie doit être une chaîne de caractères ne contenant aucun caractère spécial défini dans la RFC 2068 (Il vaut mieux donc utiliser des caractères alphanumériques uniquement).
Les valeurs par contre peuvent inclure tous les caractères hormis les espaces ou chacun de ces caractères :

[ ] ( ) = , " / ?  : ;

Envoi du cookie

L'envoi du cookie vers le navigateur du client se fait grâce à la méthode addCookie() de l'objet HttpServletResponse.

void AddCookie(Cookie cookie)

Etant donnée que les cookies sont stockés dans les en-têtes HTTP, et que celles-ci doivent être les premières informations envoyées, la création du cookie doit se faire avant tout envoi de données au navigateur (le cookie doit être créé avant toute écriture sur le flot de sortie de la servlet)

Cookie MonCookie = new Cookie("nom", "valeur");

response.addCookie(MonCookie);

Récupération des cookies du client

Pour récupérer les cookies provenant de la requête du client, il suffit d'utiliser la méthode getCookies() de l'objet HttpServletRequest

Cookie[] getCookies()
Cette méthode retourne un tableau contenant l'ensemble des cookies présents chez le client. Il est ainsi possible de parcourir le tableau afin de retrouver un cookie spécifique grâce à la méthode getName() de l'objet Cookie().

Récupération de la valeur d'un cookie

La récupération de la valeur d'un cookie se fait grâce à la méthode getValue() de l'objet Cookie

String Valeur = Cookie.getValue()

Récupération de la valeur d'un cookie

L'exemple suivant permet de récupérer la valeur d'un cookie spécifique (dont le nom est "LeCookieQueJeCherche") et d'afficher sa valeur sur le navigateur du client :

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

import java.net.*;

public class AfficheMonCookie extends HttpServlet {
	public void doGet (HttpServletRequest request, HttpServletResponse response)
		throws ServletException, IOException	{		...
		
			// 
			Cookie[] cookies = request.getCookies();

			for(i=0; i < cookies.length; i++) {
				Cookie MonCookie = cookies[i];

				if (MonCookie.getName().equals("LeCookieQueJeCherche")) {
			String Valeur = cookies[i].getValue();

		}
		 }
		
	// ecriture de la reponse
		response.setContentType("text/html");

		PrintWriter out = response.getWriter();		
		out.println("<html><head>"); 
	out.println("<title>Mon Cookie</title>");

	out.println("</head><body>");

	out.println("Voici la valeur de mon cookie : " + Valeur");

		out.println("</body></html>"); 
	}
}

Ajouter des paramètres à un cookie

Voici l'ensemble des méthodes publiques de l'objet Cookie permettant d'obtenir des informations sur le cookie ou bien de préciser certains paramètres :
Méthode Description
Cookie(String Name, String Value)( Constructeur créant un objet Cookie de nom Name et de valeur Value)
String getDomain() Retourne le domaine pour lequel le cookie est valide
void setDomain(String Domain) Définit le domaine pour lequel le cookie est valide
int getMaxAge() Retourne la durée de validité du cookie (en secondes)
void setMaxAge(int duree) Définit la durée de validité du cookie (en secondes)
String getName() Retourne le nom du cookie
String getPath() Retourne le chemin pour lequel le cookie est valide
void setPath(String Chemin) Définit le chemin pour lequel le cookie est valide
boolean getSecure() Retourne true si le cookie doit être envoyé uniquement sur ligne sécurisée, sinon false
boolean setSecure(Boolean flag) Définit si le cookie doit être envoyé sur une ligne sécurisée (SSL)
String getValue() Retourne la valeur du cookie
void setValue(String Valeur) Redéfinit la valeur du cookie
int getVersion() Retourne la version du cookie
void setVersion(int Version) Définit la valeur du cookie

Trucs & astuces pertinents trouvés dans la base de connaissances

01/10 19h45 Gérer les cookies (Internet)
01/09 23h04 Cookies Mozilla, Firefox et Internet Explorer (Internet)
Servlets cookies Plus d'astuces sur « Servlets cookies »

Discussions pertinentes trouvées dans le forum

21/11 07h05 pc lent cookies pc lent et cookies Windows 19/12 16h20->blondin777104
24/05 18h20 a2 squared cookies persistant problème avec a2 squared cookies persistant Virus/Sécurité 30/05 19h48->Eraclius27
13/05 12h52 cookies sert cookies à quoi ça sert Virus/Sécurité 23/05 01h12->boulepate6219
27/02 21h51 windows windows servlet32.ex Windows ne trouve pas C:\WINDOWS\servlet32.ex Virus/Sécurité 28/02 12h11->BmV14
14/09 15h20 php cookies [PHP] Cookies Webmastering 14/09 17h29->Erdnax14
06/12 17h04  Spyware cookie chez CCM... Suggestions 09/12 22h43->Yoan11
06/04 08h46 firefox marque pages cookies [Firefox] Marque-pages et cookies Internet 09/02 13h46->Dupont7
04/06 22h03 cookies disparaissent [cookies] disparaissent Windows 05/06 18h06->Séb087
13/07 14h32 6 cookies solution 6 cookies, une solution? Virus/Sécurité 15/07 17h25->Regis596
12/09 10h25 kerio cookies Kerio et cookies? Virus/Sécurité 13/09 14h48->^^Marie^^6
Discussion fermée Problème résolu Servlets cookies Plus de discussions sur « Servlets cookies »

Ce document intitulé « Servlets - Cookies » issu de l'encyclopédie informatique Comment Ça Marche (www.commentcamarche.net) est mis à disposition sous les termes de la licence Creative Commons. Vous pouvez copier, modifier des copies de cette page, dans les conditions fixées par la licence, tant que cette note apparaît clairement.