主要内容

webread

从RESTful web服务读取内容

描述

实例

数据= webread (网址)从指定的Web服务中读取内容网址并返回内容数据

web服务提供了一个宁静的返回格式化为internet媒体类型(如JSON、XML、图像或文本)的数据。

实例

数据= webread (网址,QueryName1, QueryValue1,…,QueryNameN QueryValueN)将查询参数附加到网址,由一对或多对名称值参数指定。若要将查询放入消息体,请使用webwrite..Web服务定义查询参数。

实例

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

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

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

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

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

[数据,colormap,阿尔法) = webread (___)从指定的web服务读取图像网址并返回图像数据.您可以使用以前的语法仅返回映像。使用此语法返回与图像关联的ColorMap和Alpha通道。

webread当HTTP响应具有内容类型指定图像媒体类型和if的报头字段imread万博1manbetx支持图像格式。有关支持的图像格式,请参阅万博1manbetx支持的文件格式的导入和导出

[数据,财政司司长) = webread (___)从指定的web服务读取音频数据网址并返回中的音频数据数据。您可以使用前面的语法仅返回音频数据。使用此语法以赫兹为单位返回音频数据的采样率。

webread返回音频数据时,HTTP响应有内容类型指定音频媒体类型和if的报头字段音频读物万博1manbetx支持音频格式。有关支持的音频格式,请参阅万博1manbetx支持的文件格式的导入和导出

例子

全部崩溃

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

读取图像数据

httpsUrl ='https://requestserver.mathworks.com';imageUrl=strcat(httpsUrl,'/ssets/computervision.jpg');rgb = webread (imageUrl);谁rgb
名称大小字节类属性rgb 360x640x3 691200 uint8

调整大小并显示图像

RGB = IMResize(RGB,0.6);imshow(RGB)

这个例子展示了如何从csv数据文件。

从CSV文件读取数据

httpsUrl =“https://requestserver.mathworks.com”; 数据URL=strcat(httpsUrl,“/资产/ weatherStation.csv”);数据= 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,“名字”,“约翰。”,“姓氏”,“史密斯”);disp (jSmith);
ID:1名FirstName:'John'Lastname:'Smith'职业:'软件工程师'年龄:'32'城市:'波士顿'

此示例显示如何将数据作为特定类型返回。

读取数据

httpUrl=“http://requestserver.mathworks.com”;employeeUrl = strcat (httpUrl,“/雇员”);

返回记录为字符数组

创建一个weboptions对象并设置其ContentType“文本”.这webread函数将JSON对象转换为字符数组。

选择= weboptions (“内容类型”,“文本”);sbrown = webrabread(employeeull,“名字”,“莎拉”、选择);disp (sBrown)
[{“ID”:2,“FirstName”:“Sarah”,“姓氏”:“棕色”,“职业”:“软件工程师”,“年龄”:“28”,“城市”:“纽约”}]

输入参数

全部崩溃

指向web服务的URL,指定为字符向量或字符串标量。包括传输协议。仅限httphttps都受支持万博1manbetx。web服务实现了一个RESTful接口。看见宁静的为更多的信息。

例子:WebRead('https://www.mathwands.com/matlabcentral')读取网页并以字符数组的形式返回其HTML。

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

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

什么时候QueryValue如果数组中包含多个值,则可能需要指定ArrayFormat.财产weboptions对象对由web服务指定的数组进行形式编码。

例子:网络阅读('//www.tianjin-qmedu.com/matlabcentral/fileexchange/“,”术语“,”网络阅读“)检索上传到包含单词的文件交换的文件列表webread

其他HTTP请求选项,指定为weboptions对象。

您可以指定ContentType财产weboptions对象,并将该对象作为输入参数传递给webread.然后webread返回数据作为该类型的输出。该表列出了可以在weboptions对象。

ContentType说明书

输出类型

“自动”(默认)

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

“文本”

内容类型的字符向量:

文本/平原
文本/html
文本/xml
应用程序/ xml
应用程序/ javascript
application/x-javascript
Application / X-WWW-Form-Urlencoded

如果web服务返回®存档.m扩展名,该函数将其内容返回为字符向量。

“图像”

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

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

“音频”

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

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

“二元”

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

'桌子'

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

“json”

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

“xmldom”

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

'生的'

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

看见weboptions为所有请求选项weboptions属性。

输出参数

全部崩溃

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

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

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

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

更多关于

全部崩溃

宁静的

休息方法代表国转,一种常见的web服务体系结构样式。RESTful接口提供标准HTTP方法,如GET、PUT、POST或DELETE。

提示

  • 有关RESTful web服务函数不支持的功万博1manbetx能,请参阅HTTP接口

  • webread万博1manbetx支持HTTP GET和POST方法。许多web服务都提供GET和POST方法来请求数据。若要发送HTTP POST请求,请指定请求方法性质选项“职位”.然而,webread将查询选项放入其中网址,不在请求消息正文中。若要将查询放入正文中,请使用webwrite.

  • 对于HTTP POST请求webread函数仅支持万博1manbetxApplication / X-WWW-Form-Urlencoded媒体类型。要发送包含任何其他互联网媒体类型内容的POST请求,请使用webwrite.

  • 此函数不检查文档内容以确定如何处理它指定文档字符编码的标记。如果编码与默认不同webread编码,然后指定正确的CharacterEncoding选择权weboptions

  • 要指定代理服务器设置,请参见代理服务器身份验证

介绍了R2014b