exponenta event banner

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