addFields

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

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

Описание

пример

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

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

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

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

пример

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

пример

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