Exponenta Banner

matlab.net.http.HeaderField class

Пакет: matlab.net.http

Поле заголовка сообщения HTTP

развернуть все на странице

Описание

Используйте HeaderField класс для реализации поля заголовка для сообщения HTTP. Класс обеспечивает преобразования между строками в заголовке и MATLAB® объекты, массивы и структуры. Хотя можно задать HeaderField свойства для произвольных значений, поля заголовка HTTP имеют ограничения на разрешенные символы.

The Name свойство определяет тип поля заголовка. MATLAB предоставляет подклассы для обычно используемых полей в matlab.net.http.field пакет. Чтобы просмотреть список поддерживаемых подклассов, вызовите HeaderField.displaySubclasses способ.

Создание

Описание

пример

obj = matlab.net.http.HeaderField(name,value) создает поле заголовка с Name значение свойства установлено в name и Value значение свойства установлено в value. Любой аргумент может быть пустым двойником, []. Можно задать несколько пар аргументов в любом порядке как name1,value1,...,nameN,valueN. Если последняя value аргумент отсутствует, тогда HeaderField рассматривает его как пустой.

Свойства

расширить все

Имя поля заголовка, заданное как строковый или символьный вектор. Name определяет тип поля, которое определяет допустимые значения для Value свойство. Если вы задаете Name на [] или пустую строку, затем Value является [].

Если этот объект является образцом подкласса, реализующим определенный тип поля заголовка, то этот класс применяет ограничения к Name свойство.

Пример: 'Content-Type'

Атрибуты:

GetAccess
public
SetAccess
public

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

Когда вы читаете это свойство, Value - строка, представляющая значение в поле.

Когда вы устанавливаете это свойство, Value является ли любой тип приемлемым для поля на основе Name свойство и/или класс этого объекта. Результат преобразуется в строку. Если тип поля имеет значение по умолчанию, задайте Value в пустую строку ('' или string('')). Если вы задаете пустую двойку, [], затем сообщение запроса send и complete методы не добавляют это поле к сообщению.

Пример: 'text/html'

Атрибуты:

GetAccess
public
SetAccess
public
Dependent
true

Методы

расширить все

Примеры

свернуть все

Чтобы создать поле заголовка Content-Type, используйте HeaderField класс или ContentTypeField конструктор классов.

Когда вы используете HeaderField конструктор классов, вы задаете Name свойство как 'Content-Type'. Однако, если вы ошибаетесь в имени поля, вы можете не узнать об ошибке, пока сервер не отклонит сообщение. Некоторые серверы молча игнорируют неизвестные имена полей.

f1 = matlab.net.http.HeaderField('Content-Type','text/plain');

Использование ContentTypeField конструктор классов предпочтителен, поскольку вы не можете опечатать имя поля.

f2 = matlab.net.http.field.ContentTypeField('text/plain');

Если на Value свойства те же, тогда поля равны, независимо от того, какой конструктор вы используете.

f1 == f2
ans =   1
Открыть Live Script

В этом примере показано, как найти конкретное поле заголовка Cache-Control в ответе от mathworks.com.

Отправить сообщение в mathworks.com.

request = matlab.net.http.RequestMessage;
uri = matlab.net.URI('https://www.mathworks.com');
response = send(request,uri);

Поиск Cache-Control и отобразите значение.

field = response.getFields('Cache-Control');
value = field.Value
value = 
"max-age=14400"

Совет

  • The HeaderField конструктор создает поля класса HeaderField. Создание поля класса, заданного в matlab.net.http.field вместо этого используйте конструктор подкласса. Для получения списка подклассов вызовите HeaderField.displaySubclasses способ.

    Для примера, matlab.net.http.field.DateField подкласс создает поле заголовка Date. Если вы используете HeaderField класс для создания поля Date, DateField класс интерпретирует и применяет значение, хотя HeaderField не является образцом DateField. Аналогично, если вы преобразовываете значение поля в MATLAB datetime значение, DateField.convert используется метод.

  • Если на HeaderField конструктор отклоняет Name и Value аргументы, используйте GenericField вместо этого конструктор классов.

См. также

Введенный в R2016b

Документация MATLAB

Поддержка