事件路由

来源:https://www.cnblogs.com/linhaostudy/archive/2019/06/28/11103974.html
-Advertisement-
Play Games

1. 概述 業務軟體設計開發過程中會依賴一些基礎組件， 事件路由就是常見的基礎組件。 本模塊結合業務場景， 定製了一個基本的事件路由模塊。 本文主要介紹了事件路由模塊及其使用方法， 用於指導用戶開發。 2. 架構原理 事件路由模塊， 提供了一種事件分發的框架。 用戶可以自己定義事件以及事件的處理策略 ...


1. 概述

業務軟體設計開發過程中會依賴一些基礎組件， 事件路由就是常見的基礎組件。 本模塊結合業務場景， 定製了一個基本的事件路由模塊。

本文主要介紹了事件路由模塊及其使用方法， 用於指導用戶開發。

2. 架構原理

事件路由模塊， 提供了一種事件分發的框架。 用戶可以自己定義事件以及事件的處理策略。 具體系統框圖組成及對外介面關係如圖 15-1 所示。

圖15-1 事件路由模塊系統框圖

概括來說， 事件路由模塊主要由以下部分構成：

  • 訂閱者

用戶自定義訂閱者： 訂閱者名稱， 事件處理函數， 用戶擴展參數， 事件是否同步處理。

  • 事件定義

用戶自定義事件：事件 ID， 參數 1， 參數 2， 處理結果， 創建時間， 負載。

  • 事件發佈

支持事件統一發佈。

  • 事件處理者

訂閱者支持非同步處理事件， 內部啟動線程獨立處理。

  • 歷史事件

支持上一次事件的查詢。

3. API 參考

該功能模塊為用戶提供以下 API：

  • HI_EVTHUB_Init： 初始化事件路由模塊。
  • HI_EVTHUB_Deinit： 去初始化事件路由模塊。
  • HI_EVTHUB_Register： 註冊事件。
  • HI_EVTHUB_UnRegister： 解註冊事件。
  • HI_EVTHUB_Publish： 發佈事件。
  • HI_EVTHUB_CreateSubscriber： 創建訂閱者。
  • HI_EVTHUB_DestroySubscriber：銷毀訂閱者。
  • HI_EVTHUB_Subscribe： 訂閱事件。
  • HI_EVTHUB_UnSubscribe：解訂閱事件。
  • HI_EVTHUB_GetEventHistory：獲取歷史事件。
  • HI_EVTHUB_SetEnabled：設置使能標記。
  • HI_EVTHUB_GetEnabled：獲取使能標記。

HI_EVTHUB_Init

【描述】

初始化事件路由模塊。

【定義】

HI_S32 HI_EVTHUB_Init();

【參數】

無。

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

該模塊是單實例， 僅需一次初始化。

【舉例】

無。

HI_EVTHUB_Deinit

【描述】

去初始化事件路由模塊。

【定義】

HI_S32 HI_EVTHUB_Deinit();

【參數】

無。

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_Register

【描述】

註冊事件。

【定義】

HI_S32 HI_EVTHUB_Register(HI_EVENT_ID EventID);

【參數】
參數名稱 | 描述 | 輸入/輸出
--- | ---| ---
EventID| 事件 ID。| 輸入

【返回值】
返回值| 描述
---| ---
0 | 成功。
非 0 | 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_UnRegister

【描述】

解註冊事件。

【定義】

HI_S32 HI_EVTHUB_UnRegister(HI_EVENT_ID EventID);

【參數】

參數名稱 描述 輸入/輸出
EventID 事件 ID。 輸入

【返回值】
返回值 | 描述
---|---
0 | 成功。
非 0 | 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_Publish

【描述】

發佈事件。

【定義】

HI_S32 HI_EVTHUB_Publish(HI_EVENT_S *pEvent);

【參數】

參數名稱 描述 輸入/輸出
pEvent 事件指針。 輸入

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_CreateSubscriber

【描述】

創建訂閱者。

【定義】

HI_S32 HI_EVTHUB_CreateSubscriber(HI_SUBSCRIBER_S pstSubscriber,HI_MW_PTR ppSubscriber);

【參數】

參數名稱 描述 輸入/輸出
pstSubscriber 訂閱者參數。 輸入
ppSubscriber 訂閱者句柄指針。 輸出

【返回值】
返回值 | 描述
---|---
0 | 成功。
非 0 | 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_DestroySubscriber

【描述】

銷毀訂閱者。

【定義】

HI_S32 HI_EVTHUB_DestroySubscriber(HI_MW_PTR pSubscriber);

【參數】
參數名稱| 描述| 輸入/輸出
---|---|---
pSubscriber| 訂閱者句柄。| 輸入

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

HI_EVTHUB_Subscribe

【描述】

訂閱事件。

【定義】

