主要内容

matlab.net.http.ProgressMonitor类

包:matlab.net.http
超类:处理

进度监控HTTP消息交换

描述

使用ProgressMonitor类实现一个进度监控HTTP请求消息。一个进度监控听这个类的属性的变化来实现显示或更新你的选择。

实现一个进度监控,创建这个类的一个子类。然后创建一个HTTPOptions作为对象,指定子类ProgressMonitorFcn属性,并设置UseProgressMonitor财产真正的

一个HTTP请求开始时调用RequestMessage.send方法。过程可能涉及多个消息在两个方向上的重定向和身份验证。MATLAB®调用完成当所有方法转移已经完成。

在传输:

  • MATLAB设置马克斯,CancelFcn,方向当你调用属性RequestMessage.send

  • MATLAB设置价值财产多次请求消息发送到的身体表示传输的字节数。

  • 当收到ResponseMessage开始,MATLAB集方向响应再一次集价值反复。

  • 在任何时候取消转移,调用CancelFcn函数。这个动作是一样的干扰发送在命令窗口函数。

你可以显示一个图形化的进度或其他进步的迹象方向更改响应。为每个后续价值当前,更新指标价值。您还可以使用这种机制以编程方式监测进展。

matlab.net.http.ProgressMonitor类是一个处理类。

创建

obj = matlab.net.http.ProgressMonitor(名称、值)创建一个进度监控与额外的属性指定一个或多个名称-值对参数。的名字属性名和吗价值相应的价值。您可以指定几个名称-值对参数在任何顺序Name1, Value1,…,的家。未指定的属性设置为默认值。

属性

全部展开

秒的电话,第一个电话和最大间隔指定为两倍。

时间间隔的时间在秒后开始转移前的第一个设置价值财产。时间间隔一个建议的最大设置之间的时间价值,不管进步。如果总时间小于传输数据时间间隔秒,然后价值没有设置,如果没有数据传输时间间隔秒自上次设置的价值,然后价值可能会再次设置为相同的值。通过这种方式,你的ProgressMonitor对象可以取消转移(通过调用CancelFcn即使没有进展。

时间间隔值是一个建议值。没有保证MATLAB集价值时间间隔秒内如果没有进步。

默认的时间间隔是2秒。指定一个不同的值,设置时间间隔在你的构造函数。连续的最小时间间隔设置的价值当没有进步是0.1秒。然而,如果价值变化,这可能是比这更经常间隔。

设置后价值第一次,没有延迟价值相同的后续消息交换。

监控是在使用指标,指定为真正的。MATLAB设置这个属性来表示是否使用这个ProgressMonitor对象在一个转移。InUse阻止你重用这个对象超过一次一个转移。

数据类型:逻辑

函数调用取消转移,指定为一个函数处理。MATLAB集CancelFcn你的函数ProgressMonitor应该叫取消转移。调用这个函数有相同的效应中断传输的命令窗口。

指定的转移,最大长度uint64。如果最大长度是未知的,马克斯[]马克斯是你的最大价值显示进度。

MATLAB集马克斯每个发送和接收操作开始时预期的传输的字节数,根据内容长度头字段。

如果消息不包含内容长度字段,马克斯[]。在这种情况下,您不能确定转移的比例已经完成。但是,您可以监测的变化价值财产。

方向转移,指定为一个matlab.net.http.MessageType对象。MATLAB集方向表明是否进步是监测请求消息和响应消息。如果没有发生转移方向是空的。

传输的字节数,到目前为止,指定为uint64。MATLAB集价值反复总为当前消息传输的字节数。然而,它延迟设置这个属性第一次交换,直到至少时间间隔秒的时间,开始的消息。

实现一个set.Value这个属性的方法来监测进展的转移。您还可以实现从内部取消转移进度监控的能力set.Value方法。

MATLAB可以设置价值空在给定的转移,表明在当前方向转移已经结束。MATLAB总是集价值空在调用之前所有转移的结论完成方法。

你不能控制MATLAB更新的频率价值财产。然而,MATLAB可能集价值至少一次时间间隔秒,即使没有进步。这种行为允许您调用CancelFcn如果传输不是进步。价值可能是零如果没有传输字节时间间隔秒后开始转移。

方法

全部展开

版本历史

介绍了R2016b

另请参阅