ObjectHttpCollection

HttpCollection é un contedor xeral para o procesamentohttpcabeceiras, consulta, formulario, datos de cookies na mensaxe

Tomamos as cabeceiras como exemplo para ilustrar o uso de HttpCollection.

HttpCollection admite tres formas de engadir datos:

1. Engade datos de clave-valor. Ao engadir datos non se modifican os datos de chave-valor existentes.add

1
2
3
4
headers.add({
    'Content-Type': 'text/plain',
    'User-Agent': 'fibjs'
});

1. Engade un conxunto de datos cun valor clave. Engadir datos non modifica os datos do valor clave existente.add

1
2
3
4
headers.add('Set-Cookie', [
    'a=10',
    'b=20'
]);

1. Engade datos de clave-valor. Ao engadir datos non se modifican os datos de chave-valor existentes.add

1
headers.add('Accept-Encoding', 'gzip');

HttpCollection A forma de configuración dos datos é a mesma que a de engadir, e o método utilizado é set.

Podemos usalo haspara comprobar se os datos co valor de chave especificado existen no contedor

1
const contentTypeExists = headers.has('Content-Type');

Use para firstobter o primeiro valor correspondente a unha chave no contedor:

1
const contentType = headers.first('Content-Type');

Utilízase allpara consultar todos os valores do valor da clave especificado e devolver unha matriz. Se se pasa un argumento de cadea baleiro, devólvese o valor completo

1
2
const cookieArray = headers.all('Set-Cookie');
const alls = headers.all();

Use deleteo método para eliminar todos os datos do valor de clave especificado e devolver truea representación

relación de herdanza

Operador

operator[String]

Permite o acceso directo aos valores mediante subíndices clave-valor

1
Variant HttpCollection[String];

función de membro

clear

Borrar os datos do contedor

1
HttpCollection.clear();

---

has

Comproba se os datos co valor de chave especificado existen no contedor

1
Boolean HttpCollection.has(String name);

Parámetros de chamada:

• name: Cadea, especifica o valor da clave que se vai comprobar

Resultados de devolución:

• Boolean, devolve se o valor da chave existe

---

first

Consulta o primeiro valor do valor da chave especificado

1
Variant HttpCollection.first(String name);

Parámetros de chamada:

• name: Cadea, especifique o valor da clave que se vai consultar

Resultados de devolución:

• Variant, devolve o valor correspondente ao valor da chave, se non existe, devolve indefinido

---

get

Consulta o primeiro valor do valor da chave especificado, que é equivalente a first

1
Variant HttpCollection.get(String name);

Parámetros de chamada:

• name: Cadea, especifique o valor da clave que se vai consultar

Resultados de devolución:

• Variant, devolve o valor correspondente ao valor da chave, se non existe, devolve indefinido

---

all

Consulta todos os valores do valor da chave especificado

1
NObject HttpCollection.all(String name = "");

Parámetros de chamada:

• name: Cadea, especifique o valor da clave que se vai consultar, pase unha cadea baleira para devolver os resultados de todos os valores clave

Resultados de devolución:

• NObject, devolve unha matriz de todos os valores correspondentes ao valor da chave. Se os datos non existen, devolve nulo.

---

add

Engade datos de clave-valor. Ao engadir datos non se modifican os datos de chave-valor existentes.

1
HttpCollection.add(Object map);

Parámetros de chamada:

• map: Obxecto, especifica o dicionario de datos clave-valor que se vai engadir

---

Engade un conxunto de datos para un valor clave. Engadir datos non modifica os datos do valor clave existente.

1
2
HttpCollection.add(String name,
    Array values);

Parámetros de chamada:

• name: Cadea, especifica o valor da chave que se vai engadir
• values: Matriz, especifica un conxunto de datos a engadir

---

Engade datos de clave-valor. Ao engadir datos non se modifican os datos de chave-valor existentes.

1
2
HttpCollection.add(String name,
    Variant value);

Parámetros de chamada:

• name: Cadea, especifica o valor da chave que se vai engadir
• value: Variante, especifique os datos a engadir

---

set

Establece os datos dun valor clave. Ao configurar os datos modificarase o primeiro valor correspondente ao valor clave e borrarase os datos restantes co mesmo valor clave.

1
HttpCollection.set(Object map);

Parámetros de chamada:

• map: Obxecto, especifica o dicionario de datos clave-valor que se vai definir

---

Establece un conxunto de datos para un valor clave. Ao configurar os datos modificarase o valor correspondente ao valor clave e borrará os datos restantes co mesmo valor clave.

1
2
HttpCollection.set(String name,
    Array values);

Parámetros de chamada:

• name: Cadea, especifique o valor da clave que se quere establecer
• values: Matriz, especifica un conxunto de datos a definir

---

Establece os datos dun valor clave. Ao configurar os datos modificarase o primeiro valor correspondente ao valor clave e borrarase os datos restantes co mesmo valor clave.

1
2
HttpCollection.set(String name,
    Variant value);

Parámetros de chamada:

• name: Cadea, especifique o valor da clave que se quere establecer
• value: Variante, especifique os datos a configurar

---

remove

Elimina todos os valores da clave especificada

1
HttpCollection.remove(String name);

Parámetros de chamada:

• name: Cadea, especifica o valor da clave que se vai eliminar

---

delete

Elimina todos os valores da clave especificada

1
HttpCollection.delete(String name);

Parámetros de chamada:

• name: Cadea, especifica o valor da clave que se vai eliminar

---

sort

Ordena o contido dun recipiente polo valor da chave

1
HttpCollection.sort();

---

keys

Consulta o valor da chave no contedor

1
NArray HttpCollection.keys();

Resultados de devolución:

• NArray, devolve unha matriz que contén todos os valores clave

---

values

Consulta o valor do contedor

1
NArray HttpCollection.values();

Resultados de devolución:

• NArray, devolve unha matriz que contén todos os valores

---

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 HttpCollection.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 HttpCollection.toJSON(String key = "");

Parámetros de chamada:

• key: Cadena, non usada

Resultados de devolución:

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