matlab.net.http.Message 클래스

패키지: matlab.net.http

HTTP 요청 메시지 또는 응답 메시지

설명

Message 클래스는 HTTP 메시지를 생성하는 데 기본 클래스로 사용되는 추상 클래스입니다.

속성

StartLine — 메시지의 첫 번째 라인

matlab.net.http.StartLine 객체

메시지의 첫 번째 라인으로, matlab.net.http.StartLine 객체(있는 경우)로 지정됩니다.

특성:

GetAccess	public
SetAccess	public

Header — 메시지 헤더

[] (디폴트 값) | matlab.net.http.HeaderField 객체

메시지 헤더로, matlab.net.http.HeaderField 객체로 지정되거나 HeaderField 객체의 벡터로 지정됩니다. Header 속성을 설정하면 MATLAB^®이 헤더 필드가 메시지 유형에 적합한지 확인합니다. RequestMessage의 send 메서드와 complete 메서드가 적절하게 구성된 요청에 필요한 모든 헤더 필드를 채웁니다.

특성:

GetAccess	public
SetAccess	public

Body — 메시지 본문

[] (디폴트 값) | matlab.net.http.MessageBody 객체 | matlab.net.http.io.ContentProvider

메시지 본문으로, matlab.net.http.MessageBody 객체, matlab.net.http.io.ContentProvider 또는 MessageBody 생성자에 허용되는 데이터로 지정됩니다. 기본적으로 Body는 비어 있습니다([]로 설정됨). Body 속성을 포함하는 요청 메시지는 일반적으로 디폴트 값 'GET'이 아닌 'PUT' 또는 'POST'와 같은 메서드를 사용하지만, 이 규칙이 강제적인 것은 아닙니다.

완료되었거나 수신된 메시지에 ContentTypeField 헤더 필드가 있는 경우 MessageBody.ContentType 속성이 해당 값으로 설정됩니다. 그렇지 않으면, ContentType이 변경되지 않거나 비어 있습니다.

특성:

GetAccess	public
SetAccess	public

Completed — 메시지 완료 여부

false (디폴트 값) | true

메시지 완료 여부로, true 또는 false로 지정됩니다. true 값은 메시지가 완료되었음을 의미합니다.

메시지(send 및 complete)의 유효성을 확인하는 RequestMessage 메서드는 다음과 같은 경우 Completed 속성을 true로 설정합니다.

• 메시지가 유효합니다.

• 처리가 완료되었습니다. 예를 들어, 필요한 헤더 필드가 추가되고 데이터가 변환되었습니다.

이 속성이 true인 경우 이러한 메서드는 메시지를 수정하지 않으며 send 메서드가 메시지의 유효성을 검사하지 않고 메시지를 전송합니다. 이후에 이 메시지를 변경하면 Completed 값이 false로 다시 변경됩니다.

메시지를 반환하는 메서드는 다음과 같은 경우 Completed를 true로 설정합니다.

• Body 속성이나 Body.Data 속성이 비어 있습니다.

• Body.Payload 속성에 원시 데이터가 포함되어 있습니다.

요청 메시지에 데이터가 포함된 경우(Body.Data가 비어 있지 않음), 이 속성은 Body.Payload가 원시 데이터를 포함하는 경우에만 true입니다.

응답 메시지에서 페이로드는 HTTPOptions.SavePayload 속성을 true로 설정한 경우에만 설정됩니다.

특성:

GetAccess	public
SetAccess	public
Transient	true

데이터형: logical

메서드

퍼블릭 메서드

addFields	메시지 헤더에 필드 추가
changeFields	메시지 헤더의 기존 필드 변경
getFields	이름이나 클래스가 일치하는 메시지 헤더 필드 반환
removeFields	메시지 헤더에서 필드 제거
replaceFields	Change values in or add fields to message header
show	메시지를 서식 지정하여 표시 또는 반환

특화된 연산자와 함수

다음 메서드는 표준 MATLAB 연산자와 함수를 이 클래스의 객체를 위해 특화합니다.

string	메시지 Header, Body 및 StartLine 속성을 string형으로 반환합니다. 여러 메시지의 경우 string형 배열을 반환합니다. Body에 문자로 변환할 수 없는 이진 데이터가 포함되어 있으면 이 메서드는 데이터 길이(단위: 바이트)를 나타내는 메시지를 표시합니다. 문자열은 전송되거나 수신되었을 때 메시지가 어떻게 표시되는지에 대한 대략적인 표현입니다. 로깅, 진단 또는 디버그를 위해 사용하십시오. 메시지의 서식이 지정된 버전이 필요한 경우 show를 사용하십시오.
char	string과 같으나, 메시지를 문자형 벡터로 반환합니다.
isequal	두 메시지 배열의 모든 메시지의 가시적 퍼블릭 속성이 동일하면 true를 반환합니다.

팁

• 요청 메시지에서 임의 헤더와 데이터를 전송하려면 Completed 속성을 true로 설정하여 send 메서드가 메시지를 수정하지 않도록 방지하십시오. complete 메서드를 사용하여 메시지의 유효성을 계속 검사할 수는 있지만, send 메서드는 이 메시지의 유효성을 검사하지 않습니다.

버전 내역

R2016b에 개발됨

참고 항목

RequestMessage | ResponseMessage | MessageBody | ContentTypeField | HeaderField