Objecte objecte incorporat

ObjectHttpCookie

HttpCookie és un objecte de galetes encapsulat pel protocol HTTP. Proporciona diversos atributs per obtenir i configurar galetes. També admet l'organització i el processament de múltiples galetes. Éshttp.Requestihttp.ResponseUna propietat important recolzada per ambdós objectes

Al costat del servidor, podeu passarHttpRequest.cookiesper obtenir totes les galetes a la sol·licitud HTTP. Cada galeta aquí és un objecte HttpCookie i la informació relacionada amb les cookies es pot obtenir o configurar mitjançant les seves propietats o mètodes. Per exemple, podem llegir els atributs corresponents de la cookie enviada pel client mitjançant el següent codi:

1 2 3 4 5 6 7
const http = require('http'); const server = new http.Server(8080, function(request) { const cookies = request.cookies; const name = cookies.get('name'); request.response.write(`Hello ${name}!`); }); server.start();

Aquí fem servirHttpRequest.cookiesLa propietat obté totes les galetes a la sol·licitud. A continuació, utilitzeu el mètode cookies.get, passant el nom de la galeta, per obtenir el valor de la galeta.

Per enviar una galeta al client, creeu una galeta nova mitjançant l'objecte HttpCookie i afegiu-la a la col·lecció HttpReponse.cookies. Aquí teniu un exemple:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
const http = require('http'); const server = new http.Server(8080, function(request) { const cookies = request.cookies; let name = cookies.get('name'); if (name) { request.response.write(`Hello ${name} again!`); } else { name = 'User'; request.response.cookies.add(new http.Cookie('name', name, { expires: new Date(Date.now() + 900000) })); request.response.write(`Welcome ${name}!`); } }); server.start();

A l'exemple anterior, primer obtenim HttpServletRequest.cookies i després intentem llegir-ne el valor de la galeta anomenada nom. Si la galeta existeix, envieu una resposta a la sol·licitud i utilitzeu el valor de la galeta per saludar el client. Si la galeta no existeix, creem un nou objecte de galeta i l'afegim a la col·lecció HttpServletResponse.cookies. El primer paràmetre amb nom i valor s'utilitza per especificar el nom de la galeta i el valor corresponent. Al mateix temps, l'atribut expires s'utilitza per especificar el temps de caducitat de la galeta. Aquí, el temps actual més 15 minuts s'especifica com a temps de caducitat. Finalment, afegim un missatge de benvinguda al contingut del valor de retorn.

relació hereditària

Constructor

HttpCookie

El constructor HttpCookie, crea un nou objecte HttpCookie

1
new HttpCookie(Object opts = {});

Paràmetres de trucada:

  • opts: Objecte, especifica les propietats de la galeta creada

Les opcions que opta pot establir són les següents:

1 2 3 4 5 6 7 8 9
{ "name": "", // specify the name of the cookie "value": "", // specify the value of the cookie "expires": Date, // specify the expires time of the cookie "domain": "", // specify the domain of the cookie "path": "", // specify the path of the cookie "secure": false, // specify the secure of the cookie "httpOnly": false, // specify the httpOnly of the cookie }

El constructor HttpCookie, crea un nou objecte HttpCookie

1 2 3
new HttpCookie(String name, String value, Object opts = {});

Paràmetres de trucada:

  • name: String, especifica el nom de la galeta creada
  • value: Cadena, especifica el valor de la galeta creada
  • opts: Objecte, especifiqueu altres atributs de la galeta creada

Les opcions que opta pot establir són les següents:

1 2 3 4 5 6 7
{ "expires": Date, // specify the expires time of the cookie "domain": "", // specify the domain of the cookie "path": "", // specify the path of the cookie "secure": false, // specify the secure of the cookie "httpOnly": false, // specify the httpOnly of the cookie }

propietats dels membres

name

Cadena, consulta i estableix el nom de la galeta

1
String HttpCookie.name;

value

Encadenar, consultar i establir valors de galetes

1
String HttpCookie.value;

domain

Cadena, rang de noms de domini per consultar i configurar galetes

1
String HttpCookie.domain;

path

Cadena, consulta i estableix l'interval de camins de galetes

1
String HttpCookie.path;

expires

Data, consulta i estableix l'hora de caducitat de les galetes

1
Date HttpCookie.expires;

httpOnly

Booleà, consulta i defineix si només es permeten les galeteshttpSol·licitud, per defecte fals

1
Boolean HttpCookie.httpOnly;

secure

Booleà, consulteu i definiu si les galetes només es passen per https, per defecte false

1
Boolean HttpCookie.secure;

funció de membre

parse

Analitzeu la cadena donada i ompliu l'objecte galeta

1
HttpCookie.parse(String header);

Paràmetres de trucada:

  • header: String, especifica la cadena de capçalera que cal analitzar

match

Prova el donaturlCoincideix amb la configuració actual?

1
Boolean HttpCookie.match(String url);

Paràmetres de trucada:

  • url: Cadena, especificant la provaurl

Resultats de retorn:

  • Boolean, retorna true si la coincidència té èxit

toString

Retorna la representació de cadena de l'objecte. En general, es retorna "[Objecte natiu]". L'objecte es pot tornar a implementar segons les seves pròpies característiques.

1
String HttpCookie.toString();

Resultats de retorn:

  • String, retorna la representació de cadena de l'objecte

toJSON

Retorna una representació en format JSON de l'objecte, generalment retornant una col·lecció de propietats llegibles definides per l'objecte.

1
Value HttpCookie.toJSON(String key = "");

Paràmetres de trucada:

  • key: Corda, no utilitzada

Resultats de retorn:

  • Value, retorna un valor que conté JSON serializable