主要内容

matlab.net.http.RequestMessage类

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

HTTP请求消息

描述

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

类属性

密封的
真的

有关类属性的信息,请参见类属性.

创造

描述

obj=matlab.net.http.RequestMessage使用默认值创建请求消息。发送或完成消息时,默认设置为方法财产是RequestMethod.GET.

例子

obj=matlab.net.http.RequestMessage(方法、头、体)指定一个或多个可选消息性质. 您可以省略尾随参数并使用[]指定任何占位符。

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

obj=matlab.net.http.RequestMessage(requestLine、header、provider)从中获取消息正文数据matlab.net.http.io.ContentProvider.

性质

全部展开

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

例子:'获取HTTP/1.1'

属性:

获取访问权限
公众的
设置访问
公众的
依赖的
真的

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

例子:“得到”

属性:

获取访问权限
公众的
设置访问
公众的
依赖的
真的

消息头,指定为matlab.net.http.HeaderField对象或向量海德菲尔德物体。当你设定标题属性,MATLAB®检查标头的字段,以确保它们适用于消息类型请求消息发送完成方法为格式正确的请求填充任何必需的头字段。

属性:

获取访问权限
公众的
设置访问
公众的

消息正文,指定为matlab.net.http.MessageBody对象matlab.net.http.io.ContentProvider,或用户可接受的数据消息体构造函数。默认情况下,身体为空(设置为[])。包含身体属性通常使用以下方法:“放”“职位”,而不是默认值“得到”,但这项公约并不强制执行。

在已完成或已接收的消息中,如果消息具有ContentTypeField标题字段,然后是MessageBody.ContentType属性设置为该值。否则,内容类型未更改或为空。

属性:

获取访问权限
公众的
设置访问
公众的

消息是否完整,指定为真的假的A.真的值表示消息已完成。

验证消息的方法(RequestMessage.sendRequestMessage.complete)设定完整的财产真的之后:

  • 正在确定消息是否有效。

  • 完成处理,例如添加所需的标题字段和转换数据。

如果属性为true,则这些方法不会修改消息,并且发送方法发送消息而不检查其有效性。在此之后对此消息的任何更改都会更改完整的财产返还给假的.

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

如果请求消息包含数据,则正文.数据属性不为空),则完整的设置为真的只有车身,有效载荷包含原始数据。在响应消息中,仅当您指定HTTPOptions.SavePayload财产。

属性:

获取访问权限
公众的
设置访问
公众的
转瞬即逝的
真的

数据类型:符合逻辑的

消息起始行,指定为matlab.net.http.asp对象

属性:

获取访问权限
公众的
设置访问
公众的

方法

全部展开

例子

全部崩溃

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

向消息正文添加内容。

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

创建描述正文数据类型的内容类型标题字段。

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

创建一个Accept标头字段,指定响应消息中可接受的数据类型。

type1=matlab.net.http.MediaType('文本/*'); type2=matlab.net.http.MediaType(“应用程序/json”,“q”,'.5'); acceptField=matlab.net.http.field.acceptField([type1-type2]);

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

标题=[acceptField contentTypeField];

指定此消息是PUT请求。

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

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

request=matlab.net.http.RequestMessage(方法、头、体);show(请求)
PUT-Accept:text/*,application/json;q=.5内容类型:要发送的文本/普通数据
R2016b中引入