主要内容

webread

阅读内容从RESTful web服务

描述

例子

数据= 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并返回的形象数据。您可以使用前面的语法只返回图像。使用这个语法返回colormap和alpha通道相关的图像。

webread当HTTP响应返回一个图像内容类型头字段指定一个图像,如果媒体类型imread万博1manbetx支持图像格式。支持图像万博1manbetx格式,请参阅万博1manbetx支持文件格式导入和导出

(数据,Fs)= webread (___)从指定的web服务读取音频数据url并返回的音频数据数据。您可以使用前面的语法只返回音频数据。使用这个语法返回赫兹的音频数据的采样率。

webread返回音频数据在HTTP响应内容类型头字段指定一个音频媒体类型,如果audioread万博1manbetx支持的音频格式。支持的音万博1manbetx频格式,请参阅万博1manbetx支持文件格式导入和导出

例子

全部折叠

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

读取图像数据

httpsUrl =“https://requestserver.mathworks.com”;imageUrl = strcat (httpsUrl,“/资产/ computerVision.jpg”);rgb = webread (imageUrl);谁rgb
类属性名称大小字节rgb 360 x640x3 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:“约翰”姓:“史密斯”职业:“软件工程师”年龄:“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,指定为一个特征向量或字符串标量。包括传输协议。只有httphttps都受支持万博1manbetx。web服务实现RESTful接口。看到宁静的为更多的信息。

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

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

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

QueryValue数组中包含多个值,您可能需要指定ArrayFormat财产的weboptions对象form-encode指定的数组作为web服务。

例子:webread (“//www.tianjin-qmedu.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通道输出。

支持图像万博1manbetx格式,请参阅万博1manbetx支持文件格式导入和导出

“音频”

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

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

“二元”

uint8列向量为二进制内容(内容不被视为类型字符)。

“表”

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

json的

字符、数字、逻辑结构,或单元阵列application / json内容。

“xmldom”

Java®文档对象模型(DOM)节点text / xml应用程序/ xml内容。如果未指定,则函数返回XML内容作为特征向量。

“生”

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

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

输出参数

全部折叠

内容读取web服务,作为一个标量,返回数组,结构,或表。

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

阿尔法通道与索引相关的图像,作为数字数组返回。

在赫兹采样率的音频数据,作为一个积极的数字标量返回。

更多关于

全部折叠

宁静的

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

提示

  • 功能不支持的基于rest的web服务功能,看万博1manbetx到使用HTTP与MATLAB

  • webread万博1manbetx支持HTTP GET和POST方法。许多web服务提供GET和POST请求数据的方法。发送一个HTTP POST请求,指定RequestMethod的属性选项作为“职位”。然而,webread将查询选项放入url,而不是在请求消息的主体。将查询到的身体,使用webwrite

  • 对于HTTP POST请求webread功能只支持万博1manbetx应用程序/ x-www-form-urlencoded媒体类型。发送一个POST请求内容的任何其他网络媒体类型,使用webwrite

  • 这个函数不检查文档内容来决定如何处理它。例如,HTML和XML文档通常包含一个< meta >标签指定文档的字符编码。如果编码是不同于默认webread编码,然后指定正确的CharacterEncoding选项weboptions

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

版本历史

介绍了R2014b