Main Content

start

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

开始从 ContentProvider 进行数据传输

语法

start(provider)

说明

每当 MATLAB® 通过一次或多次调用 getData 准备开始传输数据流时,就会调用 start(provider)。每次调用时,此提供程序都应重置,以便下次调用 getData 返回到数据流的开头。

调用 start 表示已建立服务器连接,数据传输即将开始。后续调用 start(中间没有调用 complete 方法)可能表示服务器请求重定向到其他服务器或者要求使用身份验证证书再试一次,这种情况可能发生在数据流传输之前、期间或之后。

如果您的提供程序可以重启,请重置您的提供程序,使下一次调用 getData 返回到数据流的开头,并确保 restartable 方法返回 true

如果您的提供程序不可对同一条消息重启,但可重用于新消息,请确保 restartable 返回 false。

覆盖此方法的子类应始终先调用它们的超类方法。如果提供程序已启动并且不可重启,则默认情况下 start 会引发异常。

此方法是实现代价高昂的初始化的最佳位置,这种初始化直到服务器准备好接收数据时才需要进行,这与 complete 方法正好相反,后者必须先进行必要的初始化才能创建消息标头。如果无法联系服务器或者服务器拒绝接收消息,则 MATLAB 不会调用 start

输入参数

全部展开

内容提供程序,指定为 matlab.net.http.io.ContentProvider 对象。

版本历史记录

在 R2018a 中推出