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