Main Content

addFields

클래스: matlab.net.http.Message
네임스페이스: matlab.net.http

메시지 헤더에 필드 추가

설명

예제

msg = addFields(msg,fields)fields를 각 메시지의 헤더 끝에 추가하고 업데이트된 메시지를 반환합니다.

addFields는 중복된 필드를 확인하지 않지만, RequestMessagesend 메서드와 complete 메서드가 적절하지 않은 중복 항목을 거부할 수 있습니다.

send 메서드나 complete 메서드가 특정 헤더 필드를 자동으로 추가하지 않도록 하려면 빈([]) Value 속성을 사용하여 해당 필드에 대해 addFields를 호출하십시오.

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')

헤더 필드 이름으로, string형으로 지정됩니다.

예: 'Accept'

헤더 필드 값으로, string형이나 fName에 유효한 모든 유형으로 지정됩니다. 필드에 디폴트 값을 사용하려면 fValue''로 설정하십시오. 마지막 값이 누락된 경우 이는 []을 지정하는 것과 동일합니다.

예: 'text/plain'

메시지 헤더 내 위치로, 정수로 지정됩니다. index가 헤더 길이보다 길거나 index가 0이면 이 메서드는 헤더의 끝에 필드를 추가합니다. index가 음수이면 이 메서드는 헤더 끝에서부터 카운트합니다.

예: -1은 마지막 필드 앞에 fields를 삽입합니다.

예제

모두 확장

'text/plain'을 갖는 Accept 헤더 필드를 생성하여 디폴트 요청 메시지에 추가합니다.

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에 개발됨