大网数据广告活动
OpenHarmony 设备与应用开发

Function Flow Runtime串行队列(C++)

· 52CE 我爱测

FFRT串行队列基于协程调度模型实现,提供高效的消息队列功能,支持异步通信、流量削峰、无锁化状态和资源管理以及架构解耦等多种业务场景。FFRT串行队列支持以下功能:

Function Flow Runtime串行队列(C++)

概述

FFRT串行队列基于协程调度模型实现,提供高效的消息队列功能,支持异步通信、流量削峰、无锁化状态和资源管理以及架构解耦等多种业务场景。FFRT串行队列支持以下功能:

  • ​队列创建销毁​,支持创建和销毁队列,创建时可指定队列名称和优先级。每个队列功能上相当于一个单独的线程,队列中的任务相对于用户线程异步执行。
  • 任务延迟​,支持在任务提交时设置延迟时间(delay),单位为微秒(us)。延迟任务将在uptime(提交时刻+延迟时间)后调度执行。
  • ​串行调度​,同一队列中的任务按照uptime升序排列,严格串行执行。确保队列中上一个任务完成后,下一个任务才会开始执行。
  • ​任务取消​,支持根据任务句柄取消未出队的任务。若任务已开始执行或执行完成,则无法取消。
  • ​任务等待​,支持根据任务句柄等待任务完成。指定任务完成时,队列中所有uptime早于该任务的任务均已执行完成。
  • 任务优先级​,支持在任务提交时设置单个任务的优先级。优先级仅在任务出队后相对于系统其他负载生效,不影响同一队列内任务的串行顺序。若未设置任务优先级,则默认继承队列的优先级。

示例:异步日志系统

举例实现一个异步日志系统,主线程将日志任务提交到队列,后台线程从队列中取出任务并写入文件。这种方式既能保证日志的顺序性,又能避免文件写入操作阻塞主线程。

借助FFRT并行化框架API,开发者只需专注于业务逻辑的实现,无需关注异步线程管理、线程安全及调度效率等问题。

用例简化了异常处理和线程安全相关的一些逻辑,实现代码如下所示:

#include <chrono>
#include <thread>
#include "hilog/log.h"
#include "ffrt/ffrt.h" // 来自 OpenHarmony 第三方库 "@ppd/ffrt"
#undef LOG_TAG
#define LOG_TAG "SerialCppTag"

class Logger {
public:
    Logger()
    {
        // 创建队列
        queue_ = std::make_unique<ffrt::queue>("loggerQueue");
        
        logFile_ = stdout;
        OH_LOG_INFO(LOG_APP, "Log file opened");
    }

    ~Logger()
    {
        // 销毁队列
        queue_ = nullptr;
        OH_LOG_INFO(LOG_APP, "Log file closed");
    }

    // 添加日志任务
    void Log(const std::string& message)
    {
        queue_->submit([this, message] {
            OH_LOG_INFO(LOG_APP, "Writing message %{public}s", message.c_str());
        });
    }

private:
    FILE *logFile_;
    std::unique_ptr<ffrt::queue> queue_;
};

int SerialQueueCppExec()
{
    Logger logger;

    // 主线程添加日志任务
    logger.Log("Log message 1");
    logger.Log("Log message 2");
    logger.Log("Log message 3");

    // 模拟主线程继续执行其他任务
    std::this_thread::sleep_for(std::chrono::seconds(1));

    return 0;
}

接口说明

上述样例中涉及到主要的FFRT的接口包括:

名称 描述
class queue 队列类。
sleep_for 延迟一定时间。

说明:

  • 如何使用FFRT C++ API详见:FFRT C++接口三方库使用指导。
  • 使用FFRT C接口或C++接口时,都可以通过FFRT C++接口三方库简化头文件包含,即使用#include "ffrt/ffrt.h"头文件包含语句。

约束限制

  • 避免提交超长任务 FFRT内置进程级队列任务超时检测机制。当串行任务执行时间超过预设阈值(默认30秒)时,系统将打印和上报异常日志,并触发预设的进程超时回调函数(如已配置)。
  • 同步原语使用规范 在提交给FFRT的任务闭包中,避免使用std::mutex、std::condition_variable和std::recursive_mutex,标准库同步原语会长时间占用FFRT Worker线程。请替换为FFRT提供的同步原语:ffrt::mutex、ffrt::condition_variable或ffrt::recursive_mutex,其用法与标准库相同。
  • 全局变量中的队列管理 若在全局变量中管理串行队列,随业务进程销毁,测试程序中需注意生命周期解耦问题。在测试用例结束时,需显式释放串行队列,其他资源可随全局变量释放。原因是全局变量在主函数结束后析构,而串行队列的释放依赖于FFRT框架中的其他资源,此时这些资源可能已被销毁。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。