Function Flow Runtime并发队列(C++)
==============================

#### 概述

FFRT并发队列提供了设置任务优先级（Priority）和队列并发度的能力，使得队列中的任务能同时在多个线程上执行，获得更高的并行效果。

*   **队列并发度**：通过队列最大并发度设置，可以控制同一时刻同时执行的任务数量。这有助于避免任务并发过多对系统资源造成冲击，从而保证系统的稳定性和性能。
*   **任务优先级**：用户可以为每个任务设置优先级，不同的任务将严格按照优先级进行调度和执行。相同优先级的任务按照排队顺序执行，高优先级的任务将优先于低优先级的任务执行，确保关键任务能够及时处理。

#### 示例：银行服务系统

举例实现一个银行服务系统，每个客户向系统提交一个服务请求，可以区分普通用户和VIP用户，VIP用户的服务请求可以优先得到执行。银行系统中有2个窗口，可以并行取出用户提交的服务请求办理。

可以利用FFRT的并行队列范式做如下建模：

*   **排队逻辑**：并行队列。
*   **服务窗口**：并行队列的并发度，同时也对应FFRT Worker数量。
*   **用户等级**：并行队列任务优先级。

实现代码如下所示：

#include <unistd.h>
#include "hilog/log.h"
#include "ffrt/ffrt.h" // 来自 OpenHarmony 第三方库 "@ppd/ffrt"

#undef LOG\_TAG
#define LOG\_TAG "ConcurrentCppTag"

const int SLEEP\_TIME = 100 \* 1000;
const int BANK\_CONCURRENCY = 2;

class BankQueueSystem {
private:
    std::unique\_ptr<ffrt::queue> queue\_;

public:
    BankQueueSystem(const char \*name, int concurrency)
    {
        queue\_ = std::make\_unique<ffrt::queue>(
            ffrt::queue\_concurrent, name, ffrt::queue\_attr().max\_concurrency(concurrency));
        OH\_LOG\_INFO(LOG\_APP, "bank system has been initialized");
    }

    ~BankQueueSystem()
    {
        queue\_ = nullptr;
        OH\_LOG\_INFO(LOG\_APP, "bank system has been destroyed");
    }

    // 开始排队，即提交队列任务
    ffrt::task\_handle Enter(const std::function<void()>& func, const char \*name, ffrt\_queue\_priority\_t level, int delay)
    {
        return queue\_->submit\_h(func, ffrt::task\_attr().name(name).priority(level).delay(delay));
    }

    // 退出排队，即取消队列任务
    int Exit(const ffrt::task\_handle &t)
    {
        return queue\_->cancel(t);
    }

    // 等待排队，即等待队列任务
    void Wait(const ffrt::task\_handle& handle)
    {
        queue\_->wait(handle);
    }
};

void BankBusiness()
{
    usleep(SLEEP\_TIME);
    OH\_LOG\_INFO(LOG\_APP, "saving or withdraw ordinary customer");
}

void BankBusinessVIP()
{
    usleep(SLEEP\_TIME);
    OH\_LOG\_INFO(LOG\_APP, "saving or withdraw VIP");
}

int ConcurrentQueueCppExec()
{
    BankQueueSystem bankQueue("Bank", BANK\_CONCURRENCY);

    auto task1 = bankQueue.Enter(BankBusiness, "customer1", ffrt\_queue\_priority\_low, 0);
    auto task2 = bankQueue.Enter(BankBusiness, "customer2", ffrt\_queue\_priority\_low, 0);
    // VIP享受更优先的服务
    auto task3 = bankQueue.Enter(BankBusinessVIP, "customer3 vip", ffrt\_queue\_priority\_high, 0);
    auto task4 = bankQueue.Enter(BankBusiness, "customer4", ffrt\_queue\_priority\_low, 0);
    auto task5 = bankQueue.Enter(BankBusiness, "customer5", ffrt\_queue\_priority\_low, 0);

    // 取消客户4的服务
    bankQueue.Exit(task4);

    // 等待所有的客户服务完成
    bankQueue.Wait(task5);
    return 0;
}

#### 接口说明

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

| 名称 | 描述 |
| :-- | :-- |
| class [task\_attr](https://gitcode.com/openharmony/resourceschedule_ffrt/blob/master/docs/ffrt-api-guideline-cpp.md#task_attr) | 任务属性类。 |
| class [queue\_attr](https://gitcode.com/openharmony/resourceschedule_ffrt/blob/master/docs/ffrt-api-guideline-cpp.md#queue_attr) | 队列属性类。 |
| class [queue](https://gitcode.com/openharmony/resourceschedule_ffrt/blob/master/docs/ffrt-api-guideline-cpp.md#queue) | 队列类。 |

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/52/v3/2Xfzn0L1TGWXaRKSjW_NIQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132448Z&HW-CC-Expire=86400&HW-CC-Sign=AF3FE6C9F07BBEFF1A9297CA8CCBDA050AD11E44E7C31A475C4A9A8320695857)

*   如何使用FFRT C++ API详见：[FFRT C++接口三方库使用指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ffrt-development-guideline#using-ffrt-c-api-1)。
*   使用FFRT C接口或C++接口时，都可以通过FFRT C++接口三方库简化头文件包含，即使用#include "ffrt/ffrt.h"头文件包含语句。

#### 约束限制

并发队列最大并发度建议控制在合理范围内，配置过大超过Worker线程数没有意义，配置过小可能导致系统资源利用率不足。