主要内容

webwrite

写数据到RESTful web服务

描述

例子

响应= webwrite (url,PostName1, PostValue1,…, PostNameN PostValueN)将内容写入指定的web服务url并返回响应。输入参数PostName1, PostValue1,…, PostNameN PostValueN指定内容名称-值对。webwriteform-encodes体内的名称-值对一个HTTP POST请求的web服务。web服务定义响应

web服务提供了一个宁静的返回数据格式化为JSON等互联网媒体类型,XML、图像或文本。

例子

响应= webwrite (url,数据)的帖子数据指定的web服务url并设置媒体类型的基础上数据

输入参数数据指定表单编码的字符数组的内容。webwrite数据在人体内一个HTTP POST请求的web服务。web服务定义响应

例子

响应= webwrite (___,选项)HTTP请求添加其他选项,指定的weboptions对象选项。您可以使用该语法与任何输入参数的前面的语法。

写的内容作为一个互联网媒体类型而不是一个表单编码的字符数组(“应用程序/ x-www-form-urlencoded”),指定MediaType的属性选项

与一个HTTP POST请求请求数据和读取响应函数,指定ContentReader的属性选项作为一个处理函数。如果您指定一个处理函数返回多个输出参数,webwrite返回所有输出参数。

例子

全部折叠

写一个数字频道以ThingSpeak服务器和阅读。

运行这段代码,创建一个ThingSpeak帐户。调用webwrite使用写API键和通道从ThingSpeak帐户ID。默认字段名“field1”

thingSpeakURL = ' http://api.thingspeak.com/ ';thingSpeakWriteURL = [thingSpeakURL '更新'];writeApiKey = '你写API密匙”;字段名=“field1”;fieldValue = 42;响应= webwrite (thingSpeakWriteURL api_key, writeApiKey,字段名,fieldValue)

如果这个调用webwrite是第一个更新ThingSpeak通道,响应1

读回你写你的频道数量。ThingSpeak提供了一个不同的URL最后进入你的频道。你的频道ID是URL的一部分。

channelID = num2str (您的频道ID);thingSpeakReadURL = [thingSpeakURL的渠道/ channelID /字段的字段名' / '];data = webread (thingSpeakReadURL api_key, writeApiKey)
data = 42

这个例子展示了如何编写数据到一个Web服务器。

httpUrl =“http://requestserver.mathworks.com”;delim =“&”;pairDelim =“=”;数据= 42;data = num2str(数据);data = (“关键”pairDelim,“价值”delim,“字段”、pairDelim数据);responseData = webwrite中(httpUrl、数据);disp (responseData)中;
数据类型的应用程序/ x-www-form-urlencoded dataSize:“18”

这个例子展示了如何编写一个记录作为一个JSON对象。

httpsUrl =“https://requestserver.mathworks.com”;员工(1)。Name =“乔”;员工(1)。职业=“医生”;员工(2)。Name =“莎拉”;员工(2)。职业=“工程师”;选择= weboptions (“MediaType”,“application / json”);responseEmployee = webwrite (httpsUrl、雇员、选项)
responseEmployee =结构体字段:数据类型:“application / json;charset = utf - 8 ' dataSize:“79”

写一个数字和一个特定的日期通道以ThingSpeak服务器。阅读的数量和日期。

运行这段代码,创建一个ThingSpeak帐户。调用webwrite使用写API键和通道从ThingSpeak帐户ID。指定日期的提要条目datetime对象。

thingSpeakURL = ' http://api.thingspeak.com/ ';thingSpeakWriteURL = [thingSpeakURL '更新'];writeApiKey = '你写API密匙”;字段名=“field1”;fieldValue = 42;D = datetime(8 2015 3, 22日,15日,30日,“格式”,“yyyy-MM-dd HH: mm: ss”);响应= webwrite (thingSpeakWriteURL api_key, writeApiKey,…字段名,fieldValue created_at ' D)

