Main Content

matlab.net.http.Message 类

包: matlab.net.http

HTTP 请求或响应消息

说明

Message 类是一个抽象类,用作创建 HTTP 消息的基类。

属性

全部展开

消息的第一行,指定为 matlab.net.http.StartLine 对象(如果有)。

属性:

GetAccess
public
SetAccess
public

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

属性:

GetAccess
public
SetAccess
public

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

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

属性:

GetAccess
public
SetAccess
public

消息是否完成,指定为 truefalsetrue 值表示消息已完成。

在以下情况下,负责验证消息的 RequestMessage 方法(sendcomplete)将 Completed 属性设置为 true

  • 消息有效。

  • 处理完毕。例如,已添加必需的标头字段并转换数据。

如果此属性为 true,则这些方法不会修改消息,send 方法将发送消息而不检查其有效性。对此消息进行任何后续更改都会将 Completed 的值更改回 false

在以下情况下,负责返回消息的方法将 Completed 设置为 true

  • BodyBody.Data 属性为空。

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

如果请求消息包含数据(Body.Data 非空),则仅当 Body.Payload 包含原始数据时,此属性才为 true。

在响应消息中,仅当您将 HTTPOptions.SavePayload 属性设置为 true 时,才会设置有效负载。

属性:

GetAccess
public
SetAccess
public
Transient
true

数据类型: logical

方法

全部展开

提示

  • 要在请求消息中发送任意标头和数据,请将 Completed 属性设置为 true,以防止 send 方法修改消息。您仍然可以使用 complete 方法来验证消息,但 send 方法不会验证消息。

版本历史记录

在 R2016b 中推出