Main Content

webread

RESTful 웹 서비스에서 콘텐츠 읽어 들이기

페이지 내 모두 축소

구문

data = webread(url)
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)
data = webread(___,options)
[data,colormap,alpha] = webread(___)
[data,Fs] = webread(___)

설명

예제

data= webread(url)은url에서 지정한 웹 서비스에서 콘텐츠를 읽어 들이고 그 콘텐츠를data에 반환합니다.

웹 서비스는 JSON, XML, 이미지 또는 텍스트와 같은 인터넷 미디어 유형으로 형식이 지정된 데이터를 반환하는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가해당 이미지 형식을 지원하는 경우, 이미지를 반환합니다. 지원되는 이미지 형식을 보려면Supported File Formats for Import and Export항목을 참조하십시오.

[data,Fs] = webread(___)는url에 지정한 웹 서비스에서 오디오 데이터를 읽어 들이고 그 데이터를data에 반환합니다. 위에 열거된 구문을 사용하여 오디오 데이터만 반환할 수 있습니다. 오디오 데이터의 샘플 레이트(단위: 헤르츠)를 반환하려면 이 구문을 사용하십시오.

webread는 HTTP 응답에 오디오 미디어 유형을 지정하는Content-Type헤더 필드가 있고audioread가해당 오디오 형식을 지원하는 경우, 오디오 데이터를 반환합니다. 지원되는 오디오 형식을 보려면Supported File Formats for Import and Export항목을 참조하십시오.

예제

모두 축소

라이브 스크립트 열기

이 예제에서는 이미지를 웹 사이트에서 읽어 들인 후 표시하는 방법을 보여줍니다.

이미지 데이터 읽기

httpsUrl ='https://requestserver.mathworks.com'; imageUrl = strcat(httpsUrl,'/assets/computerVision.jpg'); rgb = webread(imageUrl); whosrgb
Name Size Bytes Class Attributes rgb 360x640x3 691200 uint8

이미지 크기 조정 및 표시

rgb = imresize(rgb, 0.6); imshow(rgb)

라이브 스크립트 열기

이 예제에서는csv데이터 파일에서 온도를 읽어 들이는 방법을 보여줍니다.

CSV 파일에서 데이터 읽어 들이기

httpsUrl ="https://requestserver.mathworks.com"; dataUrl = strcat(httpsUrl,"/assets/weatherStation.csv"); data = webread(dataUrl); time = [data.Time]; temp = [data.TempF];

온도 플롯 표시하기

plot(time, temp) xlabel("Time") ylabel("Temperature (Farenheit)") title("Temperature Over Time"); axispadded

라이브 스크립트 열기

이 예제에서는 쿼리 파라미터를 사용하여 레코드를 선택하는 방법을 보여줍니다.

직원 데이터베이스 구조 보기

데이터베이스employee의 필드를 표시합니다.

httpsUrl ="https://requestserver.mathworks.com"; employeeUrl = strcat(httpsUrl,"/employee"); fieldnames(webread(employeeUrl))
ans =6×1 cell{'id' } {'firstName' } {'lastName' } {'occupation'} {'age' } {'city' }

firstName및lastName으로 직원 선택하기

