Main Content

websave

RESTful 웹 서비스의 콘텐츠를 파일로 저장

페이지 내 모두 축소

구문

outfilename = websave(filename,url)
outfilename = websave(filename,url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)
outfilename = websave(___,options)

설명

예제

outfilename = websave(filename,url)은 url에서 지정한 웹 서비스에서 제공하는 콘텐츠를 저장하고 이를 filename에 씁니다. websave 함수는 filename의 전체 경로를 outfilename으로 반환합니다.

웹 서비스는 JSON, XML, 이미지 또는 텍스트와 같은 인터넷 미디어 유형으로 형식이 지정된 데이터를 반환하는 RESTful 인터페이스를 제공합니다.

outfilename = websave(filename,url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)은 쿼리 파라미터를 하나 이상의 파라미터 이름과 값 쌍으로 지정하여 url에 추가합니다. 웹 서비스는 쿼리 파라미터를 정의합니다.

예제

outfilename = websave(___,options)는 weboptions 객체 options에서 지정한 다른 HTTP 요청 옵션을 추가합니다. 위에 열거된 구문에 나와 있는 입력 인수 조합에 추가하여 이 인수를 지정할 수 있습니다.

websave는 HTTP GET 메서드와 POST 메서드를 지원합니다. HTTP POST 요청을 보내려면 options의 RequestMethod 속성을 "post"로 지정하십시오. 많은 웹 서비스는 GET 메서드와 POST 메서드를 모두 제공하여 데이터를 요청합니다.

예제

모두 축소

라이브 스크립트 열기

웹 서버의 이미지를 현재 폴더에 파일로 저장합니다.

httpsUrl = "https://requestserver.mathworks.com";
imageUrl = strcat(httpsUrl,"/assets/computerVision.jpg");
imageFile = "computerVision.jpg";
imageFileFullPath = websave(imageFile,imageUrl);
라이브 스크립트 열기

웹 서버 파일의 날씨 데이터를 현재 폴더에 CSV 파일로 저장합니다.

httpsUrl = "https://requestserver.mathworks.com";
dataUrl = strcat(httpsUrl,"/assets/weatherStation.csv");
weatherFile = "weatherData.csv";
weatherFileFullPath = websave(weatherFile,dataUrl);
라이브 스크립트 열기

데이터베이스의 직원 데이터를 현재 폴더에 텍스트 파일로 저장합니다. fileread 함수와 jsondecode 함수를 사용하여 텍스트 파일에서 JSON 형식의 직원 데이터를 추출합니다.

httpUrl = "http://requestserver.mathworks.com";
employeeUrl = strcat(httpUrl,"/employee");
employeeFile = "employeeData.txt";
employeeFileFullPath = websave(employeeFile,employeeUrl,"occupation","Software Engineer");
employeeData = jsondecode(fileread(employeeFileFullPath))
employeeData=2×1 struct array with fields:
    id
    firstName
    lastName
    occupation
    age
    city

웹사이트에서 JSON 데이터를 읽어와 test.txt 파일에 저장합니다.

uri = matlab.net.URI("http://httpbin.org/get");
websave("test.txt",uri,weboptions("ContentType","json"));

파일에 저장된 텍스트를 JSON 데이터의 구조체로 읽어옵니다.

js = jsondecode(fileread("test.txt"))
js = 

  struct with fields:

       args: [1×1 struct]
    headers: [1×1 struct]
     origin: '144.444.4.4'
        url: 'http://httpbin.org/get'

입력 인수

모두 축소

콘텐츠를 저장할 파일의 이름으로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. websave는 콘텐츠를 있는 그대로 저장합니다. websave는 options.ContentType 속성과 options.ContentReader 속성이 설정되어 있더라도, 이들 속성을 무시합니다.

예: websave("matlabcentral.html","https://www.mathworks.com/matlabcentral")은 지정된 웹페이지를 읽고 그 페이지의 HTML을 matlabcentral.html 파일에 저장합니다.

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

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

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

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

예: websave("webread_search.html","https://www.mathworks.com/matlabcentral/fileexchange/","term","simulink")는 File Exchange에 업로드된 파일 중 simulink라는 단어를 포함하는 파일의 목록을 검색하고, 검색 결과를 HTML 파일에 저장합니다.

추가 HTTP 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 항목을 참조하십시오.

세부 정보

모두 축소

RESTful

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

팁

  • RESTful 웹 서비스 함수에서 지원하지 않는 기능에 대해서는 HTTP를 사용하여 MATLAB에서 웹 서비스 호출하기 항목을 참조하십시오.

  • HTTP POST 요청의 경우, websave 함수는 application/x-www-form-urlencoded 미디어 유형만 지원합니다. 다른 인터넷 미디어 유형의 콘텐츠와 함께 POST 요청을 보내려면 webwrite를 사용하십시오.

  • 프록시 서버 설정을 지정하는 방법에 대한 자세한 내용은 프록시 서버 인증 항목을 참조하십시오.

확장 기능

버전 내역

R2014b에 개발됨

모두 확장

참고 항목

함수

도움말 항목

외부 웹사이트