Заголовки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
Перегрузка: Заголовки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"]