webwrite

RESTful 웹 서비스에 데이터 쓰기

페이지 내 모두 축소

구문

response = webwrite(url,PostName1,PostValue1,...,PostNameN,PostValueN)
response = webwrite(url,data)
response = webwrite(___,options)

설명

response = webwrite(url,PostName1,PostValue1,...,PostNameN,PostValueN)은 url로 지정된 웹 서비스에 콘텐츠를 쓰고 response로 응답을 반환합니다. 입력 인수 PostName1,PostValue1,...,PostNameN,PostValueN은 쓸 콘텐츠를 하나 이상의 파라미터 이름과 값 쌍으로 지정합니다. webwrite는 웹 서비스에 대한 HTTP POST 요청의 본문에서 콘텐츠를 form-encode합니다. 웹 서비스는 response를 정의합니다.

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

예제

response = webwrite(url,data)는 url로 지정된 웹 서비스에 data를 게시하고 data를 기준으로 미디어 유형을 설정합니다.

입력 인수 data는 쓸 콘텐츠를 form-encode된 문자형 배열로 지정합니다. webwrite는 웹 서비스에 대한 HTTP POST 요청의 본문에 data를 넣습니다. 웹 서비스는 response를 정의합니다.

예제

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

콘텐츠를 form-encode된 문자형 배열("application/x-www-form-urlencoded")이 아닌 다른 인터넷 미디어 유형으로 쓰려면 options의 MediaType을 지정하십시오.

데이터를 HTTP POST 요청으로 요청하고 함수를 사용하여 응답을 읽으려면 options의 ContentReader 속성을 해당 함수에 대한 핸들로 지정하십시오. 여러 출력 인수를 반환하는 함수에 대한 핸들을 지정하면 webwrite가 모든 출력 인수를 반환합니다.

예제

예제

모두 축소

ThingSpeak™ 서버의 채널 피드에 숫자를 쓰고 다시 읽어옵니다.

이 코드를 실행하기 위해 ThingSpeak 계정을 만듭니다. ThingSpeak 계정의 Write API 키와 채널 ID를 사용하여 webwrite를 호출합니다. 디폴트 필드 이름은 "field1"입니다.

thingSpeakURL = "http://api.thingspeak.com/";
thingSpeakWriteURL = thingSpeakURL + "update";
writeApiKey = "Your Write API Key";
fieldName = "field1";
fieldValue = 42;
response = webwrite(thingSpeakWriteURL,"api_key",writeApiKey,fieldName,fieldValue)

webwrite에 대한 이 호출이 ThingSpeak 채널에 대한 첫 번째 업데이트인 경우, response는 1이 됩니다.

채널에 쓴 숫자를 다시 읽어옵니다. ThingSpeak는 채널에 대한 마지막 항목을 가져올 다른 URL을 제공합니다. 채널 ID는 URL의 일부입니다.

channelID = num2str(Your Channel ID);
thingSpeakReadURL = thingSpeakURL + "channels/" + channelID + "/fields/" + fieldName  "/last"];
data = webread(thingSpeakReadURL,"api_key",writeApiKey)

data =

42
라이브 스크립트 열기

웹 서버에 form-encode된 문자형 데이터를 씁니다.

httpUrl = "http://requestserver.mathworks.com";
delim = "&";
pairDelim = "=";
data = 42;
data = num2str(data);
data = ["key",pairDelim,"value",delim,"field",pairDelim,data];
responseData = webwrite(httpUrl,data)
responseData = struct with fields:
    dataType: 'application/json; charset=UTF-8'
    dataSize: '40'
라이브 스크립트 열기

데이터베이스 레코드를 JSON 객체로 씁니다.

httpsUrl = "https://requestserver.mathworks.com";
employee(1).Name = "Jon";
employee(1).Occupation = "Doctor";
employee(2).Name = "Sarah";
employee(2).Occupation = "Engineer";
options = weboptions("MediaType","application/json");
responseEmployee = webwrite(httpsUrl,employee,options)
responseEmployee = struct with fields:
    dataType: 'application/json; charset=UTF-8'
    dataSize: '79'

ThingSpeak 서버의 채널 피드에 숫자와 특정 날짜를 씁니다. 숫자와 날짜를 다시 읽어옵니다.

이 코드를 실행하기 위해 ThingSpeak 계정을 만듭니다. ThingSpeak 계정의 Write API 키와 채널 ID를 사용하여 webwrite를 호출합니다. datetime 값을 사용하여 피드 항목의 날짜를 지정합니다.

