webread
RESTful 웹 서비스에서 콘텐츠 읽어 들이기
구문
설명
은 쿼리 파라미터를 하나 이상의 파라미터 이름과 값 쌍으로 지정하여 data
= webread(url
,QueryName1,QueryValue1,...,QueryNameN,QueryValueN
)url
에 추가합니다. 메시지 본문에 쿼리를 삽입하려면 webwrite
를 사용하십시오. 웹 서비스는 쿼리 파라미터를 정의합니다.
는 data
= webread(___,options
)weboptions
객체 options
에서 지정한 다른 HTTP 요청 옵션을 추가합니다. 위에 열거된 구문에 나와 있는 입력 인수 조합에 추가하여 이 인수를 지정할 수 있습니다.
데이터를 특정 출력 유형으로 반환하려면 options
의 ContentType
속성을 지정하십시오.
함수로 콘텐츠를 읽어 들이려면 options
의 ContentReader
속성을 함수에 대한 핸들로 지정하십시오. webread
는 웹 서비스에서 데이터를 다운로드하고 지정한 함수로 데이터를 읽어 들입니다.
여러 출력 인수를 반환하는 함수에 대한 핸들을 지정하면
webread
가 모든 출력 인수를 반환합니다.출력 인수를 반환하지 않는 함수에 대한 핸들을 지정하는 경우(예: 비디오 파일에 대한 Image Processing Toolbox™ 함수
@implay
),webread
는 출력 인수를 반환하지 않습니다.
[
는 data
,colormap
,alpha
] = webread(___)url
에서 지정한 웹 서비스에서 이미지를 읽어 들이고 그 이미지를 data
에 반환합니다. 위에 열거된 구문을 사용하여 이미지만 반환할 수 있습니다. 이미지와 연결된 컬러맵과 알파 채널을 반환하려면 이 구문을 사용하십시오.
webread
는 HTTP 응답에 이미지 미디어 형식을 지정하는 Content-Type
헤더 필드가 있고 imread
가 해당 이미지 형식을 지원하는 경우, 이미지를 반환합니다. 지원되는 이미지 형식을 보려면 가져오기 및 내보내기에 지원되는 파일 형식 항목을 참조하십시오.
[
는 data
,Fs
] = webread(___)url
에 지정한 웹 서비스에서 오디오 데이터를 읽어 들이고 그 데이터를 data
에 반환합니다. 위에 열거된 구문을 사용하여 오디오 데이터만 반환할 수 있습니다. 오디오 데이터의 샘플 레이트(단위: 헤르츠)를 반환하려면 이 구문을 사용하십시오.
webread
는 HTTP 응답에 오디오 미디어 유형을 지정하는 Content-Type
헤더 필드가 있고 audioread
가 해당 오디오 형식을 지원하는 경우, 오디오 데이터를 반환합니다. 지원되는 오디오 형식을 보려면 가져오기 및 내보내기에 지원되는 파일 형식 항목을 참조하십시오.
예제
입력 인수
출력 인수
세부 정보
팁
RESTful 웹 서비스 함수에서 지원하지 않는 기능에 대해서는 HTTP를 사용하여 MATLAB에서 웹 서비스 호출하기 항목을 참조하십시오.
webread
는 HTTP GET 메서드와 POST 메서드를 지원합니다. 많은 웹 서비스는 GET 메서드와 POST 메서드를 모두 제공하여 데이터를 요청합니다. HTTP POST 요청을 보내려면options
의RequestMethod
속성을"post"
로 지정하십시오. 하지만webread
는 쿼리 옵션을 요청 메시지의 본문이 아니라url
에 삽입합니다. 쿼리를 본문에 삽입하려면webwrite
를 사용하십시오.HTTP POST 요청의 경우,
webread
함수는application/x-www-form-urlencoded
미디어 유형만 지원합니다. 다른 인터넷 미디어 유형의 콘텐츠와 함께 POST 요청을 보내려면webwrite
를 사용하십시오.이 함수는 처리 방법을 결정하기 위해 웹 문서 내용을 검토하지 않습니다. 예를 들어, HTML 문서와 XML 문서에는 문서의 문자 인코딩을 지정하는
<meta>
태그가 포함되는 경우가 많습니다. 인코딩이 디폴트webread
인코딩과 다를 경우weboptions
에서 원하는CharacterEncoding
옵션을 지정하십시오.프록시 서버 설정을 지정하는 방법에 대한 자세한 내용은 프록시 서버 인증 항목을 참조하십시오.