matlab.net.http.HeaderField 클래스

네임스페이스: matlab.net.http

HTTP 메시지의 헤더 필드

설명

HeaderField 클래스를 사용하여 HTTP 메시지에 대한 헤더 필드를 구현할 수 있습니다. 이 클래스는 헤더에 포함된 문자열과 MATLAB^® 객체, 배열, 구조체 간을 변환합니다. HeaderField 속성을 임의 값으로 설정할 수 있지만 HTTP 헤더 필드에는 허용되는 문자에 대한 제약 조건이 있습니다.

Name 속성은 헤더 필드 유형을 정의합니다. MATLAB은 matlab.net.http.field 네임스페이스에서 일반적으로 사용되는 필드에 대한 서브클래스를 제공합니다. 지원되는 서브클래스 목록을 보려면 HeaderField.displaySubclasses 메서드를 호출하십시오.

생성

설명

obj = matlab.net.http.HeaderField(name,value)는 Name 속성이 name으로 설정되고 Value 속성이 value로 설정된 헤더 필드를 생성합니다. 두 인수 중 하나는 빈 double형 []일 수 있습니다. name1,value1,...,nameN,valueN과 같이 여러 개의 인수 쌍을 어떤 순서로든 지정할 수 있습니다. 마지막 value 인수가 누락된 경우 HeaderField는 이 인수를 비어 있는 인수로 처리합니다.

속성

Name — 헤더 필드 이름

string형 | 문자형 벡터

헤더 필드 이름으로, string형이나 문자형 벡터로 지정됩니다. Name은 필드 유형을 결정하며, 이에 따라 Value 속성의 유효한 값이 결정됩니다. Name을 [] 또는 빈 문자열로 설정한 경우 Value는 []입니다.

이 객체가 특정 헤더 필드 유형을 구현하는 서브클래스의 인스턴스인 경우 해당 클래스는 Name 속성에 제약 조건을 적용합니다.

예: 'Content-Type'

특성:

GetAccess	public
SetAccess	public

Value — 헤더 필드 값

string형 | Name에 유효한 모든 유형

헤더 필드 값으로, string형이나 Name 속성에 유효한 모든 유형으로 지정됩니다.

이 속성을 읽어올 경우 Value는 필드의 값을 나타내는 문자열입니다.

이 속성을 설정할 경우 Value는 이 객체의 Name 속성 및/또는 클래스에 따라 필드에 허용되는 모든 유형입니다. 결과는 문자열로 변환됩니다. 필드 유형에 디폴트 값이 있으면 Value를 빈 문자열('' 또는 string(''))로 설정해야 합니다. 빈 double형 []을 지정하면 요청 메시지의 send 메서드와 complete 메서드가 이 필드를 메시지에 추가하지 않습니다.

예: 'text/html'

특성:

GetAccess	public
SetAccess	public
Dependent	true

메서드

퍼블릭 메서드

convert	헤더 필드 값을 MATLAB 유형으로 변환
convertLike	다른 헤더 필드와 유사하게 헤더 필드 값 변환
parse	헤더 필드 값을 구문 분석하고 string형으로 반환
addFields	HeaderField 배열에 필드 추가
removeFields	헤더 필드 배열에서 필드 제거
changeFields	HeaderField 배열의 기존 값 변경
replaceFields	HeaderField 배열의 값 변경 또는 HeaderField 배열에 필드 추가
getFields	이름이나 클래스가 일치하는 헤더 필드 반환
eq	두 개의 HeaderField 배열 비교
displaySubclasses	지원되는 HeaderField 서브클래스 표시

특화된 연산자와 함수

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

isequal	eq 메서드에서 설명하는 것과 같이, 두 헤더 필드 배열이 크기가 같고 대응되는 요소가 동일하면 true를 반환합니다.
string	헤더 필드로 구성된 배열을 메시지에 나타나는 대로 string형으로 반환합니다. 새 줄 문자가 필드와 필드 사이에 삽입되지만, 모든 필드의 끝에는 삽입되지 않습니다.
char	헤더 필드로 구성된 배열을 string 메서드에서 설명한 것처럼 문자형 벡터로 반환합니다.

예제

헤더 필드 생성자 선택하기

Content-Type 헤더 필드를 생성하려면 HeaderField 클래스 생성자 또는 ContentTypeField 클래스 생성자를 사용하십시오.

HeaderField 클래스 생성자를 사용할 경우 Name 속성을 'Content-Type'으로 지정합니다. 그러나, 필드 이름의 철자를 잘못 입력한 경우 서버가 메시지를 거부할 때까지 오류가 있는지 모를 수 있습니다. 일부 서버는 알 수 없는 필드 이름에 대해 아무런 오류도 표시하지 않고 무시하기도 합니다.

f1 = matlab.net.http.HeaderField('Content-Type','text/plain');

필드 이름의 철자를 잘못 입력하면 안 되기 때문에 ContentTypeField 클래스 생성자를 사용하는 것이 좋습니다.

f2 = matlab.net.http.field.ContentTypeField('text/plain');

Value 속성이 같으면 사용되는 생성자에 상관없이 필드도 동일합니다.

f1 == f2

ans =    1

HTTP의 HeaderField 배열에서 값 찾기

이 예제는 mathworks.com에서 전송된 응답 메시지에서 Cache-Control이라는 특정 헤더 필드를 찾는 방법을 보여줍니다.

메시지를 mathworks.com으로 보냅니다.

request = matlab.net.http.RequestMessage;
uri = matlab.net.URI('https://www.mathworks.com');
response = send(request,uri);

Cache-Control을 검색하고 그 값을 표시합니다.

field = response.getFields('Cache-Control');
value = field.Value

value = 
"max-age=14400"

팁

• HeaderField 생성자는 HeaderField 클래스의 필드를 생성합니다. matlab.net.http.field 네임스페이스에 정의된 클래스의 필드를 생성하려면 서브클래스 생성자를 대신 사용하십시오. 서브클래스 목록을 보려면 HeaderField.displaySubclasses 메서드를 호출하십시오.

  예를 들어, matlab.net.http.field.DateField 서브클래스는 Date 헤더 필드를 생성합니다. HeaderField 클래스를 사용하여 Date 필드를 생성하면 HeaderField가 DateField의 인스턴스가 아니더라도 DateField 클래스가 값을 해석하여 적용합니다. 마찬가지로, 필드 값을 MATLAB datetime 값으로 변환하면 DateField.convert 메서드가 사용됩니다.

• HeaderField 생성자가 Name 인수와 Value 인수를 거부하는 경우 GenericField 클래스 생성자를 대신 사용하십시오.

버전 내역

R2016b에 개발됨

참고 항목

matlab.net.http.field.GenericField