Link Search Menu Expand Document

ЗаголовкиHttp

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

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

graph BT;
Заголовки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()

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

Исключения

ИсключениеНедопустимыйАргумент - если Заголовки содержит пустые или недопустимые имена заголовков (см 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