主要内容

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金宝app支持图像格式。有关支持金宝app的图像格式，请参见金宝app支持的文件格式的导入和导出．

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

webread返回音频数据时，HTTP响应有内容类型指定音频媒体类型和if的报头字段audioread金宝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”；dataUrl = strcat (httpsUrl,“/资产/ weatherStation.csv”）;data = webread (dataUrl);时间= (data.Time);temp = [data.TempF];

显示温度图

情节(时间、温度)包含(“时间”) 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 firstName: 'John' lastName: 'Smith'职业:'Software Engineer'年龄:'32'城市:'Boston'
打开生活的脚本

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

读取数据

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扩展时，函数将其内容作为字符向量返回。

“图像”

数字或逻辑矩阵图像/格式内容。如果第一个输出参数是一个索引图像，则第二个输出参数是colormap，第三个输出参数是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。

提示

  • 有关RESTful web服务函数不支持的功金宝app能，请参阅HTTP接口．

  • 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

MATLAB的文档

金宝app

介绍基于MATLAB的深度学习

介绍基于MATLAB的深度学习

下载电子书