前言

在熟悉任務調(diào)度、程序分層和模塊化編程關(guān)于軟件架構(gòu)、分層和模塊設計后，除了函數(shù)調(diào)用設計中出現(xiàn)的情況外，還會遇到同層模塊之前如何進行消息交互，通常是應用層之間。

比如一個設備通過架構(gòu)設計包含人機交互應用層模塊（一般會調(diào)用按鍵和顯示屏等功能驅(qū)動模塊）和通信應用層模塊（一般調(diào)用串口、CAN和網(wǎng)絡ESP8266等功能驅(qū)動模塊），兩個同層之間的模塊如果需要互傳數(shù)據(jù)，一般都是調(diào)用各自頭文件提供的接口（模塊對外提供的接口盡量不要使用全局變量，防止其他模塊擅自修改），這樣就造成了耦合。

設計思路

上述情況，也可以采用回調(diào)函數(shù)的實現(xiàn)方式進行模塊解耦，但是需要引入新的內(nèi)容，即公共模塊Commoon層（包含第三方功能庫）。

公共模塊主要有各模塊都需要使用的類型定義、結(jié)構(gòu)體定義、通用函數(shù)或常用宏定義等（通常屬于基礎類的功能，不會受功能需求和不同平臺的影響）。

基于公共模塊，為了解決各模塊之前的數(shù)據(jù)交互，可以通過公共模塊實現(xiàn)基礎類的功能達到各應用層模塊解耦的目的。

參考消息隊列的方式，可以實現(xiàn)一個生產(chǎn)者/消費者的功能模塊（這種可以稱作觀察者模式，即存在觀察者和被觀察者），即某一模塊更新數(shù)據(jù)后，其他模塊可以第一時間得到通知更新（采用回調(diào)函數(shù)的方式實現(xiàn)）

看圖：

Callback是一個指針數(shù)組變量，每個數(shù)組成員都是函數(shù)指針類型的變量，通過函數(shù)Notify_Attach拿到了應用層代碼函數(shù)OnSaveParam(...) 和OnUpdateParam(...)的函數(shù)地址，之后人機交互模塊調(diào)用了Notify_EventNotify，從而調(diào)用Callback ，調(diào)用方式和直接調(diào)用 OnFunction(...) 存在些許差異，因為是數(shù)組，所有需要[]取函數(shù)地址，為了保證系統(tǒng)運行安全，調(diào)用前要確保 Callback[i] 不為NULL，否則會引起程序異常。

從上述看，也許有人感覺這樣處理反而復雜了，直接調(diào)用不香嗎？（上述人機交互模塊屬于被觀察者，參數(shù)和其他模塊屬于觀察者）

有以下幾個好處：

1. 避免各模塊相互調(diào)用，可完成解耦
2. 即使 觀察者 模塊其中一個被移除，也不用修改 被觀察者 或者 其他觀察者 代碼，保證系統(tǒng)穩(wěn)定
3. 新增一個 觀察者 模塊，也不需要修改 被觀察者 代碼，保證系統(tǒng)穩(wěn)定

當然這種方式也有缺點：

1. 如果回調(diào)函數(shù)過多，或者某一個 觀察者 的回調(diào)函數(shù)執(zhí)行時間很長，肯定會影響到其他觀察者 模塊的通知時間，甚至影響 被觀察者 模塊的正常運行
2. 如果 觀察者 和 被觀察者 之間有循環(huán)依賴，就會導致他們循環(huán)調(diào)用，導致系統(tǒng)死機

避免方式：

1. 回調(diào)函數(shù)中一定要保證執(zhí)行的時間短，不能有執(zhí)行時間長的功能，甚至延時（一般回調(diào)中處理數(shù)據(jù)更新等執(zhí)行時間短的即可，數(shù)據(jù)更新后的需要花時間處理的可以在主循環(huán)執(zhí)行）
2. 觀察者回調(diào)函數(shù)中盡量避免執(zhí)行其他觀察者的回調(diào)函數(shù)，防止循環(huán)調(diào)用

示例代碼

下面簡單實現(xiàn)人機交互模塊在某種情況下需要保存參數(shù)，具體如何保存參數(shù)由參數(shù)模塊實現(xiàn)，人機交互模塊通過事件通知模塊告知參數(shù)模塊需要保存數(shù)據(jù)。

初步來看，可能中間多了一個，嫌實現(xiàn)麻煩，不如直接調(diào)用；但是從后期功能擴展和解耦來看，這是很有必要的。

事件通知模塊

頭文件定義

#ifndef _NOTIFY_H_
#define _NOTIFY_H_


#include 


/**
  * @brief 應用模塊ID枚舉定義
  *
  */
typedef enum
{
    NOTIFY_ID_HMI = 0,   // 人機交互模塊
    NOTIFY_ID_SYS_PARAM, // 參數(shù)管理模塊

    NOTIFY_ID_TOTAL
} NotifyId_e;

