主要内容

网络阅读

从RESTful web服务读取内容

描述

例子

数据=网络阅读(url从指定的web服务读取内容url并返回中的内容数据

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

例子

数据=网络阅读(urlQueryName1,QueryValue 1,…,QueryNameN,QueryValue添加查询参数url,由一对或多对名称-值参数指定。要将查询放入消息体,请使用网络写作. web服务定义查询参数。

例子

数据=网络阅读(___选择权添加由指定的其他HTTP请求选项网络选项对象选择权。您可以将此语法与前面语法的任何输入参数一起使用。

要将数据作为特定输出类型返回,请指定内容类型的属性选择权

要使用函数读取内容,请指定内容阅读器的属性选择权作为函数的句柄。网络阅读从web服务下载数据并使用指定功能读取数据:

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

  • 如果为不返回输出参数的函数指定句柄(如图像处理工具箱)™ 作用@implay对于视频文件),网络阅读不返回输出参数。

数据颜色表α]=网络阅读(___从指定的web服务读取图像url并以数据。您可以使用前面的语法仅返回图像。使用此语法可返回与图像关联的颜色贴图和alpha通道。

网络阅读当HTTP响应具有内容类型标题字段,指定图像媒体类型和伊姆雷德万博1manbetx支持图像格式。有关支持万博1manbetx的图像格式,请参见万博1manbetx支持导入和导出的文件格式

数据Fs]=网络阅读(___从指定的web服务读取音频数据url并返回音频数据数据.您可以使用前面的语法只返回音频数据。使用此语法返回以赫兹为单位的音频数据的采样率。

网络阅读当HTTP响应有错误时返回音频数据内容类型标题字段,用于指定音频媒体类型和audioread万博1manbetx支持音频格式。有关支持万博1manbetx的音频格式,请参见万博1manbetx支持导入和导出的文件格式

例子

全部折叠

此示例演示如何从网站读取图像并显示它。

读取图像数据

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

调整大小和显示图像

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

此示例显示了如何从数据库中读取温度csv数据文件。

从CSV文件读取数据

httpsUrl="https://requestserver.mathworks.com";dataUrl = strcat (httpsUrl,“/assets/weatherStation.csv”);data=webread(dataUrl);time=[data.time];temp=[data.TempF];

显示温度图

绘图(时间、温度)xlabel(“时间”)伊拉贝尔(“温度(法伦海特)”)头衔(“随着时间的推移,温度”);轴线填充

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

查看员工数据库结构

显示数据库的字段受雇者

httpsUrl="https://requestserver.mathworks.com";employeeUrl=strcat(httpsUrl,“/员工”);字段名(webread(employeeUrl))
ans =6×1电池{'id'}{'firstName'}{'lastName'}{'occupation'}{'age'}{'city'}

按选择员工名字姓氏

jSmith = webread (employeeUrl,“firstName”“约翰”“姓”“史密斯”);disp(jSmith);
id:1姓:约翰姓:史密斯职业:软件工程师年龄:32城市:波士顿

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

读取数据

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

以字符数组形式返回记录

创建一个网络选项对象,并设置其内容类型“文本”这个网络阅读函数将JSON对象转换为字符数组。

选项=网络选项(“ContentType”“文本”); sBrown=webread(employeeUrl,“firstName”“莎拉”,选项);显示(sBrown)
[{“id”:2,“名字”:“莎拉”,“姓氏”:“布朗”,“职业”:“软件工程师”,“年龄”:“28”,“城市”:“纽约”}]

输入参数

全部折叠

web服务的URL,指定为字符向量或字符串标量。包括传输协议。只有httphttps支持。w万博1manbetxeb服务实现RESTful接口。请参阅宁静的了解更多信息。

例子:网络阅读('//www.tianjin-qmedu.com/matlabcentral')读取网页并将其HTML作为字符数组返回。

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

当您指定查询值作为一个日期时间对象,则必须指定其总体安排属性,使其与web服务所需的格式一致总体安排属性包括时区或偏移量,以及日期时间对象未分区网络阅读指定“本地”作为时区。

什么时候查询值数组中包含多个值,可能需要指定阵列格式财产的网络选项对象来对web服务指定的数组进行编码。

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

附加的HTTP请求选项,指定为网络选项对象

您可以指定内容类型财产的网络选项对象,并将该对象作为输入参数传递给网络阅读然后网络阅读返回数据作为那种输出。属性中可以指定的有效内容类型网络选项对象

内容类型说明符

输出类型

“汽车”(默认)

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

“文本”

内容类型的字符向量:

文本/纯文本
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的

烧焦、数字、逻辑、结构或单元格数组,用于应用程序/json内容。

“xmldom”

JAVA®的文档对象模型(DOM)节点text / xml应用程序/xml所容纳之物如果未指定,则函数将XML内容作为字符向量返回。

“生的”

烧焦列向量“文本”“xmldom”json的所容纳之物该函数返回任何其他内容类型作为uint8列向量。

看到网络选项对于所有的请求选项网络选项财产。

输出参数

全部折叠

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

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

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

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

更多关于

全部折叠

宁静的

休息方法表述性状态转移,一种web服务的通用架构风格。RESTful接口提供标准的HTTP方法,如GET、PUT、POST或DELETE。

提示

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

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

  • 对于HTTP POST请求,网络阅读函数仅支持万博1manbetx应用程序/x-www-form-urlencoded媒体类型。若要发送带有任何其他互联网媒体类型内容的POST请求,请使用网络写作

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

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

R2014b中引入