matlab.net.http.io.StringConsumer 类

用于转换数据的字符集，指定为字符串。此值最初为空。如果将其保留为空，将在收到消息时根据消息的 Content-Type 字段中指定的字符集或默认字符集来设置此值。如果要使用不同的字符集强制进行转换，可以通过在 StringConsumer 构造函数中指定字符集或通过直接设置此属性来完成。子类可以随时设置此属性，包括在消息的中间。如果在调用 putData 后更改此值，之后再调用 putData 时将使用新值。Response.Body.Data 的现有内容不会更改。

开始接收响应时，如果此属性最初为空，MATLAB 会根据 Content-Type 将此属性设置为选定的字符集。将此使用程序重用于其他消息时，可以选择新的字符集。如果您将此属性设置为非空值，MATLAB 永远不会更改它。

属性：

要返回的数据类型，指定为 "string" 或 "char"。此值来自构造函数的 'TextType' 参数。默认值为 "string"。如果您在数据已经存储到 Response.Body.Data 中之后更改此值，那些数据将转换为新类型。

属性：

建议的缓冲区大小，指定为 uint64。MATLAB 将 AllocationLength 设置为传递给 putData 的数据缓冲区的预计大小。实际大小可能更小，也可能更大。为了提高性能，使用程序可以根据此值预先分配处理数据需要的空间。

MATLAB 在调用 start 方法之前设置此属性，从而为子类提供方便。

属性：

有效负载的预期长度，指定为 uint64。此属性通常是 Header 属性中的 matlab.net.http.field.ContentLengthField 的 Value 属性。

如果 ContentLength 为空，则长度未知。当调用 putData(uint8.empty) 时，有效负载结束。

MATLAB 在调用 initialize 之前设置此属性，从而为子类提供方便（知道数据长度可能对子类有好处）。

如果此 ContentConsumer 是顶层使用程序的代理，则 ContentLength 的值可能与顶层使用程序的 ContentLength 值不同。

示例: numel(someData)，其中 someData 的类型为 uint8

属性：

有效负载的媒体类型，指定为 matlab.net.http.MediaType 对象。此属性通常是 Header 属性中的 matlab.net.http.field.ContentTypeField 的 Value 属性。如果 ContentType 属性为空，则 ContentTypeField 为空或不存在。

MATLAB 在调用 initialize 之前设置此属性，从而为可能需要检查 MediaType 的子类提供方便。如果子类根据数据确定它具有不同的 MediaType，则可以设置此属性。

当传输结束时，MATLAB 将此值复制到 Response.Body.ContentType 属性中。

示例: 'application/octet-stream'

属性：

当前正在处理的有效负载的标头，指定为 matlab.net.http.HeaderField 对象。

使用程序根据此标头确定如何处理发送给它们的有效负载。对于顶层使用程序，此值与 Response.Header 相同。对于代理来说，值可能不同。例如，在 MultipartConsumer 处理的 multipart 消息中，它是此代理正在处理的那一部分的标头。代理仍然可以检查 Response.Header 以获得原始消息的标头。

MATLAB 在调用 initialize 之前设置此属性，从而为子类提供方便。

属性：

发送的已完成的 RequestMessage，指定为 matlab.net.http.RequestMessage 对象。这是所有重定向之后的最后一个 RequestMessage，它是来自 send 方法的 completedrequest 返回值。

MATLAB 在调用 initialize 之前设置此属性，从而为子类提供方便。

属性：

正在处理的 ResponseMessage，指定为 matlab.net.http.ResponseMessage 对象。

MATLAB 在调用 initialize 之前设置 Response 属性。值是收到标头之后、接收有效负载之前的 ResponseMessage。在开始处理响应消息时（如果是 Multipart 消息，则是在开始处理其中一部分时），ResponseMesssage.Body 属性是具有空 Data 和 Payload 属性的 MessageBody 对象。为了存储收到的数据，使用程序可在数据传输过程中修改 Response 和 MessageBody.Data 属性。通常，处理并存储数据的使用程序将 Response.Body.Data 设置为它们处理的有效负载，但这并不是必需的。当传输完成时，MATLAB 将此 Response 返回给 send 的调用方。使用程序不应修改其他 Response 属性，如 Header 或 StatusLine，因为这些更改将返回给 send 的调用方。

Response.Body.Payload 属性在传输过程中为空，使用程序不应尝试修改它。如果设置了 HTTPOptions.SavePayload 属性，在消息或一部分传输结束时（调用 putData(uint8.empty) 之后）或在发生异常时，MATLAB 会将 Payload 设置为已收到的有效负载。

如果在处理消息期间使用程序中发生异常，MATLAB 将抛出 HTTPException 对象。History 属性包含此 Response 值。

如果使用程序是一个代理，负责处理 Multipart 消息中的一部分，则 Response.Header 包含整个消息的标头，而且在为每一部分调用 ContentConsumer 之前会清除 Response.Body 的 Payload 和 Data 属性。在每一部分结束时，新的 ResponseMessage 会添加到原始响应的 Body.Data（包含来自此对象的 Header 和来自此属性的 Body）中的 ResponseMessage 对象数组的末尾。下一个代理会看到一个全新的 Response，它具有一个空 MessageBody，而不是上一个代理的 MessageBody。

属性：

正在处理的请求的目标，指定为 matlab.net.URI 对象。此值是由 send 确定的原始目标 URI。它不是代理的 URI 或重定向后的最终 URI。

MATLAB 在调用 initialize 之前设置此属性，从而为子类提供方便。

属性：