主要内容

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到路径属性。

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
公共

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

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

  • 确定消息是否有效。

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

如果该属性为true，则这些方法不会修改消息，并且发送方法发送消息而不检查其有效性。在此之后对该消息的任何更改都会更改完成属性返回到假。

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

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

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

数据类型:逻辑

消息起始行，指定为amatlab.net.http.StartLine对象。

属性:

GetAccess
公共
SetAccess
公共

方法

全部展开

例子

全部折叠

打开实时脚本

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

向消息主体添加内容。

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

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

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

创建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请求。

method = matlab.net.http.RequestMethod.PUT;

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

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

版本历史

在R2016b中引入

另请参阅

|||||