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가 해당 이미지 형식을 지원하는 경우, 이미지를 반환합니다. 지원되는 이미지 형식을 보려면 가져오기 및 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

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

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

예제

모두 축소

라이브 스크립트 열기

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

이미지 데이터 읽기

httpsUrl = 'https://requestserver.mathworks.com';
imageUrl = strcat(httpsUrl, '/assets/computerVision.jpg');
rgb = webread(imageUrl);
whos rgb
  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");
axis padded

라이브 스크립트 열기

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

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

데이터베이스 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('https://www.mathworks.com/matlabcentral')은 웹 페이지를 읽어 들이고 HTML을 문자형 배열로 반환합니다.

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

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

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

예: webread('https://www.mathworks.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 콘텐츠에 대한 숫자형 행렬 또는 논리형 행렬. 첫 번째 출력 인수가 인덱스 이미지인 경우, 두 번째 출력 인수는 컬러맵이고 세 번째 출력 인수는 알파 채널입니다.

지원되는 이미지 형식을 보려면 가져오기 및 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

'audio'

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

지원되는 오디오 형식을 보려면 가져오기 및 내보내기에 지원되는 파일 형식 항목을 참조하십시오.

'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를 사용하여 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 옵션을 지정하십시오.

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

확장 기능

버전 내역

R2014b에 개발됨

참고 항목

| | | | | | | |

도움말 항목

외부 웹사이트