Clasa Cookie

Clasa Cookie

Un cookie este o bucata de informatie care este pastrata pe partea client de catre un agent al utilizatorului la cererea serverului. Cookie-urile sunt folosite pentru a pastra starea din partea clientului; ei sunt folositi pentru a pastra preferintele utilizatorilor, pentru a facilita logarea la sesiuni, si asa mai departe.

In cadrul unui servlet HTTP se foloseste in mod obisnuit cookie-uri pentru a urmari identificatorul de sesiune asociat cu un utilizator dat; se poate folosi acest identificator pentru a localiza obiectul HttpSession asociat cu utilizatorul. Cookie-urile sunt transferate intre server si client prin campurile header ale documentului Http.

1. Constructori

Exista urmatorul constructor:

Cookie(String name, String value) Acest constructor creaza un cookie pentru a tine perechea specificata name/value. Parametrul name trebuie sa se conformeze protocolului HTTP/1.1: un sir ASCII alphanumeric care nu incepe cu caracterul $. Parametrul value este si el restrictionat, atat in lungime cat si in setul de caractere.

2. Metode.

Urmatoarele metode sunt definite in clasa Cookie:

String getName() Aceasta metoda intoarce numele asociat cu acest cookie.

String getValue() Aceasta metoda intoarce valoarea acestui cookie.

void setValue(String newValue) Aceasta metoda reseteaza valoarea cookie-ului.

void setComment(String purpose) In anumite situatii, agentul utilizator (de obicei un browser Web) ar trebui sa prezinte un cookie catre utilizator inainte de a fi acceptat. Acest lucru intervine atunci cand utilizatorul doreste sa controleze informatia care este adunata despre ei. Aceasta metoda permite un comentariu care descrie scopul acestui cookie care va fi inclus atunci cand cookie-ul va fi prezentat.

String getComment() Aceasta metoda intoarce un obiet de tip String, care descrie scopul acestui cookie, ori null daca nu a fost setat nici un comentariu.

void setDomain(String pattern) Aceasta metoda este folosita pentru a specifica catre care masina acest cookie ar trebui returnat. Implicit, un cookie este trimis inapoi catre masina care l-a trimis prima catre client. Sintaxa specifica al sirului primit de aceasta metoda este definita in RFC 2109. Un exemplu de astfel de sir este .nitric.com, care ar trebui sa se potriveasca cu masini de genul www1.nitric.com, www2.nitric.com, dar nu www.intdev.nitric.com.

String getDomain() Aceasta metoda intoarce domeniul catre care acest cookie va fi intors.

void setPath(String uri) Aceasta metoda este folosita pentru a limita vizibilitatea unui cookie catre cererile care incep cu URL-ul dat. Implicit, daca nu este specificat nici un URL, atunci cookie-urile sunt trimise catre acele URL-uri din acelasi director, ori intr-un subdirector, al URL-ului care a setat cookie-ul prima data.

String getPath() Aceasta metoda intoarce prefixul tuturor URL-urilor pentru care cookie-ul este vizibil.

void setMaxAge(int expiry) Aceasta metoda este folosita pentru a specifica numarul de secunde de la creatie pana cand acest cookie ar trebui sa expire. Daca parametrul expiry este negativ atunci cookie-ul nu este pastrat continuu, si va fi sters de agentul utilizatorului cand acesta isi va inchieia activitatea. Daca parametrul expiry este 0 atunci cookie-ul va fi eliminat imediat.

int getMaxAge() Aceasta metoda intoarce varsta maxima a cookie-ului in secunde. Daca nu este specificata, atunci o valoare negativa este intoarsa.

void setSecure(boolean flag) Aceasta metoda este folosita pentru a indica ca acest cookie ar trebui transferat folosindu-se un protocol de securitate cum ar fi https. Daca o conectiune nesigura este facuta catre server, atunci cookie-ul nu va fi transmis. Un cookie trebuie narcat ca sigur, doar daca serverul care trimite cookie-ul catre agentul utilizatorului, foloseste un protocol sigur.

boolean getSecure() Aceasta metoda arata daca acest cookie a fost marcat ca sigur.

int getVersion() Aceasta metoda intoarce versiunea acestui cookie. Versiunea 0 este implicita si este specificatia originala cookie, asa cum este definita de catre Netscape Communications Corporation.

void setVersion() Aceasta metoda seteaza protocolul cookie care va fi folosit cand se transmite acest cookie.