addFields

Класс: matlab.net.http.Message
Пакет: matlab.net.http

Добавить поля в заголовок сообщения

Описание

пример

msg = addFields(msg,fields) добавляет fields в конец заголовка каждого сообщения и возвращает обновленное сообщение.

addFields проверяет не повторяющиеся поля, а RequestMessage send и complete методы могут отклонить неподходящие дубликаты.

Чтобы предотвратить send или complete методы из автоматического добавления определенного поля заголовка, вызов addFields для этого поля с пустым ([]) Value свойство.

msg = addFields(msg,fName,fValue) добавляет поле с именем fName и ценностные fValue.

пример

msg = addFields(msg,fName1,fValue1,...,fNameN,fValueN) добавляет поля, заданные fName, fValue аргументы в виде пар в указанном порядке.

пример

msg = addFields(msg,index,___) вставляет поля в index и может включать в себя любой из входных параметров в предыдущих синтаксисах.

Входные параметры

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

Сообщение, заданное как matlab.net.http.Message объект.

Поля для добавления, заданные как вектор или список , разделенный запятыми одного или нескольких matlab.net.http.HeaderField объекты.

Пример: matlab.net.http.HeaderField('Accept','text/plain')

Имя поля заголовка, заданное как строка.

Пример: 'Accept'

Значение поля заголовка, заданное как строка или любой тип, допустимый для fName. Чтобы использовать значение по умолчанию для поля, установите fValue на ''. Если последнее значение отсутствует, это то же самое, что и установка [].

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

Расположение в заголовке сообщения в виде целого числа. Если index больше длины заголовка или index 0, метод добавляет поля в конец. Если index отрицательно, метод отсчитывает из конца заголовка.

Пример: -1 вставляет fields перед последним полем

Примеры

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

Создайте поле заголовка Accept со значением 'text/plain' и добавьте его к сообщению запроса по умолчанию.

field = matlab.net.http.HeaderField('Accept','text/plain');
m = matlab.net.http.RequestMessage('get');
msg = addFields(m,field);
show(msg)
GET
Accept: text/plain

Добавьте два поля заголовка в сообщение запроса.

m = matlab.net.http.RequestMessage('get');
msg = addFields(m,'Accept','text/plain','Cache-Control','no-store, no-cache');
show(msg)
GET
Accept: text/plain
Cache-Control: no-store, no-cache

Создайте сообщение запроса с двумя полями заголовка.

m = matlab.net.http.RequestMessage('get');
msg = addFields(m,'Accept','text/plain','Cache-Control','no-store, no-cache');

Вставьте поле заголовка Content-Type перед последним полем заголовка в сообщение.

f = matlab.net.http.HeaderField('Content-Type','text/plain');
msg = addFields(msg,-1,f);
show(msg)
GET
Accept: text/plain
Content-Type: text/plain
Cache-Control: no-store, no-cache
Введенный в R2016b