HI_S32 HI_EVTHUB_Subscribe(HI_MW_PTR pSubscriber,HI_EVENT_ID EventID);

【參數】

參數名稱 描述 輸入/輸出
pSubscriber 訂閱者句柄。 輸入
EventID 事件 ID。 輸入

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_UnSubscribe

【描述】

解訂閱事件。

【定義】

HI_S32 HI_EVTHUB_UnSubscribe(HI_MW_PTR pSubscriber,HI_EVENT_ID EventID);

【參數】

參數名稱 描述 輸入/輸出
pSubscriber 訂閱者句柄。 輸入
EventID 事件 ID。 輸入

【返回值】
返回值| 描述
---|---
0 | 成功。
非 0 | 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_GetEventHistory

【描述】

獲取歷史事件。

【定義】

HI_S32 HI_EVTHUB_GetEventHistory(HI_S32 EventID,HI_EVENT_S *pEvent);

【參數】

參數名稱 描述 輸入/輸出
EventID 事件 ID。 輸入
pEvent 事件指針。 輸出

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_SetEnabled

【描述】

設置使能標記。

【定義】

HI_S32 HI_EVTHUB_SetEnabled(HI_BOOL bFlag);

【參數】
參數名稱 | 描述| 輸入/輸出
---|---|---
bFlag | 使能標記。| 輸入

【返回值】

返回值 描述
0 成功。
非 0 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

HI_EVTHUB_GetEnabled

【描述】

獲取使能標記。

【定義】

HI_S32 HI_EVTHUB_GetEnabled(HI_BOOL *pFlag);

【參數】
參數名稱| 描述| 輸入/輸出
---| ---|---
pFlag | 使能標記指針。| 輸出

【返回值】
返回值 | 描述
---|---
0 | 成功。
非 0 | 失敗，參見錯誤碼。

【需求】

  • 頭文件： hi_eventhub.h
  • 庫文件： libeventhub.a/ libeventhub.so

【註意】

無。

【舉例】

無。

4. 數據類型

事件路由模塊相關數據類型定義如下：

  • EVENT_PAYLOAD_LEN： 事件負載數據最大長度。
  • HI_EVTHUB_SUBSCRIBE_NAME_LEN： 訂閱者名稱最大長度。
  • HI_EVTHUB_MESSAGEQURUR_MAX_SIZE： 消息隊列最大值。
  • HI_EVENT_ID： 事件 ID。
  • HI_EVENT_S： 事件結構體。
  • HI_SUBSCRIBER_S： 訂閱者結構體。

EVENT_PAYLOAD_LEN

【說明】

事件負載數據最大長度。

【定義】

#define EVENT_PAYLOAD_LEN (512)

【註意事項】

無。

【相關數據結構及介面】

無。

HI_EVTHUB_SUBSCRIBE_NAME_LEN

【說明】

訂閱者名稱的最大長度。

【定義】

#define HI_EVTHUB_SUBSCRIBE_NAME_LEN (16)

【註意事項】

無。

【相關數據類型及介面】

無

HI_EVTHUB_SUBSCRIBE_NAME_LEN

【說明】

訂閱者名稱的最大長度。

【定義】

#define HI_EVTHUB_SUBSCRIBE_NAME_LEN (16)

【註意事項】

無。

【相關數據類型及介面】

無

HI_EVTHUB_MESSAGEQURUR_MAX_SIZE

【說明】

消息隊列最大值。

【定義】

#define HI_EVTHUB_MESSAGEQURUR_MAX_SIZE (32)

【註意事項】

無。

【相關數據類型及介面】

無。

HI_EVTHUB_MESSAGEQURUR_MAX_SIZE

【說明】

消息隊列最大值。

【定義】

#define HI_EVTHUB_MESSAGEQURUR_MAX_SIZE (32)

【註意事項】

無。

【相關數據類型及介面】

無。

HI_EVENT_S

【說明】

定義事件結構體。

【定義】

typedef struct hiEVENT_S
{
    HI_EVENT_ID EventID;
    HI_S32 arg1;
    HI_S32 arg2;
    HI_S32 s32Result;
    HI_U64 u64CreateTime;
    HI_CHAR aszPayload[EVENT_PAYLOAD_LEN];
} HI_EVENT_S;

【成員】

成員名稱 描述
EventID 事件 ID
arg1 參數一
arg2 參數二
s32Result 處理結果
u64CreateTime 創建時間
aszPayload 負載數據

【註意事項】

創建時間在事件發佈時， 由模塊內部獲取系統 clock 時間填充， 單位秒/s。

【相關數據類型及介面】

無

HI_SUBSCRIBER_S

【說明】

定義訂閱者結構體。

【定義】

