主要内容

matlab.net.http.RequestMessage类

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

HTTP请求消息

扩展所有的页面

描述

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

类属性

密封
真正的

类属性的信息,请参阅类属性。

创建

描述

obj = matlab.net.http.RequestMessage用默认值创建一个请求消息。当您发送或完成一个消息时,默认值方法属性是RequestMethod.GET。

例子

obj = matlab.net.http.RequestMessage(方法、头、身体)指定一个或多个可选的消息属性。你可以省略后参数和使用[]指定任何占位符。

obj = matlab.net.http.RequestMessage (requestLine,头,身体)设置RequestLine财产requestLine。如果你需要使用这个语法控制请求的内容。例如,显式地发送消息到一个代理,设置RequestLine.RequestTarget财产完整的URI。否则,MATLAB选择代理根据您的代理设置,和发送方法设置RequestTarget到路径URI的属性。

obj = matlab.net.http.RequestMessage (requestLine头,提供者)消息体数据matlab.net.http.io.ContentProvider。

属性

全部展开

请求行、指定为一个matlab.net.http.RequestLine对象,或一个字符串或一个字符向量包含方法,目标,和协议版本。这条线是自动创建发送消息时,基于您所指定的方法和URI。如果您显式地设置这个属性,那么它的内容被用作请求。可能被设置为值RequestLine对象或解析并转换为一个字符串RequestLine对象。

例子:“得到HTTP / 1.1”

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

请求方法,指定为一个matlab.net.http.RequestMethod枚举或字符串或字符向量代表一个请求方法。设置发送消息RequestMessage.Method财产或RequestLine.Method财产。

例子:“得到”

属性:

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)设置完成财产真正的后:

  • 确定的信息是有效的。

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

如果属性是真的,那么这些方法不修改信息,和发送方法对有效性检查就发送消息。任何改变这个消息之后改变了完成属性回假。

发送任意标题和数据在一个请求消息,集完成来真正的为了防止发送方法从修改消息。你仍然可以使用完整的方法验证消息,但是发送方法发送它是否有效。

如果一个请求消息包含的数据Body.Data属性不是空的),那么完成被设置为真正的只有在Body.Payload包含原始数据。响应消息的有效负载设置只有在你指定HTTPOptions.SavePayload财产。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

数据类型:逻辑

消息开始,作为一个指定matlab.net.http.StartLine对象。

属性:

GetAccess
公共
SetAccess
公共

方法

全部展开

例子

全部折叠

打开生活的脚本

格式一个HTTP消息请求服务器将文本添加到网站。这个例子只格式的消息,不发送数据。

将内容添加到消息体。

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

创建一个内容类型头字段描述身体的数据类型。

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

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

类型1 = matlab.net.http.MediaType (“文本/ *”);类型2 = matlab.net.http.MediaType (“application / json”,“问”,“5”);acceptField = matlab.net.http.field.AcceptField((类型1 type2));

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

头= [acceptField contentTypeField];

指定此消息PUT请求。

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

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

请求= matlab.net.http.RequestMessage(方法、头、身体);(请求)
/ *接受:文本,application / json;q =。5 - type:文本/纯数据发送

版本历史

介绍了R2016b

另请参阅

|||||