Перейти к основному содержимому

ЗаголовкиHttp

Стд::Http::ЗаголовкиHttp

Изменяемая коллекция заголовков HTTP. При получении значения заголовка регистр имени заголовка не учитывается. Внутри заголовки хранятся с сохранением регистра. Сохраняет порядок вставки заголовков.

Сравнение ссылочное

Иерархия типа

Базовые типы: Объект, Стд::Http::ЧитаемыеЗаголовкиHttp


Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.ПолучитьПервый("Header") // "Val1"
Заголовки.ПолучитьВсе("header") // ["Val1", "Val2"]
Заголовки.Имена() // ["Header", "header"]
Заголовки.Добавить("AnotherHeader", "Val3")
Заголовки.Имена() // ["Header", "header", "AnotherHeader"]
Заголовки.Удалить("header")
Заголовки.Имена() // ["AnotherHeader"]
Заголовки.Очистить()
Заголовки.Имена() // []

Конструкторы

ЗаголовкиHttp

ЗаголовкиHttp()
Перегрузка:
ЗаголовкиHttp(Заголовки: ЧитаемоеСоответствие<Строка, Число|Строка|Обходимое<Число|Строка>>)

Создает пустую коллекцию заголовков.

Примеры

знч Заголовки = новый ЗаголовкиHttp()
Заголовки.Имена() // []

ЗаголовкиHttp

Перегрузка:
ЗаголовкиHttp()

Создает новую коллекцию заголовков из соответствия Заголовки.

Исключения

ИсключениеНедопустимыйАргумент - если Заголовки содержит пустые или недопустимые имена заголовков (см RFC2822 раздел 2.2).

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]

Методы

Добавить

Добавить(
ИмяЗаголовка: Строка,
Значение: Число|Строка|ЧитаемыйМассив<Число|Строка>
): ЗаголовкиHttp

Добавляет новый заголовок с именем ИмяЗаголовка и значением Значение. Запрещено устанавливать заголовки Content-Length и Transfer-Encoding. Возвращает текущий экземпляр.

Исключения

ИсключениеНедопустимыйАргумент - если ИмяЗаголовка пустое или содержит недопустимые символы (см RFC2822 раздел 2.2).

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]
Заголовки.Добавить("AnotherHeader", "Val3")
Заголовки.Имена() // ["Header", "header", "AnotherHeader"]

ДобавитьЗаголовки

ДобавитьЗаголовки(Заголовки: ЧитаемыеЗаголовкиHttp): ЗаголовкиHttp

Добавляет все заголовки из коллекции заголовков Заголовки. Запрещено устанавливать заголовки Content-Length и Transfer-Encoding. Возвращает текущий экземпляр.

Примеры

знч Заголовки = новый ЗаголовкиHttp()
Заголовки.Имена() // []
Заголовки.ДобавитьЗаголовки(новый ЧитаемыеЗаголовкиHttp({"Header": "Val1", "header": "Val2"}))
Заголовки.Имена() // ["Header", "header"]

Очистить

Очистить(): ЗаголовкиHttp

Удаляет все заголовки. Возвращает текущий экземпляр.

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]
Заголовки.Очистить()
Заголовки.Имена() // []

Удалить

Удалить(ИмяЗаголовка: Строка): ЗаголовкиHttp

Удаляет заголовок с именем ИмяЗаголовка (если есть). Возвращает текущий экземпляр.

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"}) Заголовки.Имена() // ["Header", "header"]

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]
Заголовки.Удалить("AnotherHeader")
Заголовки.Имена() // ["Header", "header"]
Заголовки.Удалить("header")
Заголовки.Имена() // []

Установить

Установить(
ИмяЗаголовка: Строка,
Значение: Число|Строка|ЧитаемыйМассив<Число|Строка>
): ЗаголовкиHttp

Устанавливает заголовок с именем ИмяЗаголовка и значением Значение. Если заголовок с таким именем уже существует, то значение заголовка будет заменено. Возвращает текущий экземпляр.

Исключения

ИсключениеНедопустимыйАргумент - если ИмяЗаголовка пустое или содержит недопустимые символы (см RFC2822 раздел 2.2).

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]
Заголовки.Установить("AnotherHeader", "Val3")
Заголовки.Имена() // ["Header", "header", "AnotherHeader"]
Заголовки.Установить("header", "Val4")
Заголовки.Имена() // ["header", "AnotherHeader"]
Заголовки.ПолучитьВсе("header") // ["Val4"]

УстановитьЗаголовки

УстановитьЗаголовки(Заголовки: ЧитаемыеЗаголовкиHttp): ЗаголовкиHttp

Очищает все заголовки и копирует заголовки из коллекции Заголовки. Запрещено устанавливать заголовки Content-Length и Transfer-Encoding. Возвращает текущий экземпляр.

Примеры

знч Заголовки = новый ЗаголовкиHttp({"Header": "Val1", "header": "Val2"})
Заголовки.Имена() // ["Header", "header"]
Заголовки.УстановитьЗаголовки(новый ЧитаемыеЗаголовкиHttp({"AnotherHeader": "Val3", "header": "Val4"}))
Заголовки.Имена() // ["header", "AnotherHeader"]
Заголовки.ПолучитьВсе("header") // ["Val4"]

Список унаследованных методов

Объект

ВСтроку, ПолучитьТип, Представление

ЧитаемыеЗаголовкиHttp

Имена, ПолучитьВсе, ПолучитьПервый, Содержит