matlab.net.http.io.MultipartProvider 类
命名空间: matlab.net.http.io
超类: matlab.net.http.io.ContentProvider
发送 multipart/mixed HTTP 消息的 ContentProvider
描述
此提供程序可以帮助创建 Multipart HTTP 消息。
默认的 Content-Type 为 "multipart/mixed"
,消息的有效负载可以包含任意多个组成部分,每一部分都包含一个描述该部分的标头。有关 multipart 消息的详细信息,请参阅 Internet Engineering Task Force (IETF®) 网站上的 RFC 2046, section 5.1。
仅当您知道服务器接受 multipart/mixed 消息时才能直接使用此提供程序。通常,接受 Multipart 消息的服务器要求类型为 "multipart/form-data"
,它由子类 MultipartFormProvider
实现。您可以使用子类实现其他 Multipart 类型。
matlab.net.http.io.MultipartProvider
类是一个 handle
类。
子类编写者须知
Multipart 消息的每一部分可以指定为 RequestMessage.Body
允许的任何格式的数据,也可以指定为创建数据的 ContentProvider
。用于为各部分提供数据的 ContentProvider
对象称为代理,而这个 MultipartProvider
就是顶层提供程序。通常,任何 ContentProvider
都适合作为代理。在发送消息的过程中,MultipartProvider
依次调用每个代理及其方法(如 complete
或 start
),因此代理通常不需要知道它只是为消息的一部分而不是整个消息提供内容。
此提供程序始终将 RequestMessage
分块发送,因此它不会在消息中或任何组成部分的标头中包含 Content-Length 标头字段。虽然 MultipartProvider
在发送各部分之前调用每个代理的 expectedContentLength
方法,但它只是使用返回值(如果非空)来限制长度,而不是来创建 Content-Length 字段。如果代理确实希望该部分出现一个 Content-Length 字段,则必须在其 Header
属性中显式插入此字段。MATLAB® 提供的任何 ContentProvider
子类都无法完成此处理。
创建对象
描述
provider = MultipartProvider(
构造一个 part1,...,partN
)MultipartProvider
,它按照指定的顺序在 HTTP 请求中发送指定的部分。默认情况下,此提供程序将消息的 Content-Type 设置为 "multipart/mixed"
,但子类可以通过设置 Subtype
属性来更改子类型。构造函数将 Parts
属性元胞数组的元素设置为每个 part1,...,partN
参量。
属性
方法
详细信息
版本历史记录
在 R2018a 中推出