主要内容

webread

从RESTful web服务读取内容

在页面中全部折叠

语法

data = webread (url)
data = webread (url、QueryName1 QueryValue1…,QueryNameN QueryValueN)
数据= webread (＿＿＿选项)
(数据、colormapα)= webread (＿＿＿）
(数据、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响应有内容类型指定图像媒体类型和if的报头字段imread支持图像格式。有关支持的图像格式，请参见支持导入和导出的文件格式．

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

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

例子

全部折叠

打开生活的脚本

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

读取图像数据

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”；dataUrl = strcat (httpsUrl,“/资产/ weatherStation.csv”）;data = webread (dataUrl);时间= (data.Time);temp = [data.TempF];

显示温度图

情节(时间、温度)包含(“时间”) ylabel (“温度(华氏)”)标题(“随着时间的推移,温度”）;轴垫

打开生活的脚本

这个例子展示了如何使用查询参数选择一条记录。

查看员工数据库结构

显示database字段员工．

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都受支持。web服务实现了一个RESTful接口。看到宁静的为更多的信息。

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

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

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

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

例子:webread(“//www.ru-cchi.com/matlabcentral/fileexchange/”,“词”,“webread”)检索上传到File Exchange的包含单词的文件列表webread．

额外的HTTP请求选项，指定为weboptions对象。

您可以指定ContentType财产的weboptions对象，并将该对象作为输入参数传递给webread．然后webread返回数据作为那种类型的输出。表中列出了可以在中指定的有效内容类型weboptions对象。

ContentType说明符

输出类型

“汽车”(默认)

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

“文本”

内容类型的字符向量:

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

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

“图像”

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

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

“音频”

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

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

“二元”

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

“表”

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

json的

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

“xmldom”

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

“生”

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

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

输出参数

全部折叠

从web服务中读取的内容，作为标量、数组、结构或表返回。

与索引图像相关联的Colormap，作为数字数组返回。

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

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

更多关于

全部折叠

宁静的

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

提示

  • 有关RESTful web服务函数不支持的功能，请参见在MATLAB中使用HTTP．

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

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

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

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

版本历史

介绍了R2014b

另请参阅

||||||||

主题

外部网站

Baidu
map