addFields

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

Добавьте поля, чтобы передать заголовок

Синтаксис

msg = addFields(msg,fields)
msg = addFields(msg,fName,fValue)
msg = addFields(msg,fName1,fValue1,...,fNameN,fValueN)
msg = addFields(msg,index,___)

Описание

пример

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

addFields не проверяет на дублирующиеся поля, но send RequestMessage и методы 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 перед последним полем

Примеры

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

Создайте Принять поле заголовка со значением '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');

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

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

Введенный в R2017b