主要内容

Webrad.

从RESTful web服务读取内容

描述

例子

数据= Webrad(URL.从指定的web服务读取内容URL.并返回内容数据

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

例子

数据= Webrad(URL.queryname1,queryvalue1,...,querynamen,queryvaluen添加查询参数URL.,由一对或多对名称-值参数指定。要将查询放入消息体,请使用webwrite。web服务定义查询参数。

例子

数据= Webrad(___选项添加其他HTTP请求选项,由此指定WebOptions.对象选项。您可以使用上一个语法的任何输入参数使用此语法。

要将数据作为特定输出类型返回,请指定内容类型的属性选项

要使用函数读取内容,请指定ContentReader的属性选项作为函数的句柄。Webrad.从web服务下载数据,并使用指定的函数读取数据:

  • 如果为返回多个输出参数的函数指定句柄,Webrad.返回所有输出参数。

  • 如果将句柄指定为返回输出参数的函数(例如图像处理工具箱™功能)@implay对于视频文件),Webrad.返回任何输出参数。

(数据COLOROMAP.α] = Webrad(___从指定的web服务读取图像URL.并返回图像数据。您可以使用前面的语法仅返回图像。使用此语法返回与图像相关联的颜色映射和alpha通道。

Webrad.当HTTP响应具有内容类型标题字段,用于指定图像媒体类型,如果Imread.万博1manbetx支持图像格式。有关支持万博1manbetx的图像格式,请参见万博1manbetx支持的导入和导出的文件格式

(数据Fs] = Webrad(___从指定的Web服务中读取音频数据URL.并返回音频数据数据。您可以使用前面的语法只返回音频数据。使用此语法返回以赫兹为单位的音频数据的采样率。

Webrad.HTTP响应有一个返回音频数据内容类型指定音频媒体类型的标题字段,如果audioread万博1manbetx支持音频格式。有关支持万博1manbetx的音频格式,请参见万博1manbetx支持的导入和导出的文件格式

例子

全部折叠

此示例显示如何从网站读取图像并显示它。

读取图像数据

httpsurl =“https://requestserver.mathworks.com”;imageUrl = strcat (httpsUrl,“/资产/ computerVision.jpg”);RGB = Webrabread(imageUrl);谁是rgb
名称大小字节类属性rgb 360x640x3 691200 uint8

调整大小和显示图像

RGB = imresize(RGB, 0.6);imshow (rgb)

此示例显示了如何读取来自a的温度CSV.数据文件。

从CSV文件读取数据

httpsurl =“https://requestserver.mathworks.com”;dataUrl = strcat (httpsUrl,“/sset/weatherstation.csv”);data = webread (dataUrl);时间= (data.Time);temp = [data.TempF];

显示温度图

绘图(时间,临时)xlabel(“时间”)ylabel(“温度(Farenheit)”)标题(“随着时间的推移,温度”);轴填充

此示例显示如何使用查询参数选择记录。

查看员工数据库结构

显示数据库的字段员工

httpsurl =“https://requestserver.mathworks.com”;EmployeeURL = Strcat(Httpsurl,“/员工”);Fieldnames(Webrabread(employeeURL))
ans =6×1个细胞{'id'} {'firstname'} {'lastname'} {'职业'} {'age'} {'city'}

选择员工

jSmith = webread (employeeUrl,“firstName”“约翰”“姓”“史密斯”);DISP(jsmith);
id: 1 firstName: 'John' lastName: 'Smith'职业:'Software Engineer'年龄:'32'城市:'Boston'

这个示例展示了如何将数据作为特定类型返回。

读取数据

httpUrl =“http://requestserver.mathworks.com”;EmployeeURL = Strcat(httpurl,“/员工”);

将记录作为字符数组

创建一个WebOptions.对象,并设置其内容类型'文本'。的Webrad.函数将JSON对象转换为字符数组。

选项= weboptions(“ContentType”“文本”);sBrown = webread (employeeUrl,“firstName”“莎拉”, 选项);DISP(SBROWN)
[{" id ": 2,“firstName”:“莎拉”,“姓”:“褐色”,“占领”:“软件工程师”,“年龄”:“28”、“城市”:“纽约”}]

输入参数

全部折叠

web服务的URL,指定为字符向量或字符串标量。包括传输协议。只有httphttps得到支持万博1manbetx。Web服务实现RESTful接口。看到宁静的想要查询更多的信息。

例子:webread(“//www.tianjin-qmedu.com/matlabcentral”)读取网页并将其HTML返回为字符数组。

Web服务查询参数,指定为一对或多对名称-值参数。一个QueryName参数必须指定查询参数的名称,如字符向量或字符串标量。一个QueryValue.参数必须是字符向量,字符串标量或数字,逻辑,或约会时间指定查询参数值的值。数字,逻辑和约会时间值可以在数组中。web服务定义了它作为请求的一部分接受的名称-值对。

当您指定时QueryValue.作为一个约会时间对象,则必须指定其格式属性,以便它与web服务所需的格式一致。如果格式属性包括时区或偏移量,以及约会时间对象未分区Webrad.指定'当地的'作为时区。

QueryValue.包含数组中的多个值,您可能需要指定ArrayFormat财产的WebOptions.要形成Web服务指定的阵列的对象。

例子:webread(“//www.tianjin-qmedu.com/matlabcentral/fileexchange/”,“词”,“webread”)检索上载到文件交换的包含该单词的文件列表Webrad.

附加的HTTP请求选项,指定为WebOptions.目的。

您可以指定内容类型财产的WebOptions.对象,并将对象作为输入参数传递给Webrad.。然后Webrad.返回数据作为那种输出。属性中可以指定的有效内容类型WebOptions.目的。

内容类型说明符

输出类型

“汽车”(默认)

根据服务器指定的内容类型自动确定输出类型。

'文本'

内容类型的字符矢量:

文字/平原
text / html
text / xml
应用程序/ XML
应用程序/ javascript.
应用程序/ x-javascript
应用程序/ x-www-form-urlencoded

如果一个web服务返回一个MATLAB®文件。m扩展时,函数将其内容作为字符向量返回。

'图片'

数字或逻辑矩阵图像/格式内容。如果第一个输出参数是索引图像,则第二个输出参数是ColorMap,第三个输出参数是alpha通道。

有关支持万博1manbetx的图像格式,请参见万博1manbetx支持的导入和导出的文件格式

'声音的'

数字矩阵音频/格式以数字标量采样率作为第二个输出参数的内容。

有关支持万博1manbetx的音频格式,请参见万博1manbetx支持的导入和导出的文件格式

'二进制'

uint8.二进制内容的列向量(即,内容不被视为类型字符).

“表”

电子表格和CSV的标量表对象(文字/ CSV.) 内容。

json的

字符、数字、逻辑、结构或单元格数组,用于应用/ JSON.内容。

'xmldom'

java.®的文档对象模型(DOM)节点text / xml或者应用程序/ XML内容。如果未指定,该函数将返回XML内容作为字符向量。

“生”

字符列向量为'文本''xmldom', 和json的内容。该函数将任何其他内容类型返回为auint8.列向量。

看到WebOptions.适用于所有请求选项WebOptions.特性。

输出参数

全部折叠

从web服务读取的内容,以标量、数组、结构或表的形式返回。

与索引图像相关联的颜色映射,作为数字数组返回。

与索引图像相关联的Alpha通道,作为数字数组返回。

音频数据的采样率(以赫兹为单位),返回一个正数值标量。

更多关于

全部折叠

宁静的

休息意味着具象状态传输,用于Web服务的常见架构风格。RESTful接口提供标准的HTTP方法,例如GET,PUT,POST或DELETE。

提示

  • 对于RESTFUL Web服务功能不支持的功万博1manbetx能,请参阅HTTP接口

  • Webrad.万博1manbetx支持HTTP GET和POST方法。许多web服务同时提供GET和POST方法来请求数据。要发送HTTP POST请求,请指定RequestMethod的属性选项作为'邮政'。然而,Webrad.将查询选项放入URL.,而不是在请求消息体中。要将查询放入主体,请使用webwrite

  • 对于HTTP POST请求,Webrad.功能仅支持万博1manbetx应用程序/ x-www-form-urlencoded媒体类型。若要发送带有任何其他互联网媒体类型内容的POST请求,请使用webwrite

  • 此函数不检查文档内容以确定如何处理它。例如,HTML和XML文档通常包含< meta >标记指定文档字符编码。如果编码与默认值不同Webrad.编码,然后指定正确字符编码选项WebOptions.

  • 要指定代理服务器设置,请参阅代理服务器认证

介绍在R2014B.