typedef struct hiSUBSCRIBER_S
{
    HI_CHAR azName[HI_EVTHUB_SUBSCRIBE_NAME_LEN];
    HI_S32 (*HI_EVTHUB_EVENTPROC_FN_PTR)(HI_EVENT_S* pEvent, HI_VOID* argv);
    HI_VOID* argv;
    HI_BOOL bSync;
}HI_SUBSCRIBER_S;

【成員】
成員名稱 | 描述
---|---
azName| 訂閱者名稱。
HI_EVTHUB_EVENTPROC_FN_PTR| 訂閱者事件處理函數。
argv| 用戶定義私有參數指針。
bSync| 事件處理是否同步。

【註意事項】

無。

【相關數據類型及介面】

無。

5 錯誤碼

事件路由模塊 API 錯誤碼如表 15-1 所示。

表15-1 事件路由 API 錯誤碼

錯誤代碼 巨集定義 描述
0xA1328002 HI_ERR_EVTHUB_NULL_PTR 空指針錯誤
0xA1328008 HI_ERR_EVTHUB_NOT_INIT 未初始化錯誤
0xA1328040 HI_ERR_EVTHUB_HANDLE_INVALID 非法句柄錯誤。
0xA1328041 HI_ERR_EVTHUB_INVALIDARG 非法參數
0xA1328042 HI_ERR_EVTHUB_MALLOC 記憶體申請錯誤
0xA1328043 HI_ERR_EVTHUB_CREATE 創建錯誤
0xA1328044 HI_ERR_EVTHUB_DESTROY 銷毀錯誤
0xA1328045 HI_ERR_EVTHUB_NOT_CREATE 對象沒有創建
0xA1328046 HI_ERR_EVTHUB_EVENT_NO_RIGEST 事件未註冊
0xA1328047 HI_ERR_EVTHUB_NO_EVENT_HISTORY 歷史事件不存在
0xA1328048 HI_ERR_EVTHUB_MSGHDL_SEND 事件路由消息發送錯誤

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Sqlserver 使用.net查詢被事務鎖住處理
    在有些應用場景中.事務開了後或能需要再去調用某個DAL讀取表中的數據.但DAL里又是新開的鏈接,由於外面有事務所以這裡讀的時候就讀不到.這種情況下可以在這個DAL的查詢里開一個新的事務級別設為允許臟讀即可(數據完整性要求不高時使用.如果要求高慎用!!!) ...
  • TreeViewItem節點添加圖標後再加header
    1.需要實現的效果如圖 2.解決方案 1）.給TreeViewItem中添加children,children為包含一個stackpanel,在stackpanel中包含Image和TextBlock兩個控制項。 ...
  • 深入C#並行編程（2） -- 使用線程
    一、可以使用位於命名空間System.Threading中的Thrad類開啟線程： 1.通過Thread類的靜態屬性CurrentThread可以獲取執行當前函數所在的線程，通過實例屬性ManagedThreadId可以查看當前線程的唯一標識符ID，通過實例屬性Name可以獲取或設置當前線程的名稱； ...
  • 【UWP】實現 FindAncestor 綁定
    在 WPF 里，我們是可以在 RelativeSource 上面實現的，舉個例子： 將 RelativeSource 的 Mode 設置為 FindAncestor 就可以了。AncestorType 代表綁定的類型，AncestorLevel 代表查詢第幾個，預設是 1。所以在上面的例子里，由於 ...
  • 用戶基本操作（三）
    [toc] 用戶身份切換 如何在普通用戶的情況下，完成日常工作？ 1） 切換用戶，使用普通用戶登錄，然後使用su命令切換到root。 優點：簡單，方便 缺點：需要知道root密碼,不安全，切換到root沒有日誌審計功能 2） 提權，當需要使用root許可權時，進行提權，而無需切換至root用戶。 優點 ...
  • linux免密登錄
    環境：centos7.4 1：在root目錄里ssh-keygen，使用簡易配置，全部直接回車即可。會在/root/.ssh/生成三個文件id_rsa id_rsa.pub known_hosts 2：複製其他節點的key到本地，只需要在一個當前生成key的節點執行即可：ssh-copy-id ro ...
  • WEB服務動靜結合
    基本介紹 1）WEB服務僅能處理靜態請求，如果處理動態請求則需要對應的動態資源服務軟體，即：應用程式服務軟體 2）常見的應用服務軟體有：PHP、Java、Python等 3）問題：WEB服務如何與外部應用程式通信？通常有以下幾種方案： - CGI協議：基本沒人使用，不安全以及性能極其低下 - 模塊方 ...
  • I/O模型
    I/O介紹 1）I/O（Input/Output），即輸入/輸出，分為IO設備和IO介面兩個部分 2）IO分類： • 網路IO：網路IO的本質是socket的讀取，socket在linux系統被抽象為流，IO可以理解為對流的操作 • 磁碟IO：文件的一次讀寫操作就會發生IO操作 3）IO操作類型： ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類