如果这个调用webwrite是第一个更新ThingSpeak通道,响应1

读回最后一个进入你的频道。ThingSpeak提供了一个不同的URL最后进入你的频道。附加last.jsonURL获取数据的JSON对象。你的频道ID是URL的一部分。

channelID = num2str (您的频道ID);thingSpeakReadURL = [thingSpeakURL的渠道/ channelID /领域的…字段名' / last.json '];data = webread (thingSpeakReadURL api_key, writeApiKey)
data = created_at: 2015 - 03 - 22——t08:15:30z entry_id: 1 field1:“42”

的日期created_at场比赛中指定的日期D

写两个名称-值对参数httpbin.org。该网站返回请求的参数。

uri = matlab.net.URI (“http://httpbin.org/post”);res = webwrite (uri,“field1”,“你好”,“field2”,“世界”);res.form
ans =结构体字段:field1:‘你好’field2:‘世界’

输入参数

全部折叠

web服务URL,指定为一个特征向量或字符串标量。包括传输协议。只有httphttps都受支持金宝app。web服务实现RESTful接口。看到宁静的为更多的信息。

Web服务post参数,指定为一个或多个对名称参数。一个PostName参数必须指定一个post参数的名称。一个PostValue参数必须是一个特征向量,一个字符串标量,或一个数字,逻辑,或datetime值指定的参数的值。数字、逻辑和datetime值可以在数组。web服务定义了名称-值对,它接受一个请求的一部分。webwrite编码一个表单编码的字符数组的名称-值对的身体一个HTTP POST请求并将内容类型设置为应用程序/ x-www-form-urlencoded默认情况下。

当你指定PostValue作为一个datetime对象,您必须指定它格式属性使其符合web服务所需的格式。如果格式属性包含一个时区或抵消,datetime对象不是分区,然后webwrite指定“本地”时区。

当一个PostValue参数数组中包含多个值,指定ArrayFormat财产的weboptions对象form-encode指定的数组作为web服务。

例子:webwrite (“//www.tatmou.com/matlabcentral/fileexchange/”,“词”,‘webwrite’,‘时间’,7)检索的列表文件上传到文件交换包含这个词在过去的7天webwrite。web服务定义文件交换术语持续时间参数。

数据发布到一个web服务,指定为一个特征向量,一个字符串标量,或数字,细胞,逻辑,或结构MediaType价值json的或作为文档对象模型MediaType价值“XML”。如果数据是一个字符串或字符向量,然后呢webwrite发送不转换。所有其他类型转换的基础上weboptions.MediaType价值。有关更多信息,请参见https://tools.ietf.org/html/rfc6838

例子:webwrite (' //www.tatmou.com/matlabcentral/fileexchange/ ', ' = webwrite&duration = 7”)检索的列表文件上传到文件交换包含这个词在过去的7天webwrite。web服务定义文件交换术语持续时间参数。

额外的HTTP请求的选项,指定为一个weboptions对象。看到weboptions对所有请求选项weboptions属性。

输出参数

全部折叠

响应从web服务,作为一个标量,返回数组,结构,或表。

更多关于

全部折叠

宁静的

休息意味着具象状态传输常见的的一种建筑风格的web服务。RESTful接口提供标准的HTTP方法,比如GET、PUT、POST、或删除。

提示

  • 功能不支持的基于rest的web服务功能,看金宝app到HTTP接口

  • webwrite函数写PostName, PostValue输入参数为表单编码的字符数组。如果你指定选项输入参数,那么它的MediaType属性必须“应用程序/ x-www-form-urlencoded”

  • webwrite不能转换datetimeJSON对象,因为JSON没有定义一个标准的日期格式。

  • webwrite总是把PostName, PostValue查询参数的身体信息的价值无关RequestMethod的属性选项

  • 指定代理服务器设置,明白了代理服务器认证

介绍了R2015a