主要内容

webread

从rest式web服务读取内容

折叠所有页面

语法

数据= webread(url)
data = webread(url,QueryName1,QueryValue1，…，QueryNameN,QueryValueN)
数据= webread(___选项)
[data,colormap,alpha] = webread(___）
[data,Fs] = webread(___）

描述

例子

数据= webread (url）从指定的web服务中读取内容url并返回内容数据．

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

例子

数据= webread (url，QueryName1, QueryValue1,…,QueryNameN QueryValueN）将查询参数附加到url，由一对或多对名称-值参数指定。要将查询放入消息体中，请使用webwrite．web服务定义查询参数。

例子

数据= webread (___，选项）属性指定的其他HTTP请求选项weboptions对象选项．您可以将此语法与前面语法的任何输入参数一起使用。

要将数据作为特定的输出类型返回，请指定ContentType的属性选项．

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

  • 如果指定函数的句柄返回多个输出参数，webread返回所有输出参数。

  • 如果指定不返回输出参数的函数句柄(例如图像处理工具箱™函数)@implay视频文件)，webread不返回输出参数。

［数据，colormap，α= webread(___）从指定的web服务中读取图像url并返回图像数据．您可以使用前面的语法只返回图像。使用此语法返回与图像相关的颜色映射和alpha通道。

webread当HTTP响应有内容类型头字段，指定图像媒体类型和ifimread金宝app支持图像格式。有关支持金宝app的图像格式，请参见金宝app导入和导出支持的文件格式．

［数据，Fs= webread(___）从指定的web服务中读取音频数据url并返回音频数据数据．您可以使用前面的语法只返回音频数据。使用此语法返回音频数据的采样率(以赫兹为单位)。

webread返回音频数据时，HTTP响应有内容类型头字段，指定音频媒体类型和ifaudioread金宝app支持音频格式。有关支持金宝app的音频格式，请参见金宝app导入和导出支持的文件格式．

例子

全部折叠

打开实时脚本

这个例子展示了如何从网站读取图像并显示它。

读取图像数据

httpsUrl =“https://requestserver.mathworks.com”；imageUrl = strcat(httpsUrl，“/资产/ computerVision.jpg”）;rgb = webread(imageUrl);谁rgb
名称大小字节类属性rgb 360x640x3 691200 uint8

调整大小和显示图像

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

打开实时脚本

实例中读取温度csv数据文件。

从CSV文件中读取数据

httpsUrl =“https://requestserver.mathworks.com”；daturl = strcat(httpsUrl，“/资产/ weatherStation.csv”）;data = webread(dataUrl);time = [data.Time];temp = [data.TempF];

显示温度图

Plot (time, temp) xlabel(“时间”) ylabel (“温度(华氏)”)标题(“随时间变化的温度”）;轴垫

打开实时脚本

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

查看员工数据库结构

显示数据库字段员工．

httpsUrl =“https://requestserver.mathworks.com”；employeeUrl = strcat(httpsUrl，“/员工”）;fieldnames (webread (employeeUrl))
ans =6×1细胞{“id”}{“firstName”}{的lastName}{‘占领’}{‘年龄’}{‘城市’}

按以下方式选择员工firstName而且姓

jSmith = webread(employeeUrl，“firstName”，“约翰。”，“姓”，“史密斯”）;disp (jSmith);
id: 1姓:“约翰”姓:“史密斯”职业:“软件工程师”年龄:“32”城市:“波士顿”
打开实时脚本

这个例子展示了如何以特定类型返回数据。

读取数据

httpUrl =“http://requestserver.mathworks.com”；employeeUrl = strcat(httpUrl，“/员工”）;

将记录返回为字符数组

创建一个weboptions对象，并将其ContentType来“文本”．的webread函数将JSON对象转换为字符数组。

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

输入参数

全部折叠

web服务的URL，指定为字符向量或字符串标量。包括传输协议。只有http而且https都受支持金宝app。web服务实现了RESTful接口。看到宁静的获取更多信息。

例子:webread(“//www.tatmou.com/matlabcentral”)读取网页并以字符数组的形式返回它的HTML。

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

当你指定QueryValue作为一个datetime对象时，必须指定其格式属性，使其与web服务所需的格式一致。如果格式属性包含时区或偏移量，而datetime那么，对象没有分区webread指定“本地”作为时区。

当QueryValue数组中包含多个值，则可能需要指定ArrayFormat的属性weboptions对象按web服务指定的方式对数组进行形式编码。

例子:webread(“//www.tatmou.com/matlabcentral/fileexchange/”,“词”,“webread”)检索上传到文件交换的包含单词的文件列表webread．

附加的HTTP请求选项，指定为weboptions对象。

您可以指定ContentType的属性weboptions对象，并将该对象作为输入参数传递给webread．然后webread返回数据就像那样的输出。类中指定的有效内容类型weboptions对象。

ContentType说明符

输出类型

“汽车”(默认)

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

“文本”

内容类型的字符向量:

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

如果web服务返回MATLAB®使用．m扩展时，函数将其内容作为字符向量返回。

“图像”

的数字或逻辑矩阵图像/格式内容。如果第一个输出参数是一个索引图像，第二个输出参数是颜色映射，第三个输出参数是alpha通道。

有关支持金宝app的图像格式，请参见金宝app导入和导出支持的文件格式．

“音频”

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

有关支持金宝app的音频格式，请参见金宝app导入和导出支持的文件格式．

“二元”

uint8二进制内容的列向量(即不作为类型处理的内容)字符）.

“表”

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

json的

字符、数字、逻辑、结构或单元格数组，用于application / json内容。

“xmldom”

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

“生”

字符的列向量“文本”，“xmldom”,json的内容。函数返回任何其他内容类型uint8列向量。

看到weboptions的所有请求选项weboptions属性。

输出参数

全部折叠

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

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

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

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

更多关于

全部折叠

宁静的

休息意味着具象状态转移，这是web服务的一种常见架构风格。RESTful接口提供标准的HTTP方法，如GET、PUT、POST或DELETE。

提示

  • 有关rest式web服务函数不支持的功能，请金宝app参阅使用HTTP和MATLAB．

  • webread金宝app支持HTTP GET和POST方法。许多web服务同时提供GET和POST方法来请求数据。要发送HTTP POST请求，请指定RequestMethod的属性选项作为“职位”．然而,webread将查询选项放入url，而不是在请求消息的主体中。要将查询放入主体，请使用webwrite．

  • 对于HTTP POST请求，使用webread函数只支持金宝app应用程序/ x-www-form-urlencoded媒体类型。要发送带有任何其他互联网媒体类型内容的POST请求，请使用webwrite．

  • 此函数不检查文档内容以确定如何处理它。例如，HTML和XML文档经常包含< meta >标记，该标记指定文档字符编码。如果编码与默认值不同webread编码，然后指定正确的CharacterEncoding选项weboptions．

  • 要指定代理服务器设置，请参见代理服务器认证．

版本历史

在R2014b中引入

另请参阅

||||||||

主题

外部网站