主要内容

matlab.net.http.RequestMessage类

包:matlab.net.http
超类:matlab.net.http.Message

HTTP请求消息

展开全部页面

描述

使用RequestMessage类格式化HTTP请求消息，以便发送到服务器进行处理。使用发送方法发送消息完整的方法在发送之前验证消息。这些方法填充任何必要的报头字段和其他消息属性。

类属性

密封
真正的

有关类属性的信息，请参见类属性．

创建

描述

obj = matlab.net.http.RequestMessage使用默认值创建请求消息。当您发送或完成邮件时，默认的方法属性是RequestMethod。得到．

例子

obj = matlab.net.http.RequestMessage(方法，头，正文)指定一个或多个可选消息属性．您可以省略后面的参数并使用［］指定任何占位符。

obj = matlab.net.http.RequestMessage(requestLine,header,body)设置RequestLine财产requestLine．如果需要控制请求行的内容，请使用此语法。例如，要显式地向代理发送消息，请设置RequestLine。RequestTarget属性转换为完整的URI。否则，MATLAB将根据代理设置选择代理，并且发送方法设置RequestTarget到路径URI的属性。

obj = matlab.net.http.RequestMessage(requestLine,header,provider)类的消息体数据matlab.net.http.io.ContentProvider．

属性

全部展开

请求行，指定为matlab.net.http.RequestLine对象，或包含方法、目标和协议版本的字符串或字符向量。这一行是在发送消息时根据指定的方法和URI自动创建的。如果显式设置此属性，则将其内容用作请求行。该值可以设置为aRequestLine对象或字符串，该字符串将被解析并转换为RequestLine对象。

例子:“得到HTTP / 1.1”

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

请求方法，指定为matlab.net.http.RequestMethod枚举或表示请求方法的字符串或字符向量。要发送消息，请设置RequestMessage。方法财产或RequestLine。方法财产。

例子:“得到”

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

消息头，指定为matlab.net.http.HeaderField的对象或向量HeaderField对象。当你设置头财产,MATLAB®检查报头的字段，以确保它们适合于消息类型。的RequestMessage发送而且完整的方法为正确格式的请求填充任何必需的报头字段。

属性:

GetAccess
公共
SetAccess
公共

消息正文，指定为matlab.net.http.MessageBody对象,matlab.net.http.io.ContentProvider的可接受的数据MessageBody构造函数。默认情况下,身体为空(设置为［］)．的请求消息身体属性通常使用方法“把”或“职位”，不是默认值“得到”，但这一惯例并不强制执行。

在已完成或已接收的消息中，如果该消息具有ContentTypeField头字段，然后MessageBody。ContentType属性设置为该值。否则,ContentType不变或为空。

属性:

GetAccess
公共
SetAccess
公共

消息是否完整，指定为真正的或假．一个真正的Value表示消息已完成。

验证消息的方法(RequestMessage.send而且RequestMessage.complete)设置完成财产真正的后:

  • 确定消息是有效的。

  • 完成处理，例如添加所需的报头字段和转换数据。

属性为true，则这些方法不修改消息发送方法发送消息时不检查其有效性。在此之后对此消息的任何更改都会更改完成财产返回假．

若要在请求消息中发送任意标头和数据，请设置完成来真正的为了防止发送方法来修改消息。你仍然可以使用完整的方法来验证消息，但是发送方法发送它是否有效。

如果请求消息包含数据的身体。数据属性不是空的)，那么完成设置为真正的只有在的身体。有效载荷包含原始数据。在响应消息中，只有在指定HTTPOptions。SavePayload财产。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

数据类型:逻辑

消息开始行，指定为matlab.net.http.StartLine对象。

属性:

GetAccess
公共
SetAccess
公共

方法

全部展开

例子

全部折叠

打开实时脚本

格式化请求服务器向网站添加文本的HTTP消息。此示例仅格式化消息，而不发送数据。

向消息体中添加内容。

data =“要发送的数据”；body = matlab.net.http.MessageBody(data);body.show
要发送的数据

创建一个Content-Type报头字段，用于描述正文的数据类型。

contentTypeField = matlab.net.http.field“文本/普通”）;

创建Accept报头字段，指定响应消息中可接受的数据类型。

type1 = matlab.net.http.MediaType(“文本/ *”）;type2 = matlab.net.http.MediaType(“application / json”，“问”，“5”）;acceptField = matlab.net.http.field.AcceptField([type1 type2]);

创建一个包含两个报头字段的请求报头。

header = [acceptField contentTypeField];

指定此消息是PUT请求。

方法= matlab.net.http.RequestMethod.PUT;

创建请求消息并显示其内容。

请求= matlab.net.http.RequestMessage(方法，头，正文);(请求)
PUT Accept: text/*， application/json;q = 5Content-Type: text/plain发送的数据

版本历史

在R2016b中引入

另请参阅

|||||