이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

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')이 아닌 다른 인터넷 미디어 유형으로 쓰려면 optionsMediaType을 지정하십시오.

데이터를 HTTP POST 요청으로 요청하고 함수를 사용하여 응답을 읽으려면 optionsContentReader 속성을 해당 함수에 대한 핸들로 지정하십시오. 여러 출력 인수를 반환하는 함수에 대한 핸들을 지정하면 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 채널에 대한 첫 번째 업데이트인 경우, response1이 됩니다.

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

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

data =

42

ThingSpeak 서버의 채널 피드에 숫자를 form-encode된 문자형 배열로 쓰고 다시 읽어옵니다.

이 코드를 실행하기 위해 ThingSpeak 계정을 만듭니다. ThingSpeak 계정의 Write API 키와 채널 ID를 사용하여 webwrite를 호출합니다. Write API 키와 숫자를 form-encode된 문자형 배열로 인코딩합니다. 디폴트 필드 이름은 'field1'입니다.

thingSpeakURL = 'http://api.thingspeak.com/';
thingSpeakWriteURL = [thingSpeakURL 'update'];
writeApiKey = 'Your Write API Key';
data = 42;
data = num2str(data);
data = ['api_key=',writeApiKey,'&field1=',data];
response = webwrite(thingSpeakWriteURL,data)

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

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

channelID = num2str(Your Channel ID);
thingSpeakReadURL = [thingSpeakURL 'channels/' channelID '/fields/field1/last'];
data = webread(thingSpeakReadURL,'api_key',writeApiKey)

data =

42

ThingSpeak 서버의 채널 피드에 숫자를 JSON 객체로 쓰고 응답을 JSON 객체로 읽어옵니다.

이 코드를 실행하기 위해 ThingSpeak 계정을 만듭니다. ThingSpeak 계정의 Write API 키와 채널 ID를 사용하여 webwrite를 호출합니다. Write API 키와 숫자를 필드로 갖는 구조체를 만듭니다. 디폴트 필드 이름은 'field1'입니다. 미디어 유형을 'application/json'으로 지정합니다.

thingSpeakURL = 'http://api.thingspeak.com/update.json';
writeApiKey = 'Your Write API Key';
data = 42;
data = struct('api_key',writeApiKey,'field1',data);
options = weboptions('MediaType','application/json');
response = webwrite(thingSpeakURL,data,options)

response = 

channel_id: Your Channel ID
field1: 42
field2: []
field3: []
field4: []
field5: []
field6: []
field7: []
field8: []
created_at: '2014-11-14T20:08:14Z'
entry_id: 1
status: []
latitude: []
longitude: []
elevation: []
location: []

webwrite는 사용자가 ThingSpeak 채널에 쓴 숫자를 포함하는 JSON 객체를 응답으로 받습니다. webwrite는 JSON 객체를 변환하고 이것을 response에 구조체로 반환합니다.

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 채널에 대한 첫 번째 업데이트인 경우, response1이 됩니다.

채널에 대한 마지막 항목을 읽어옵니다. 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에 지정한 날짜와 일치합니다.

입력 인수

모두 축소

웹 서비스에 대한 URL로, 문자형 벡터 또는 string형 스칼라로 지정됩니다. 웹 서비스는 RESTful 인터페이스를 구현합니다. 자세한 내용은 RESTful 항목을 참조하십시오.

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

PostValuedatetime 객체로 지정하는 경우, 이것의 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 값을 기준으로 변환됩니다. 미디어 형식의 전체 목록을 보려면 인터넷 미디어 형식을 참조하십시오.

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

추가 HTTP 요청 옵션으로, weboptions 객체로 지정됩니다. weboptions 속성에 해당하는 모든 요청 옵션을 보려면 weboptions를 참조하십시오.

출력 인수

모두 축소

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

세부 정보

모두 축소

RESTful

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

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

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

  • JSON은 표준 날짜 형식을 정의하지 않으므로 webwritedatetime 객체를 JSON으로 변환할 수 없습니다.

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

R2015a에 개발됨