matlab.net.http.field.AcceptField 클래스

네임스페이스: matlab.net.http.field
슈퍼클래스: matlab.net.http.HeaderField, matlab.net.http.field.MediaRangeField

HTTP Accept 헤더 필드

설명

AcceptField 객체는 요청 메시지에 포함된 HTTP 헤더 필드입니다. 이 필드에는 클라이언트에 허용되는 콘텐츠 유형을 나타내는 하나 이상의 미디어 형식 사양이 포함됩니다. 이 필드에 대한 설명은 IETF^®(Internet Engineering Task Force) 웹사이트의 RFC 7231 Semantics and Content, section 5.3.2 Accept를 참조하십시오.

클래스 특성

Sealed

true

클래스 특성에 대한 자세한 내용은 클래스 특성 항목을 참조하십시오.

생성

설명

obj = matlab.net.http.field.AcceptField(value)는 Value 속성이 value로 설정된 Accept 헤더 필드를 생성합니다.

서버가 서로 다른 MediaType 객체를 반환할 수 있는 경우 특정 유형만 수신하려면 Accept 필드를 사용하십시오. Accept 필드를 지정하지 않으면 서버는 사용자가 모든 유형을 수신 허용한다고 가정합니다.

속성

Name — 헤더 필드 이름

'Accept'

헤더 필드 이름으로, 'Accept'로 지정됩니다.

특성:

GetAccess	public
SetAccess	public

Value — 미디어 형식

matlab.net.http.MediaType 객체의 벡터 | string형으로 구성된 벡터 | 문자형 벡터로 구성된 셀형 배열

미디어 형식으로, matlab.net.http.MediaType 객체의 벡터, string형으로 구성된 벡터 또는 문자형 벡터로 구성된 셀형 배열로 지정됩니다. 모든 문자열은 MediaType 생성자에 허용되는 문자열이어야 합니다. 각 Value는 미디어 형식을 나타내는 구문에 품질('q') 파라미터를 선택적으로 포함할 수 있습니다. 이 필드의 Value 속성은 MediaType 객체를 문자열로 변환한 값의 쉼표로 구분된 목록입니다.

예: MediaType('application/json','q','.5')

특성:

GetAccess	public
SetAccess	public
Dependent	true

메서드

퍼블릭 메서드

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

서브클래스에 대해 특화된 메서드

convert

AcceptField를 쉼표로 구분된 값의 목록으로 구문 분석하고 각 Value 속성을 MediaType 객체로 변환합니다. 각 값은 RFC 7231 Media Type, section 3.1.1.1에 정의된 대로 media-type 표현식입니다.

특화된 연산자와 함수

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

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

예제

미디어 콘텐츠 유형 지정하기

이 예제에서는 클라이언트가 이미지를 읽기 위해 미디어 유형 image/jpeg를 지정하는 방법을 보여줍니다.

import matlab.net.*;
import matlab.net.http.*;
import matlab.net.http.field.*

httpUrl  = 'http://requestserver.mathworks.com';
uri = URI(strcat(httpUrl, '/assets/computerVision.jpg'));
headers = AcceptField(MediaType('image/jpeg')); 
req = RequestMessage('GET', headers);
[~, completedReq, ~] = req.send(uri);
show(completedReq, 0)

GET /assets/computerVision.jpg HTTP/1.1
Host: requestserver.mathworks.com
Accept: image/jpeg
User-Agent: MATLAB/9.11.0.1650920 (R2021b) Prerelease
Date: Wed, 28 Apr 2021 14:33:47 GMT
Accept-Encoding: gzip

버전 내역

R2016b에 개발됨

참고 항목

MediaType | RequestMessage | ResponseMessage