addFields

클래스: matlab.net.http.Message
네임스페이스: 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는 중복된 필드를 확인하지 않지만, RequestMessage의 send 메서드와 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에 개발됨

참고 항목

|