大家好，欢迎来到IT知识分享网。
注：以下内容部分来自于mathworks
webread
从 RESTful Web 服务读取内容
1.RESTful
REST 表示表述性状态转移 (representational state transfer)，Web 服务的一种常用体系结构样式。RESTful 接口提供标准的 HTTP 方法，例如 GET、PUT、POST 或 DELETE。
随着 REST 成为大多数 Web 和 Mobile 应用的默认选择，势必要对它的基本原理有所了解。
在它提出十多年后的今天，REST 已经成为最重要的 Web 应用技术之一。随着所有技术朝着 API 方向发展，它的重要性有可能持续快速地增长。每门主要编程语言现在已经包含构建 RESTful Web 服务的框架。同样地，Web 开发者和架构师对 REST 和 RESTful 服务有一个清晰的理解是很重要的。这篇教程解释了 REST 架构，然后研究使用它构建通用地基于API的任务的细节。
1.1 什么是 REST
REST 代表表述性状态转移（representational state transfer），它是一种网络化超媒体应用的架构风格。它主要是用于构建轻量级的、可维护的、可伸缩的 Web 服务。基于 REST 的服务被称为 RESTful 服务。REST 不依赖于任何协议，但是几乎每个 RESTful 服务使用 HTTP 作为底层协议。
RESTful 使用HTTP post（创建、更新）数据、读取数据、删除数据。使用HTTP实现CRUD（创建、读取、更新、删除）操作。
1.2 RESTful 服务特点：
每个系统都使用资源。这些资源可以是图片，视频文件，网页，商业信息，或者在基于计算机的系统中可以被代表的任何事物。服务的目的是提供一个窗口给客户端以便客户端能访问这些资源。服务架构师和开发人员想要这些服务变得易于实现、维护、扩展、伸缩。RESTful 架构允许这些，甚至更多。一般来说，RESTful 服务应该有下面的属性和特征，也就是我要详细描述的内容：
- 模型表示（Representations）
- 消息（Messages）
- URIs
- 一致接口（Uniform interface）
- （无状态）Stateless
- 资源之间的链接（Links between resources）
- 缓存（Caching）
2.语法
data = webread(url)
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)
data = webread(___,options)
[data,colormap,alpha] = webread(___)
[data,Fs] = webread(___)
3.说明
示例
data = webread(url) 从 url 指定的 Web 服务读取内容并在 data 中返回内容。
Web 服务提供了一个RESTful，后者可以返回具有 Internet 媒体类型格式（例如 JSON、XML、图像或文本）的数据。
示例
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN) 按照一个或多个名称-值对组参数指定的方式将查询参数追加到 url。要将查询放入消息主体，请使用 webwrite。Web 服务定义查询参数。
示例
data = webread(___,options) 添加由 weboptions 对象 options 指定的其他 HTTP 请求选项。您可以将此语法与前面语法中的任何输入参数结合使用。
要将数据返回为特定输出类型，请指定 options 的 ContentType 属性。
要使用函数读取内容，请将 options 的 ContentReader 属性指定为该函数的句柄。webread 从 Web 服务下载数据并使用指定的函数读取这些数据：
-
如果指定了一个返回多个输出参数的函数句柄，则
webread将返回所有输出参数。 -
如果指定了一个不返回任何输出参数的函数句柄（例如视频文件的 Image Processing Toolbox™ 函数
@implay），则webread将不返回任何输出参数。
[data,colormap,alpha] = webread(___) 从 url 指定的 Web 服务中读取图像，并在 data 中返回该图像。您可以使用上述语法仅返回图像。使用此语法可返回与该图像关联的颜色图和 alpha 通道。
如果 HTTP 响应具有用于指定图像媒体类型的 Content-Type 头字段且 imread 支持该图像格式，则 webread 将返回一个图像。有关受支持的图像格式，请参阅支持的导入和导出文件格式。
[data,Fs] = webread(___) 从 url 指定的 Web 服务中读取音频数据，并在 data 中返回这些数据。您可以使用上述语法仅返回音频数据。使用此语法可返回音频数据的采样率（以赫兹为单位）。
如果 HTTP 响应具有用于指定音频媒体类型的 Content-Type 头字段且 audioread 支持该音频格式，则 webread 将返回音频数据。有关受支持的音频格式，请参阅支持的导入和导出文件格式。
4.示例
4.1从网站读取图像
从 Hubble Heritage 网站读取木星图像并显示该图像。
url = 'http://heritage.stsci.edu/2007/14/images/p0714aa.jpg'; rgb = webread(url); whos rgb
Name Size Bytes Class Attributes rgb 1000x800x3 2400000 uint8
调整并显示图像。
rgb = imresize(rgb,0.6); imshow(rgb)
木星图像来源：NASA、ESA 和 Hubble Heritage Team (STScI/AURA)。（有关使用条款，请参阅 Hubble Heritage Information Center。）
4.2从 Web 服务 API 读取数据
从世界银行气候数据 API 读取美国的温度数据。绘制 1901–2012 年的温度图。
从世界银行读取数据。此 API 返回 JSON 对象形式的数据。
api = 'http://climatedataapi.worldbank.org/climateweb/rest/v1/'; url = [api 'country/cru/tas/year/USA']; S = webread(url)
S =
112x1 struct array with fields:
year
data
webread 将 JSON 对象转换为结构体数组。每个结构体都包含年份和美国该年的平均温度（以摄氏度为单位）。
显示第一年的温度。
S(1)
ans =
year: 1901
data: 6.6187
绘制平均温度图。将 S.year 和 S.data 串联成数组并绘制这些数组。
year = [S.year];
data = [S.data];
plot(year,data)
xlabel('Year');
ylabel('Temperature (Celsius)');
title('USA Average Temperatures')
axis tight
世界银行提供的 API 和数据：气候数据 API。（请参阅世界银行：气候数据 API 以了解有关 API 的更多信息；请参阅世界银行：使用条款。）
4.3指定 Web 服务查询参数
在 File Exchange 中搜索在过去七天中上传的包含单词 Simulink® 的文件。
指定查询参数。webread 将 Web 服务查询参数名称和值追加到 URL。File Exchange Web 服务定义 term 和 duration 查询参数，而非 webread 函数。
url = 'http://www.mathworks.com/matlabcentral/fileexchange/'; data = webread(url,'term','simulink','duration',7);
webread 以字符数组形式返回搜索结果页的 HTML。
4.4指定请求选项
指定一个附加请求选项以通过世界银行气候数据 API 将数据读取到字符数组。
创建一个 weboptions 对象并将其 ContentType 设置为 'text'。webread 函数将 JSON 对象转换为字符数组而不是结构体数组。显示字符数组的开头。
api = 'http://climatedataapi.worldbank.org/climateweb/rest/v1/';
url = [api 'country/cru/tas/year/USA'];
options = weboptions('ContentType','text');
data = webread(url,options);
data(1:62)
ans =
[{"year":1901,"data":6.6187487},{"year":1902,"data":6.4643273}
世界银行提供的 API 和数据：气候数据 API。（请参阅世界银行：气候数据 API 以了解有关 API 的更多信息；请参阅世界银行：使用条款。）
4.5使用 POST 请求读取数据
发送 HTTP POST 请求以在 File Exchange 中搜索在过去七天中上传的包含单词 Simulink 的文件。
url = 'http://www.mathworks.com/matlabcentral/fileexchange/';
options = weboptions('RequestMethod','post');
data = webread(url,'term','simulink','duration',7,options);
许多 Web 服务除了提供 GET 方法外还提供 POST 方法用于请求数据。
4.6将日期和时间指定为查询参数
从 NASA Earth Observation (NEO) Web Mapping Service 读取 2004 年 12 月的一幅“Blue Marble:Next Generation”图像。
使用 datetime 对象指定所请求的图像的日期。指定 D 的 Format 属性，使其格式与 Web 服务请求的格式相匹配。
url = 'http://neowms.sci.gsfc.nasa.gov/wms/wms';
D = datetime(2004,12,01,'Format','yyyy-MM-dd');
rgb = webread(url,'Time',D, ...
'Service','WMS','Layers','BlueMarbleNG-TB','CRS','CRS:84', ...
'Format','image/jpeg','Height',256,'Width',512, ...
'BBOX','-180.0,-90.0,180.0,90.0','Version','1.3.0','Request','GetMap');
imshow(rgb)
webread 转换 datetime 对象，以便它们可以作为 Web 服务查询参数的值。示例中的所有名称-值对组提供了由 NEO Web Mapping Service 指定的查询参数。
Blue Marble:Next Generation + Topography and Bathymetry 图像由 NASA 的 Earth Observatory 提供。NEO Web Mapping Service (WMS) 提供对图像和服务的访问权限。（请参阅 NASA Earth Observations 了解致谢名单和使用条款。有关 WMS 查询参数，请搜索 NASA Earth Observations 网站 https://neo.sci.gsfc.nasa.gov/about/wms.php。）
5.输入参数
6.输出参数
7.提示
-
有关 RESTful Web 服务函数不支持的功能，请参阅 HTTP 接口。
-
webread支持 HTTP GET 和 POST 方法。许多 Web 服务同时提供 GET 和 POST 方法用于请求数据。要发送 HTTP POST 请求，请将options的RequestMethod属性指定为'post'。但是，webread将查询选项放入 url，而不是放入请求消息的主体。要将查询放入消息主体，请使用webwrite。 -
对于 HTTP POST 请求，
webread函数仅支持application/x-www-form-urlencoded媒体类型。要将 POST 请求与任何其他 Internet 媒体类型的内容一起发送，请使用webwrite。
免责声明：本站所有文章内容,图片，视频等均是来源于用户投稿和互联网及文摘转载整编而成，不代表本站观点，不承担相关法律责任。其著作权各归其原作者或其出版社所有。如发现本站有涉嫌抄袭侵权/违法违规的内容,侵犯到您的权益，请在线联系站长,一经查实,本站将立刻删除。 本文来自网络,若有侵权，请联系删除，如若转载，请注明出处：https://yundeesoft.com/34716.html
