Hiva::CreateWallTimer

函数功能

创建WallTimer定时器。

函数原型

Hiva::WallTimer Hiva::CreateWallTimer(const Hiva::WallDuration &wallPeriod, const WallTimerCallback &wallCallback, const std::string &wallGroupName, const bool oneshot = false, const bool autostart = true)

参数说明

参数名

输入/输出

说明

wallPeriod

输入

触发回调函数的周期，为框架标准的Duration类型。

wallCallback

输入

定时器到期后的回调函数，WallTimerCallback类型，其中WallTimerEvent为：

using WallTimerCallback = std::function<void (const WallTimerEvent &)>;

struct WallTimerEvent
{
    Hiva::WallTime last_expected;    // 上次回调应该发生的时刻
    Hiva::WallTime last_real;        // 上次回调实际发生的时刻
    Hiva::WallTime last_expired;     // 上次定时器在timer Server处过期，并向APP侧发起通知的时刻
    Hiva::WallTime current_expected; // 本次回调应该发生的时刻
    Hiva::WallTime current_real;     // 本次回调实际发生的时刻
    Hiva::WallTime current_expired;  // 本次定时器在timer Server处过期，并向APP侧发起通知的时刻
    struct{
    Hiva::WallDuration last_duration; // 上次callback执行耗时
    } profile;
};

wallGroupName

输入

调用OpenHiva::Init时创建的线程组。如果为确定性组，则使用确定性调度框架；否则使用操作系统的调度框架。

oneshot

输入

定时器的模式标识。

true代表采用一次性的oneshot模式，定时器只会被触发一次。
false代表采用周期性的periodic模式，定时器会被周期性触发，直至进程资源被清理。

autostart

输入

定时器的启动标识。

true代表自动启动，接口返回时定时器已经开启。
false代表不自动启动，接口返回时定时器未开启，需通过Hiva::WallTimer::Start手动开启。

返回值

返回Hiva::WallTimer的handle，后续可基于该handle进行start、stop等操作。

使用说明

进程调用该接口，即创建并开始运行一个定时器。

APP创建WallTimer过程中会订阅一个定时器的事件，定时器名称由APP名称+定时器+序列号生成，以保证唯一性。
APP通过Server/Client的Topic通信方式将定时器name和相关信息发送给定时器Server处理，等时间到期后，定时器Server发布该话题，通知到原APP，执行用户的回调函数。

注意事项

无

父主题： 定时器接口