本页翻译不是最新的。点击此处可查看最新英文版本。

matlab.net.http.ResponseMessage 类

命名空间: matlab.net.http
超类: matlab.net.http.Message

HTTP 响应消息

描述

ResponseMessage 类可以对服务器返回的 HTTP 响应消息进行格式化。

类属性

Sealed

true

有关类属性的信息，请参阅类属性。

创建对象

RequestMessage.send 方法可以创建响应消息。

属性

StatusLine — 来自服务器的状态行

StatusLine 对象

来自服务器的状态行，指定为 matlab.net.http.StatusLine 对象。

属性：

GetAccess	public
SetAccess	public
Dependent	true

StatusCode — HTTP 状态代码

StatusCode 对象

HTTP 状态代码，指定为 matlab.net.http.StatusCode 对象。与 StatusLine.StatusCode 属性相同。

属性：

GetAccess	public
SetAccess	immutable
Dependent	true

Header — 消息标头

[] (默认) | matlab.net.http.HeaderField 对象

消息标头，指定为 matlab.net.http.HeaderField 对象或 HeaderField 对象的向量。当您设置 Header 属性时，MATLAB^® 会检查标头的各个字段，以确保它们适用于该消息类型。RequestMessage send 和 complete 方法将填写任何必需的标头字段，以生成格式正确的请求。

属性：

GetAccess	public
SetAccess	public

Body — 消息主体

[] (默认) | matlab.net.http.MessageBody 对象 | matlab.net.http.io.ContentProvider

消息主体，指定为 matlab.net.http.MessageBody 对象、matlab.net.http.io.ContentProvider 或指定为 MessageBody 构造函数可接受的数据。默认情况下，Body 为空（设置为 []）。包含 Body 属性的请求消息通常使用 'PUT' 或 'POST' 等方法，而不是使用默认值 'GET'，但此转换并不是强制的。

在已完成或已收到的消息中，如果消息有一个 ContentTypeField 标头字段，则将 MessageBody.ContentType 属性设置为该值。否则，ContentType 不变或为空。

属性：

GetAccess	public
SetAccess	public

Completed — 消息是否完成

false (默认) | true

消息是否完成，指定为 true 或 false。true 值表示消息已完成。在以下情况下，负责返回消息的方法将 Completed 属性设置为 true：

• Body 或 Body.Data 属性为空。

• Body.Payload 属性包含原始数据。

属性：

GetAccess	public
SetAccess	public
Transient	true

数据类型: logical

方法

公共方法

complete	基于 Content-Type 处理或重新处理响应有效负载
addFields	在消息标头中添加字段
changeFields	更改消息标头中的现有字段
getFields	返回与名称或类匹配的消息标头字段
removeFields	删除消息标头中的字段
replaceFields	在消息标头中更改值或添加字段
show	显示或返回消息的格式化版本

专用运算符和函数

这些方法将标准的 MATLAB 运算符和函数应用于此类中的对象。

string	消息的 Header、Body 和 StartLine 属性，以字符串形式返回。对于多条消息，返回一个字符串数组。 如果 Body 包含不能转换为字符的二进制数据，此方法将显示指示数据长度（以字节为单位）的消息。 字符串近似表示了消息在发送或接收时的形式。 用于日志记录、诊断或调试。 要获取格式化版本的消息，请使用 show。
char	与 string 基本相同，只是以字符向量形式返回消息。
isequal	如果两个消息数组中所有消息的可见公共属性相等，则返回 true。

示例

向网站请求图像

向 Hubble Heritage 网站发送请求木星图像的消息。

创建 HTTP 请求消息，并显示响应消息主体的 Content-Type。服务器返回一个 JPEG 图像。

request = matlab.net.http.RequestMessage;
uri = matlab.net.URI('http://heritage.stsci.edu/2007/14/images/p0714aa.jpg');
r = send(request,uri);
r.Body.ContentType

ans = 

  MediaType with properties:

          Type: "image"
       Subtype: "jpeg"
    Parameters: []
     MediaInfo: "image/jpeg"
        Weight: []

使用 imshow 函数显示该图像。MATLAB 将调整图像大小以适合屏幕尺寸。

warning('off','Images:initSize:adjustingMag');
imshow(r.Body.Data)

版本历史记录

在 R2016b 中推出

另请参阅

RequestMessage | send | StatusLine | StatusCode | MessageBody