matlab.net.http.HeaderField class

Пакет: matlab.net.http

Поле Header сообщения HTTP

Описание

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

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

Методы

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

Примеры

свернуть все

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

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

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

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

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

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

f1 == f2
ans =   1

В этом примере показано, как определить местоположение определенного поля 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"

Советы

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

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

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

Смотрите также

Введенный в R2017b
Для просмотра документации необходимо авторизоваться на сайте