webread
从 RESTful Web 服务读取内容
语法
说明
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 将返回音频数据。有关受支持的音频格式，请参阅支持的导入和导出的文件格式。
示例
从网站读取图像数据。
httpsUrl = "https://requestserver.mathworks.com"; imageUrl = strcat(httpsUrl, "/assets/computerVision.jpg"); rgb = webread(imageUrl); whos rgb
Name Size Bytes Class Attributes rgb 360x640x3 691200 uint8
调整大小并显示图像。
rgb = imresize(rgb, 0.6); imshow(rgb)
从 CSV 数据文件中读取温度。
httpsUrl = "https://requestserver.mathworks.com"; dataUrl = strcat(httpsUrl,"/assets/weatherStation.csv"); data = webread(dataUrl); time = [data.Time]; temp = [data.TempF];
绘制温度数据图。
plot(time,temp) xlabel("Time") ylabel("Temperature (Fahrenheit)") title("Temperature Over Time"); axis padded
您可以使用查询参数选择数据库记录。
首先，通过显示字段来查看一个雇员数据库的结构体。
httpsUrl = "https://requestserver.mathworks.com"; employeeUrl = strcat(httpsUrl,"/employee"); fieldnames(webread(employeeUrl))
ans = 6×1 cell
{'id' }
{'firstName' }
{'lastName' }
{'occupation'}
{'age' }
{'city' }
然后，使用 firstName 和 lastName 查询参数选择一个雇员的记录。
jSmith = webread(employeeUrl,"firstName","John","lastName","Smith")
jSmith = struct with fields:
id: 1
firstName: 'John'
lastName: 'Smith'
occupation: 'Software Engineer'
age: '32'
city: 'Boston'
您可以以特定类型形式返回数据。
创建一个 weboptions 对象并将其 ContentType 设置为 "text"。使用指定的选项，webread 函数将 JSON 数据转换为字符数组。
httpUrl = "http://requestserver.mathworks.com"; employeeUrl = strcat(httpUrl,"/employee"); options = weboptions("ContentType","text"); sBrown = webread(employeeUrl,"firstName","Sarah",options)
sBrown =
'[{"id":2,"firstName":"Sarah","lastName":"Brown","occupation":"Software Engineer","age":"28","city":"New York"}]'
输入参数
输出参量
详细信息
提示
有关 RESTful Web 服务函数不支持的功能，请参阅使用 HTTP 从 MATLAB 调用 Web 服务。
Web 服务 API 仅支持 HTTP 1.1。
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。此函数不会检查 Web 文档内容来确定如何处理它。例如，HTML 和 XML 文档通常包含一个
<meta>标记，指定文档的字符编码。如果该编码与默认的webread编码不同，请在weboptions中指定预期的CharacterEncoding选项。有关如何指定代理服务器设置的信息，请参阅Proxy Server Authentication。