/**
  * @brief 事件類型枚舉定義
  *
  */
typedef enum
{
    NOTIFY_EVENT_PARAM_UPDATE,     // 參數(shù)更新事件, 對應結(jié)構(gòu)體 PrramUpdateInfo_t

    NOTIFY_EVENT_TOTAL
} NotifyEvent_e;


typedef struct
{
    uint16_t addr;
    uint32_t param;
}PrramUpdateInfo_t;


typedef int (*EventNotifyCB)(NotifyId_e id, NotifyEvent_e eEvent, const void *pData, uint32_t length);


extern void Notify_Init(void);

extern int Notify_Attach(NotifyId_e id, NotifyEvent_e eEvent, EventNotifyCB pfnCallback);
extern int Notify_Detach(NotifyId_e id, NotifyEvent_e eEvent);
extern int Notify_EventNotify(NotifyId_e id, NotifyEvent_e eEvent, const void *pData, uint32_t length);

#endif /* _NOTIFY_H_ */

源文件實現(xiàn)

#include "notify.h"
#include 

static EventNotifyCB sg_pfnCallback[NOTIFY_ID_TOTAL][NOTIFY_EVENT_TOTAL];

/**
  * @brief      事件初始化
  *
  */
void Notify_Init(void)
{
    memset(sg_pfnCallback, 0, sizeof(sg_pfnCallback));
}

/**
  * @brief      添加事件監(jiān)聽通知
  *
  * @param[in]  id          應用模塊ID
  * @param[in]  eEvent      事件
  * @param[in]  pfnCallback 回調(diào)函數(shù)
  * @return     0,成功; -1,失敗
  */
int Notify_Attach(NotifyId_e id, NotifyEvent_e eEvent, EventNotifyCB pfnCallback)
{
    if (id >= 0 && id < NOTIFY_ID_TOTAL && eEvent < NOTIFY_EVENT_TOTAL)
    {
        sg_pfnCallback[id][eEvent] = pfnCallback;
        return 0;
    }

    return -1;
}

/**
  * @brief      刪除事件監(jiān)聽通知
  *
  * @param[in]  id          應用模塊ID
  * @param[in]  eEvent      事件
  * @return     0,成功; -1,失敗
  */
int Notify_Detach(NotifyId_e id, NotifyEvent_e eEvent)
{
    if (id >= 0 && id < NOTIFY_ID_TOTAL && eEvent < NOTIFY_EVENT_TOTAL)
    {
        sg_pfnCallback[id][eEvent] = 0;
        return 0;
    }

    return -1;
}

/**
  * @brief      事件通知
  *
  * @param[in]  id          應用模塊ID
  * @param[in]  eEvent      事件類型
  * @param[in]  pData       消息內(nèi)容
  * @param[in]  length      消息長度
  * @return     0,成功; -1,失敗
  */
int Notify_EventNotify(NotifyId_e id, NotifyEvent_e eEvent, const void *pData, uint32_t length)
{
    int i;

    if (eEvent < NOTIFY_EVENT_TOTAL)
    {
        for (i = 0; i < NOTIFY_ID_TOTAL; i++)
        {
            if (sg_pfnCallback[i][eEvent] != 0)
            {
                sg_pfnCallback[i][eEvent](id, eEvent, pData, length);
            }
        }

        return 0;
    }

    return -1;
}

參數(shù)應用層模塊

示例通信，作為觀察者監(jiān)聽參數(shù)保存的消息。

#include "notify.h"

static int Param_OnNotifyProc(NotifyId_e id, NotifyEvent_e eEvent, const void *pData, uint32_t length);

void Param_Init(void)
{
    Notify_Attach(NOTIFY_ID_SYS_PARAM, NOTIFY_EVENT_PARAM_UPDATE, Param_OnNotifyProc);
}

// 事件回調(diào)處理
int Param_OnNotifyProc(NotifyId_e id, NotifyEvent_e eEvent, const void *pData, uint32_t length)
{
    switch (eEvent)
    {
    case NOTIFY_EVENT_PARAM_UPDATE:
        {
            PrramUpdateInfo_t *pInfo = (PrramUpdateInfo_t *)pData;
            SaveParam(pInfo->addr, pInfo->param);// 保存參數(shù)
        }
        break;
    default:
        break;
    }

    return 0;
}

人機交互應用層模塊

示例通信，作為被觀察者通知/發(fā)送參數(shù)保存的消息。

#include "notify.h"

void Hmi_Init(void)
{

}

// 需要保存參數(shù)
int Hmi_SaveProc(void)
{
    ParamUpdateInfo_t info;

    info.addr = 5;
    info.param = 20;

    Notify_EventNotify(NOTIFY_ID_HMI, NOTIFY_EVENT_HMI_UPDATE, &info, sizeof(ParamUpdateInfo_t));
}