start

类: matlab.net.http.io.ContentConsumer
命名空间: matlab.net.http.io

开始向 ContentConsumer 进行 HTTP 数据传输

语法

bufsize = start(consumer)

说明

bufsize = start(consumer) 表示 HTTP 传输的开始。

当 MATLAB^® 调用返回 true 的 initialize 方法并准备好向使用程序发送数据后，它将调用 start。所有使用程序都必须实现此抽象方法。

start 方法与 initialize 的不同之处在于，只有当消息中包含有效负载时才会调用它。MATLAB 一收到消息标头就会调用 initialize。因此，在 start 而不是 initialize 中执行初始化可能会更好，这样，如果消息为空，则不会执行初始化。

输入参数

全部展开

`consumer` — 内容使用程序
`matlab.net.http.io.ContentConsumer`

内容使用程序，指定为 matlab.net.http.io.ContentConsumer 对象。

输出参量

全部展开

`bufsize` — 最大缓冲区大小
双精度值 | `[]`

每次调用 putData 方法时 MATLAB 传递的最大缓冲区大小，返回双精度值。此方法返回缓冲区的最大大小，虽然 MATLAB 传入的数据可能比这小。

如果使用程序可以随时处理所有数据，而不管大小如何，则 start 会返回 []，让 MATLAB 选择最佳大小。指定较小的缓冲区大小对于缓慢到达的数据非常有用，因为这样您能够以更及时的方式接收数据，而不是一直等到填满一个很大的缓冲区才开始处理。

如果服务器发送分块编码消息，而且您希望确保 putData 的每次调用包含一个完整的块，则返回 [] 或大于最大块大小的值。MATLAB 永远不会在 putData 的每次调用中一次提供多于一个块，但如果某个块大于 bufsize 或 MATLAB 的内部缓冲区大小，则它可能提供该块的一部分。