jSmith = webread(employeeUrl,“firstName","John","lastName","Smith"); disp(jSmith);
id: 1 firstName: 'John' lastName: 'Smith' occupation: 'Software Engineer' age: '32' city: 'Boston'
라이브 스크립트 열기

이 예제에서는 날짜를 지정된 유형으로 반환하는 방법을 보여줍니다.

데이터 읽어오기

httpUrl ="http://requestserver.mathworks.com"; employeeUrl = strcat(httpUrl,"/employee");

문자형 배열로 레코드 반환하기

weboptions객체를 만들고 이 객체의ContentType을'text'로 설정합니다.webread함수는 JSON 객체를 문자형 배열로 변환합니다.

options = weboptions("ContentType","text"); sBrown = webread(employeeUrl,“firstName","Sarah", options); disp(sBrown)
[{"id":2,"firstName":"Sarah","lastName":"Brown","occupation":"Software Engineer","age":"28","city":"New York"}]

입력 인수

모두 축소

웹 서비스에 대한 URL로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 전송 프로토콜을 포함합니다.http및https만 지원됩니다. 웹 서비스는 RESTful 인터페이스를 구현합니다. 자세한 내용은RESTful항목을 참조하십시오.

예:webread('//www.tatmou.com/matlabcentral')은 웹 페이지를 읽어 들이고 HTML을 문자형 배열로 반환합니다.

웹 서비스 쿼리 파라미터로, 하나 이상의 이름-값 쌍 인수로 지정됩니다.QueryName인수는 쿼리 파라미터의 이름을 문자형 벡터 또는 string형 스칼라로 지정해야 합니다.QueryValue인수는 쿼리 파라미터의 값을 지정하는 문자형 벡터 또는 string형 스칼라이거나 숫자형, 논리형 또는datetime형 값이어야 합니다. 숫자형, 논리형,datetime형 값이 배열에 들어 있을 수 있습니다. 웹 서비스는 요청의 일부로 받는 이름-값 쌍을 정의합니다.

QueryValue를datetime객체로 지정하는 경우, 이것의Format속성을 웹 서비스에서 요구하는 형식과 일치하도록 지정해야 합니다.Format속성이 표준 시간대나 오프셋을 포함하고,datetime객체의 시간대가 지정되지 않은 경우,webread는'Local'을 표준 시간대로 지정합니다.

QueryValue가배열에 여러 개의 값을 포함할 경우,weboptions객체의ArrayFormat속성을 지정하여 웹 서비스에서 지정한 대로 배열을 form-encode해야 할 수 있습니다.

예:webread('//www.tatmou.com/matlabcentral/fileexchange/','term','webread')는 File Exchange에 업로드된 파일 중에서webread라는 단어를 포함하는 파일의 목록을 검색합니다.

추가 HTTP 요청 옵션으로,weboptions객체로 지정됩니다.

weboptions객체의ContentType속성을 지정하고 그 객체를webread에 입력 인수로 전달할 수 있습니다. 그러면webread가data를 출력 유형으로 반환합니다. 다음 표에weboptions객체에서 지정할 수 있는 올바른 콘텐츠 유형이 나열되어 있습니다.

ContentType지정자

출력 유형

'auto'(디폴트 값)

출력 유형은 서버가 지정한 콘텐츠 유형을 기반으로 자동으로 결정됩니다.

'text'

아래 콘텐츠 유형에 대한 문자형 벡터:

text/plain
text/html
text/xml
application/xml
application/javascript
application/x-javascript
application/x-www-form-urlencoded

웹 서비스가.m확장자를 가지는 MATLAB®파일을 반환하는 경우, 함수는 파일의 내용을 문자형 벡터로 반환합니다.

'image'

image/format콘텐츠에 대한 숫자형 행렬 또는 논리형 행렬. 첫 번째 출력 인수가 인덱스 이미지인 경우, 두 번째 출력 인수는 컬러맵이고 세 번째 출력 인수는 알파 채널입니다.

지원되는 이미지 형식을 보려면Supported File Formats for Import and Export항목을 참조하십시오.

'audio'

숫자형 스칼라 샘플링 레이트를 두 번째 출력 인수로 포함하는audio/format콘텐츠에 대한 숫자형 행렬.

지원되는 오디오 형식을 보려면Supported File Formats for Import and Export항목을 참조하십시오.

'binary'

이진 콘텐츠(즉,char형으로 취급되지 않는 콘텐츠)에 대한uint8형 열 벡터.

'table'

스프레드시트 및 CSV(text/csv) 콘텐츠에 대한 스칼라 테이블 객체.

'json'

application/json콘텐츠에 대한char형, 숫자형, 논리형, 구조체 또는 셀형 배열.

'xmldom'

text/xml또는application/xml콘텐츠에 대한 Java®DOM(문서 객체 모델) 노드. 지정하지 않는 경우, 함수는 XML 콘텐츠를 문자형 벡터로 반환합니다.

'raw'

'text','xmldom','json'콘텐츠에 대한char열 벡터. 함수는 그 밖의 콘텐츠 유형을uint8형 열 벡터로 반환합니다.

weboptions속성에 해당하는 모든 요청 옵션을 보려면weboptions를 참조하십시오.

출력 인수

모두 축소

웹 서비스에서 읽은 콘텐츠로, 스칼라, 배열, 구조체, 테이블 중 하나로 반환됩니다.

인덱스 이미지와 연결된 컬러맵으로, 숫자형 배열로 반환됩니다.

인덱스 이미지와 연결된 알파 채널로, 숫자형 배열로 반환됩니다.

오디오 데이터의 샘플 레이트(단위: 헤르츠)로, 양의 숫자형 스칼라로 반환됩니다.

세부 정보

모두 축소

RESTful

REST는REpresentational State Transfer즉, 웹 서비스에 대한 공통된 구조적 스타일을 의미합니다. RESTful 인터페이스는 GET, PUT, POST 또는 DELETE와 같은 표준 HTTP 메서드를 제공합니다.

팁

  • RESTful 웹 서비스 기능에서 지원하지 않는 기능에 대해서는HTTP 인터페이스항목을 참조하십시오.

  • 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 문서에는 문서의 문자 인코딩을 지정하는태그가 포함되는 경우가 많습니다. 인코딩이 디폴트webread인코딩과 다를 경우weboptions에서 올바른CharacterEncoding옵션을 지정하십시오.

  • 프록시 서버 설정을 지정하려면Proxy Server Authentication항목을 참조하십시오.

버전 내역

R2014b에 개발됨

참고 항목

||||||||

도움말 항목

외부 웹 사이트