thingSpeakURL = "http://api.thingspeak.com/";
thingSpeakWriteURL = thingSpeakURL + "update";
writeApiKey = "Your Write API Key";
fieldName = "field1";
fieldValue = 42;
D = datetime(2015,3,22,8,15,30,"Format","yyyy-MM-dd HH:mm:ss");
response = webwrite(thingSpeakWriteURL,"api_key",writeApiKey, ...
    fieldName,fieldValue,"created_at",D)

webwrite에 대한 이 호출이 ThingSpeak 채널에 대한 첫 번째 업데이트인 경우, response는 1이 됩니다.

채널에 대한 마지막 항목을 읽어옵니다. ThingSpeak는 채널에 대한 마지막 항목을 가져올 다른 URL을 제공합니다. URL에 last.json을 추가하여 데이터를 JSON 객체로 받습니다. 채널 ID는 URL의 일부입니다.

channelID = num2str(Your Channel ID);
thingSpeakReadURL = thingSpeakURL + "channels/" + channelID + "/fields/" ...
    + fieldName + "/last.json";
data = webread(thingSpeakReadURL,"api_key",writeApiKey)

data = 

    created_at: '2015-03-22T08:15:30Z'
      entry_id: 1
        field1: '42'

created_at 필드의 날짜가 D에 지정한 날짜와 일치합니다.

두 쌍의 파라미터 이름과 파라미터 값을 httpbin.org에 씁니다. 해당 사이트는 이 요청의 POST 파라미터를 반환합니다.

uri = matlab.net.URI("http://httpbin.org/post");
res = webwrite(uri,"field1","hello ","field2","world");
res.form

ans = 

  struct with fields:

    field1: 'hello '
    field2: 'world'

입력 인수

모두 축소

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

웹 서비스 게시 파라미터로, 하나 이상의 파라미터 이름과 값 쌍으로 지정됩니다. PostName 인수는 게시 파라미터의 이름을 지정하는 문자형 벡터 또는 string형 스칼라여야 합니다. PostValue 인수는 게시 파라미터의 값을 지정하는 문자형 벡터 또는 string형 스칼라이거나 숫자형, 논리형 또는 datetime형 값이어야 합니다. 숫자형, 논리형, datetime형 값이 배열에 들어 있을 수 있습니다. 웹 서비스는 요청의 일부로 받는 파라미터를 정의합니다. webwrite는 HTTP POST 요청의 본문에서 파라미터를 form-encode된 문자형 배열로 인코딩하고 콘텐츠 유형을 기본적으로 application/x-www-form-urlencoded로 설정합니다.

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

PostValue 인수가 배열에 여러 개의 값을 포함할 경우, weboptions 객체의 ArrayFormat 속성을 지정하여 웹 서비스에서 요구하는 대로 배열을 form-encode하십시오.

예: webwrite("https://www.mathworks.com/matlabcentral/fileexchange/","term","webwrite","duration",7)은 지난 7일 동안 File Exchange에 업로드된 파일 중에서 webwrite 함수가 포함된 파일의 목록을 가져옵니다. File Exchange 웹 서비스는 term 파라미터와 duration 파라미터를 정의합니다.

웹 서비스에 쓸 데이터로, 문자형 벡터, string형 스칼라, 숫자형 스칼라, 셀형, 논리형 스칼라로 지정되거나 구조체(MediaType의 값이 "json"인 경우) 또는 문서 객체 모델(MediaType의 값이 "XML"인 경우)로 지정됩니다. data가 문자형 벡터 또는 string형 스칼라인 경우 webwrite는 데이터를 변환하지 않고 전송합니다. 다른 모든 유형은 weboptions.MediaType 값을 기준으로 변환됩니다. 자세한 내용은 RFC Editor 웹사이트의 RFC 6838 Media Type Specifications and Registration Procedures를 참조하십시오.

추가 HTTP 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 속성으로 나열된 모든 요청 옵션을 보려면 weboptions 항목을 참조하십시오.

출력 인수

모두 축소

웹 서비스의 응답으로, 스칼라, 배열, 구조체 또는 table형으로 반환됩니다.

세부 정보

모두 축소

팁

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

  • 웹 서비스 API는 HTTP 1.1만 지원합니다.

  • webwrite 함수는 PostName,PostValue 입력 인수를 form-encode된 문자형 배열로 씁니다. options 입력 인수도 지정한다면 그 객체의 MediaType 속성은 "application/x-www-form-urlencoded"여야 합니다.

  • JSON은 표준 날짜 형식을 정의하지 않으므로 webwrite는 datetime 값을 JSON으로 변환할 수 없습니다.

  • webwrite는 options의 RequestMethod 속성값에 관계없이 PostName,PostValue 쿼리 파라미터를 메시지의 본문에 넣습니다.

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

확장 기능

모두 확장

버전 내역

R2015a에 개발됨

모두 확장

참고 항목

함수

도움말 항목

외부 웹사이트