Exponenta Banner

matlab.net.http. Класс HeaderField

Пакет: 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.

Пример: ContentType

Атрибуты:

GetAccess

общественность

SetAccess

общественность

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

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

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

Пример: 'текст/HTML'

Атрибуты:

GetAccess

общественность

SetAccess

общественность

Методы

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

Примеры

свернуть все

Чтобы создать поле заголовка Типа контента, используйте или класс 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
Открыть скрипт

Сообщение ответа HTTP содержит несколько полей заголовка. Этот пример показывает, как определить местоположение определенного поля заголовка, Cache-Control, в ответе от mathworks.com cOM.

Отправьте сообщение в mathworks.com 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

Была ли эта тема полезной?
Документация MATLAB
Поддержка