ОбъектHttpCollection

HttpCollection — общий контейнер для обработкиhttpзаголовки, запрос, форма, данные cookie в сообщении

В качестве примера мы возьмем заголовки, чтобы проиллюстрировать использование HttpCollection.

HttpCollection поддерживает три формы добавления данных:

1. Добавьте данные «ключ-значение». Добавление данных не изменяет существующие данные «ключ-значение».add

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

1. Добавьте набор данных со значением ключа. Добавление данных не изменяет данные существующего значения ключа.add

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

1. Добавьте данные «ключ-значение». Добавление данных не изменяет существующие данные «ключ-значение».add

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

HttpCollection Форма установки данных такая же, как и добавление, а используемый метод — set.

Мы можем использовать has, чтобы проверить, существуют ли данные с указанным значением ключа в контейнере

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

Используйте для firstполучения первого значения, соответствующего ключу в контейнере:

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

Используйте allдля запроса всех значений указанного значения ключа и возврата массива. Если передается пустой строковый аргумент, возвращается полное значение.

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

Используйте deleteметод, чтобы удалить все данные указанного значения ключа и вернуть trueпредставление.

отношения наследства

Оператор

operator[String]

Обеспечивает прямой доступ к значениям с помощью индексов «ключ-значение».

1
Variant HttpCollection[String];

функция-член

clear

Очистить данные контейнера

1
HttpCollection.clear();

---

has

Проверьте, существуют ли в контейнере данные с указанным значением ключа.

1
Boolean HttpCollection.has(String name);

Параметры звонка:

• name: строка, указывает значение ключа, которое необходимо проверить.

Результаты возврата:

• Boolean, возвращает, существует ли значение ключа

---

first

Запросить первое значение указанного значения ключа

1
Variant HttpCollection.first(String name);

Параметры звонка:

• name: строка, укажите значение ключа, которое будет запрошено.

Результаты возврата:

• Variant, возвращает значение, соответствующее значению ключа, если оно не существует, возвращает неопределенное значение

---

get

Запросите первое значение указанного значения ключа, которое эквивалентно первому

1
Variant HttpCollection.get(String name);

Параметры звонка:

• name: строка, укажите значение ключа, которое будет запрошено.

Результаты возврата:

• Variant, возвращает значение, соответствующее значению ключа, если оно не существует, возвращает неопределенное значение

---

all

Запросить все значения указанного значения ключа

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

Параметры звонка:

• name: строка, укажите значение ключа для запроса, передайте пустую строку, чтобы вернуть результаты всех значений ключа.

Результаты возврата:

• NObject, возвращает массив всех значений, соответствующих значению ключа. Если данные не существуют, возвращает ноль.

---

add

Добавьте данные «ключ-значение». Добавление данных не изменяет существующие данные «ключ-значение».

1
HttpCollection.add(Object map);

Параметры звонка:

• map: Объект, указывает добавляемый словарь данных «ключ-значение».

---

Добавьте набор данных для значения ключа. Добавление данных не изменяет данные существующего значения ключа.

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

Параметры звонка:

• name: строка, указывает добавляемое значение ключа.
• values: Массив, определяет набор добавляемых данных.

---

Добавьте данные «ключ-значение». Добавление данных не изменяет существующие данные «ключ-значение».

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

Параметры звонка:

• name: строка, указывает добавляемое значение ключа.
• value: Вариант, укажите добавляемые данные

---

set

Установите данные значения ключа. Установка данных приведет к изменению первого значения, соответствующего значению ключа, и очистке остальных данных с тем же значением ключа.

1
HttpCollection.set(Object map);

Параметры звонка:

• map: Объект, указывает словарь данных «ключ-значение», который будет установлен.

---

Установите набор данных для значения ключа. Установка данных приведет к изменению значения, соответствующего значению ключа, и очистит оставшиеся данные с тем же значением ключа.

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

Параметры звонка:

• name: Строка, укажите значение ключа, которое будет установлено.
• values: Массив, определяет набор данных для установки.

---

Установите данные значения ключа. Установка данных приведет к изменению первого значения, соответствующего значению ключа, и очистке остальных данных с тем же значением ключа.

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

Параметры звонка:

• name: Строка, укажите значение ключа, которое будет установлено.
• value: Вариант, укажите данные для установки

---

remove

Удалить все значения указанного ключа

1
HttpCollection.remove(String name);

Параметры звонка:

• name: строка, указывает значение ключа, которое необходимо удалить.

---

delete

Удалить все значения указанного ключа

1
HttpCollection.delete(String name);

Параметры звонка:

• name: строка, указывает значение ключа, которое необходимо удалить.

---

sort

Сортировка содержимого контейнера по значению ключа

1
HttpCollection.sort();

---

keys

Запрос значения ключа в контейнере

1
NArray HttpCollection.keys();

Результаты возврата:

• NArray, возвращает массив, содержащий все значения ключей

---

values

Запросить значение в контейнере

1
NArray HttpCollection.values();

Результаты возврата:

• NArray, возвращает массив, содержащий все значения

---

toString

Возвращает строковое представление объекта. Обычно возвращается «[Native Object]». Объект может быть повторно реализован в соответствии с его собственными характеристиками.

1
String HttpCollection.toString();

Результаты возврата:

• String, возвращает строковое представление объекта

---

toJSON

Возвращает представление объекта в формате JSON, обычно возвращая коллекцию читаемых свойств, определенных объектом.

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

Параметры звонка:

• key: Строка, не используется.

Результаты возврата:

• Value, возвращает значение, содержащее сериализуемый JSON