主要内容

matlab.net.http.MessageBody类

包:matlab.net.http

的HTTP消息体

描述

一个MessageBody对象包含HTTP消息的身体。在一个请求消息,设置身体财产或你的数据MessageBody包含您的数据对象。在一个响应消息,这个对象包含接收到的数据。

消息数据由两个属性来表示。的有效载荷属性包含原始字节发送或接收来自网络。的数据属性包含了有效载荷作为一个MATLAB®类型。通常只有一个设置这两个属性。

类属性

密封
真正的

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

创建

一个MessageBody对象包含HTTP消息的身体。在一个请求消息,设置身体财产或你的数据MessageBody包含您的数据对象。在一个响应消息,这个对象包含接收到的数据。

消息数据由两个属性来表示。的有效载荷属性包含原始字节发送或接收来自网络。的数据属性包含了有效载荷作为一个MATLAB类型。通常只有一个设置这两个属性。

属性

全部展开

消息数据,指定为下列MATLAB数据类型之一。转换的细节,请参阅HTTP数据类型转换

  • uint8向量,数据不转换。

  • 字符数组或标量字符串-数据根据媒体类型和字符集转换属性在content - type头。

  • 结构数组,数据转换为或从JSON字符串使用webreadwebwrite

  • 图像- - - - - -数据转换为使用或从一个图像imreadimwrite

  • XML DOM -数据转换为或从一个字符串使用xmlreadxmlwrite

  • 音频数据,数据转换使用audioreadaudiowrite

  • 表- - -数据转换使用xmlreadxmlwrite

  • 其他类型的数组或单元阵列数据转换为或从JSON使用jsonencodejsondecode

在请求消息中数据属性是MATLAB数据在转换uint8有效载荷。当你调用数据转换RequestMessage发送完整的方法。转换取决于你content - type指定在消息的类型数据。如果你不指定一个内容类型,那么发送完整的方法试图推断出类型从数据并添加适当的ContentTypeField请求消息。

在一个响应消息,数据代表了uint8有效载荷转换为基于MATLAB类型由服务器指定的内容类型。如果转换失败数据仍然是空的,而出现在原始数据有效载荷财产。

抑制反应的自动转换有效载荷,设置HTTPOptions.ConvertResponse财产。在这种情况下,数据包含一个字符串或字符数据uint8向量的字节数。

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

内容类型的数据属性,指定为只读matlab.net.http.MediaType对象。这个属性决定的内容数据财产转换为或有效载荷。如果content - typeMediaType与一个字符集属性,然后字符集确定编码。

这个属性通常具有相同的值作为调用的结果转换消息包含这个内容类型字段MessageBody

你没有设置ContentType在一个请求消息。当您创建一个MessageBody对象,这个属性是空的。当你复制MessageBody成一个请求消息,ContentType设置的值ContentTypeField的消息,如果有的话。的RequestMessage发送完整的方法设置ContentType基于的类型数据和的值ContentTypeField请求消息。

在一个响应消息,ContentType是基于ContentTypeField的消息。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

这个属性被设置为显示有效载荷财产的ResponseMessage编码。当ContentCoding,没有处理负载和做了什么数据属性是空的。

如果MATLAB收到消息有效负载的使用它支持的压缩算法,编码等万博1manbetxgzip缩小,它会自动解码有效载荷之前其他转换。如果解码成功,它可以存储解码载荷有效载荷转换后的载荷(如果有的话)数据。在这种情况下,这个属性是空的表明有效载荷不编码。

如果负载是编码解码却没有成功,或者你抑制解码通过设置HTTPOptions.DecodePayload财产返回,那么未加工still-encoded载荷有效载荷,数据是空的,ContentCoding字符串设置为一个向量代表内容编码头字段的值的响应消息。在这种情况下,您可以保存有效载荷是(例如,写一个文件),或者根据指定的压缩算法在处理它ContentCoding。例如,如果该值为gzip,您可以编写和使用的数据文件gunzip命令来处理数据。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

数据类型:字符串

原始字节消息中发送,指定为一个uint8向量,标量字符串或字符向量。作为一个请求消息,方便您可以设置有效载荷一个标量字符串或字符向量。MATLAB将值转换为uint8向量。在一个响应消息,有效载荷总是一个uint8向量。

请求消息:

  • 一个标量字符串或字符向量转换使用中指定的字符集或所暗示的ContentType财产,如果任何,或utf - 8编码如果没有成立。使用不同的编码,编码它自己,例如,使用unicode2native功能,分配结果uint8向量有效载荷

  • 如果你不希望输出转换的字节数组,然后设置有效载荷而不是数据财产。如果你设置数据相反,然后有效载荷填写和发送的字节数,如果你指定一个请求或历史返回的理由吗RequestMessage.send的返回值RequestMessage.complete,或者在一个ResponseMessage如果你设置HTTPOptions.SavePayload财产。

  • 当您设置有效载荷,数据清除。如果你发送一条消息数据有效载荷设置,然后有效载荷发送和数据将被忽略。只响应消息和返回的请求消息发送完整的方法可以同时拥有属性设置在同一时间。

在一个响应消息,有效载荷在这些情况下接收到的原始字节:

  • 你指定一个历史回归参数的RequestMessage.send方法。

  • 你设置HTTPOptions.SavePayload财产真正的

  • 有效载荷总是设置消息出现在表明

  • 如果转换的有效载荷MATLAB数据失败。的信息,请查看HTTPException.History财产。

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

方法

全部展开

介绍了R2016b