主要内容

start

R2026b

类: 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 中执行初始化可能会更好,这样,如果消息为空,则不会执行初始化。

输入参数

全部展开

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

输出参量

全部展开

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

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

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

属性

Abstractprotected

版本历史记录

在 R2018a 中推出

另请参阅

| |