ObjectHttpCookie

HttpCookie é un obxecto cookie encapsulado polo protocolo HTTP. Ofrece varios atributos para obter e configurar cookies. Tamén admite a organización e procesamento de varias cookies.http.Requestehttp.ResponseUnha propiedade importante apoiada por ambos obxectos

No lado do servidor, podes pasarHttpRequest.cookiespara obter todas as cookies na solicitude HTTP. Cada cookie aquí é un obxecto HttpCookie e a información relacionada coas cookies pódese obter ou configurar a través das súas propiedades ou métodos. Por exemplo, podemos ler os atributos correspondentes da cookie enviada polo cliente a través do seguinte código:

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í usamosHttpRequest.cookiesA propiedade recibe todas as cookies na solicitude. A continuación, use o método cookies.get, pasando o nome da cookie, para obter o valor da cookie.

Para enviar unha cookie ao cliente, cree unha nova cookie a través do obxecto HttpCookie e engádea á colección HttpReponse.cookies. Aquí tes un exemplo:

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();

No exemplo anterior, primeiro obtemos HttpServletRequest.cookies e despois tentamos ler o valor da cookie nomeada a partir dela. Se existe a cookie, envíe unha resposta á solicitude e use o valor da cookie para saudar ao cliente. Se a cookie non existe, creamos un novo obxecto de cookie e engadímolo á colección HttpServletResponse.cookies. O primeiro parámetro con nome e valor úsase para especificar o nome da cookie e o valor correspondente. Ao mesmo tempo, o atributo expires úsase para especificar o tempo de caducidade da cookie. Aquí, o tempo actual máis 15 minutos especifícase como tempo de caducidade. Finalmente, engadimos unha mensaxe de benvida ao contido do valor de retorno.

relación de herdanza

Construtor

HttpCookie

Construtor HttpCookie, crea un novo obxecto HttpCookie

1
new HttpCookie(Object opts = {});

Parámetros de chamada:

• opts: Obxecto, especifica as propiedades da cookie creada

As opcións que se poden configurar son as seguintes:

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
}

---

Construtor HttpCookie, crea un novo obxecto HttpCookie

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

Parámetros de chamada:

• name: Cadea, especifica o nome da cookie creada
• value: Cadea, especifica o valor da cookie creada
• opts: Obxecto, especifica outros atributos da cookie creada

As opcións que se poden configurar son as seguintes:

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
}

propiedades dos membros

name

Cadea, consulta e establece o nome da cookie

1
String HttpCookie.name;

---

value

Cadena, consulta e establece valores de cookies

1
String HttpCookie.value;

---

domain

Cadea, intervalo de nomes de dominio para consultar e configurar cookies

1
String HttpCookie.domain;

---

path

Cadea, consulta e establece o intervalo de rutas de cookies

1
String HttpCookie.path;

---

expires

Data, consulta e establece o tempo de caducidade das cookies

1
Date HttpCookie.expires;

---

httpOnly

Booleano, consulta e establece se só se permiten cookieshttpSolicitude, por defecto false

1
Boolean HttpCookie.httpOnly;

---

secure

Booleano, consulta e establece se as cookies só se pasan a través de https, por defecto false

1
Boolean HttpCookie.secure;

función de membro

parse

Analiza a cadea dada e enche o obxecto cookie

1
HttpCookie.parse(String header);

Parámetros de chamada:

• header: Cadea, especifica a cadea de cabeceira que se debe analizar

---

match

Proba o dadourlCoincide coa configuración actual?

1
Boolean HttpCookie.match(String url);

Parámetros de chamada:

• url: Cadena, especificando a probaurl

Resultados de devolución:

• Boolean, devolve verdadeiro se a coincidencia ten éxito

---

toString

Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.

1
String HttpCookie.toString();

Resultados de devolución:

• String, devolve a representación en cadea do obxecto

---

toJSON

Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.

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

Parámetros de chamada:

• key: Cadena, non usada

Resultados de devolución:

• Value, devolve un valor que contén JSON serializable