注:以下内容部分来自于mathworks
webread
从 RESTful Web 服务读取内容
语法
data = webread(url)
data = webread(url,QueryName1,QueryValue1,...,QueryNameN,QueryValueN)
data = webread(___,options)
[data,colormap,alpha] = webread(___)
[data,Fs] = webread(___)
说明
按照一个或多个名称-值对组参数指定的方式将查询参数追加到 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
将返回音频数据。有关受支持的音频格式,请参阅支持的导入和导出文件格式。
示例
输入参数
输出参数
详细信息
提示
-
有关 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
。