Framework JavaScript ACube V2.10.0
 

technique/fw_cookies.js

Résumé

Ce fichier Javascript correspond au framework de gestion des cookies. Cette description consiste à présenter les prototypes des fonctions, des exemples d'appel et les précisions techniques nécessaires à la mise en oeuvre de ce framework.

Les cookies offrent un moyen de stocker des informations côté client et de les fournir au serveur par le browser en même temps que la requête de la page. Ces cookies sont stockés dans les en-têtes HTTPà l'aide d'un champ Set-Cookie sous la forme :

Set-Cookie : name=VALEUR ; expires=DATE ; path=CHEMIN ; domain=DOMAINE ; secure

> L'information name=VALEUR est la seule information qui doit impérativement figurer dans le champ Set-Cookie. Il s'agit simplement d'une chaîne de caractères définissant les informations à stocker dans le cookie. Cette chaîne ne peut contenir ni point-virgules, ni virgules, ni espaces.
> Description des attributs optionnels du champ Set-Cookie :
Attribut
Description
expires=Date
Indique la date d'expiration du cookie. Au delà de cette date, le cookie ne sera plus mémorisé par le client ni envoyé au serveur DATE est stocké sous la forme Sun, JJ-MM-AA HH :MM :SS GMT) La valeur de expires est paramétrée par défaut sur la fin de la session Navigator en cours.
path=CHEMIN
Indique la partie de l'URL pour laquelle le cookie est valable. Si l'URL coïncide avec path et domain, le cookie est envoyé au serveur dans l'en-tête de la requête. Si path n'est pas paramétré, sa valeur est identique à celle du document qui définit le cookie.
domain=DOMAINE
Indique la partie correspondant au domaine des URL pour lesquelles le cookie est valable. La valeur par défaut de l'attribut est le domaine du document en cours qui définit le cookie.
secure
Indique que le cookie ne doit être transmis que par le biais d'un canal protégé (Ex : utilisant le protocole SSL)

- De plus, étant donné que le nombre de cookies acceptés n'excède pas 300, que la taille de chaque cookie ne peut dépasser 4000 caractères et que l es navigateurs n'acceptent pour la plupart que 20 cookies par domaine, il est nécessaire de justifier son utilisation pour un besoin non contournable par un autre moyen (contexte du serveur, champs passé dans une URL').
- La manipulation et l'interrogation en JavaScript de ces cookies s'effectuent par la commande document.cookiepour renvoyer la chaîne de l'en-tête HTTP et la réaffecter.
- Pour une bonne implémentation de ce framework, il est nécessaire de détruire tout cookie à la fin de son utilisation et de préciser l'attribut secure à true pour éviter toute confusion lors de la même utilisation en HTTP et renforcer les aspects sécuritaires en HTTPS.


Date: 25/10/2005

Version: 1.1

Auteur: Ministère des Affaires Etrangères, Aubay SA, Steve Péguet


Sommaire des Fonctions Globales
static void DeleteCookie(<String_Obligatoire> name)
           Le framework technique fw_cookies.js propose la fonction «DeleteCookie(name)»; elle sert à supprimer le cookie désigné par l'argument «name».
static String GetCookie(<String_Obligatoire> name)
           Le framework technique fw_cookies.js propose la fonction «GetCookie(name)»; elle sert à accéder à la valeur d'un cookie donné (information name=VALEUR du champ Set-Cookie).
static String getCookieVal(<String_Obligatoire> txt,<String_Obligatoire> name,<String_Obligatoire> sep)
           Le framework technique fw_cookies.js propose la fonction «getCookieVal(txt,name,sep)»; c'est la fonction interne appelée par getCookie().
static void SetCookie(<String_Obligatoire> name,<String_Obligatoire> value)
           Le framework technique fw_cookies.js propose la fonction «SetCookie(name,value)»; elle permet de créer un cookie ou de mettre à jour un cookie existant.

Framework JavaScript ACube V2.10.0
 


Version 2.10.0, / Etat : Validé
Cette création est mise à disposition selon le Contrat Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique disponible en ligne http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ ou par courrier postal à Creative Commons, 559 Nathan Abbott Way, Stanford,California 94305, USA.


Documentation generated by JSDoc on Wed Jan 6 17:05:02 2010