用C++實現插件模式時的避坑要點

来源:https://www.cnblogs.com/logischerweise/archive/2022/08/03/16538530.html
-Advertisement-
Play Games

1. 登錄用戶數據獲取 登錄成功之後,在後續的業務邏輯中,開發者可能還需要獲取登錄成功的用戶對象,如果不使用任何安全管理框架,那麼可以將用戶信息保存在HttpSession中,以後需要的時候直接從HttpSession中獲取數據。在Spring Security中,用戶登錄信息本質上還是保存在 Ht ...


本文不打算嚴格地、用標準術語來講前因後果。本文主要分析實踐中常見的、因為對原理不清楚而搞出來的產品里的坑。

什麼是插件模式和為什麼要用插件模式

插件,Plug-In,或者(IE/Edge稱之為)載入項/Add-On,(Office稱之為)外接程式/Add-In,(GIMP稱之為)擴展/Extension,等等,總之看字面意思都是“額外增加功能”的這種東西,是一類開發模式。基本思路就是,研發軟體本體的時候,外部需求不明確、直到使用期仍然經常會增加功能細節。為了把變動部分切割開,在設計的時候,通過對可變部分的歸納分析,對可變部分抽象出一套介面;每套外部需求用動態庫之類的形式實現介面;軟體本體按某種約定,載入動態庫,並從中獲取插件實例,通過介面來調用滿足當時需求的功能實現。

可以看到,插件的思想,其實就是靈活運用“動態庫”的動態載入能力,把對“介面”的實現移到軟體本體之外,並用工廠模式來約束動態庫的實現方式。

只要是具有動態載入能力的運行環境上,都可以使用插件模式來設計軟體系統。極端一些的軟體系統,甚至只提供基礎平臺,所有功能都由插件的方式提供,例如 Visual Studio Code 、 Eclipse 等。

C++實現插件模式

用C++實現插件模式,一般是把下麵這些功能組合起來:

  • 用一個C++的帶虛函數的基類來表示功能
  • 約定動態庫里的工廠模式介面
  • 在一些動態庫里提供實現虛函數的派生類
  • 在動態庫里實現工廠模式

不幸的是,由於各操作系統的動態庫機制普遍是C風格的,用C++做動態庫時候的坑,在用C++實現插件模式時,全都會遇到。比如:

  • C++的編譯器差異導致的不互通
    會導致必須用同一種(或相容的)編譯器來生成插件和軟體本體。
    • 名字改寫(Name Mangling):參考:WikipediaHappenLee的解說
      會導致載入插件時“找不到符號”
    • 虛函數(表)實現:
      會導致載入插件時可能不報錯,但運行時候找不到正確的虛函數入口
  • 操作系統機制導致的不互通
    • Windows上使用MSVCRT時的記憶體分配和回收
      Windows每個模塊的記憶體分配預設是在模塊自己的堆里的,而Windows上的C運行時庫(各種MSVCRT)為了封裝出 mallocfree 等C函數的效果,建立了__crtheap(2010及之前版本行為)或直接使用進程預設堆(2015及之後版本行為)[1]。這導致,即使是同一個編譯器,靜態鏈接VC運行時會採用本模塊內部的堆來實現 malloc 等,而動態鏈接VC運行時則會採用MSVCRT動態庫DLL的模塊堆。需要解決好“誰申請誰釋放”的問題,否則記憶體管理的地方容易出異常。
    • 全局變數在模塊間的共用問題

一些典型的不良實現

這裡說的不良實現,使用時候未必會錯或崩,但早晚要崩,或者會限制住插件的開發。以下用如下插件介面作為例子。

// IFilter.h

/// 濾波器介面.
class IFilter {
protected:
    IFilter();
public:
    virtual ~IFilter();
public:
    /// 一個將輸入複數數組處理為輸出複數數組的函數.
    virtual void Filter(const std::complex<double>* acdIn, std::complex<double>* acdOut, size_t uLen) = 0;
    /// 獲取當前實現的一些描述字元串.
    virtual std::string GetDescription() const = 0;
};
// IFilter.cpp
IFilter::IFilter() { }
IFilter::~IFilter() { }

並約定插件實現中以如下形式提供工廠函數。

// FilterPluginDll.h
#include "IFilter.h"
/* 插件DLL應該提供如下函數 
extern "C" int GetFilterPluginInDll(char* szFilterNamesBuf, size_t uBufLen);
extern "C" IFilter* BuildFilterPlugin(const char* szFilterName);
extern "C" void FreeFilterPlugin(IFilter* pFilter);
*/
typedef int (*PFNGetFilterPluginInDll)(char* szFilterNamesBuf, size_t uBufLen);
typedef IFilter* (*PFNBuildFilterPlugin)(const char* szFilterName);
typedef void (*PFNFreeFilterPlugin)(IFilter* pFilter);

介面類沒有提供二進位實現

比如,對插件只發佈兩個頭文件;認為 IFilter 的構造和析構反正是空函數無所謂,直接寫在類定義里。

這樣,插件開發者自己生成插件DLL時,會在自己的DLL里鏈接進一份 IFilter::IFilter()IFilter::~IFilter() 的實現,而軟體本體里也有一份自己的實現。雖然看上去,如果編譯器一樣,兩份實現是等同的,但考慮到它們使用了不同的模塊堆,以及其它各種原因,插件DLL中的 IFilter 和軟體本體里的 IFilter 並不是完全等同的。

這裡應該由軟體本體導出 IFilter::IFitler()IFilter::~IFilter() 等介面類的共性成分的實現給插件,以免出現一些奇怪的問題。

工廠函數里沒有正確設計“誰分配誰釋放”

比如,為了“簡單”,只要求了 BuildFilterPlugin 工廠函數,認為可以由軟體本體用 delete pFilter; 來釋放插件實例。

一種建議的實現方法

用類似於Windows的COM風格的“放了一堆函數指針的結構體”來表示插件的介面定義;軟體本體里為了使用方便,再用介面類包裝一下。

參考文獻

  1. 一個程式員的修煉之路. 談一談Windows中的堆 [EB/OL]. https://blog.csdn.net/CJF_iceKing/article/details/119083770

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

-Advertisement-
Play Games
更多相關文章
  • 如今短視頻已成為人們娛樂社交的主要形式,很多用戶也開始由觀眾逐漸轉變為短視頻製作傳播者,然而複雜的視頻剪輯工具卻令他們望而止步。如何才能降低短視頻製作剪輯門檻,讓更多無經驗者也能製作出優質的短視頻內容,並樂於分享生活趣事呢? 華為HMS Core視頻編輯服務6.6.0版本近期上線AI精彩片段能力,能 ...
  • Date日期 日期對象的定義(使用new關鍵詞) 1.獲取當前的時間(本地的時間) var date = new Date() //不傳參就是獲取當前時間 2.獲取指定的時間 var date = new Date(123456) //一個參數毫秒值 將這個毫秒值去加上對應的1970.1.1 0:0 ...
  • 今天在做css定位的時候遇到一個問題,我想用fixed定位下來,但是發現這個時候定義的百分百寬度不隨著父元素走了而是整個屏幕的百分百,這個就很尷尬了,也不能固定寬度吧,畢竟還要寬度自適應。 這個時候發現了一個position的屬性 sticky 它是relative和fixed的結合體可以理解為,當 ...
  • 最近,在對公司的一個老項目進行優化調整。有個使用的三方插件報表頁面,一旦查詢時間過長就會自動異常並使瀏覽器崩潰,由於這個插件只有個前人遺留的dll文件,實在看不懂裡面的代碼無從下手,既然項目前端大部分是基於EasyUI做的,想著就直接用EasyUI的DataGrid做數據報表明細展示。 由於之前很少 ...
  • 網頁是一個頁面,網站是由多個網頁組成的! 我們在使用代碼編寫的時候能看到這樣的東西,具體內容如下,比較基礎: 認識SEO? SEO就是搜索引擎優化,作用就是你找查找相關內容時,能夠優先給你展示這個內容。 SEO三大標簽(一般由想乾人員提供): title(網頁標簽)、description(網頁描述 ...
  • 項目背景 我們的系統(一個 ToB 的 Web 單頁應用)前端單頁應用經過多年的迭代,目前已經累積有大幾十萬行的業務代碼,30+ 路由模塊,整體的代碼量和複雜度還是比較高的。 項目整體是基於 Vue + TypeScirpt,而構建工具,由於最早項目是經由 vue-cli 初始化而來,所以自然而然使 ...
  • 什麼時候精靈圖呢? 通常在渲染頁面的時候,需要伺服器向我們發送數據,但有的時候一個頁面需要多張圖時,伺服器就會處於連續發圖的工作狀態,但如果我們把需要的圖都放在一張圖上,這樣可以大大的減少服務的工作負擔,打個比喻。伺服器發一張圖是,工作流程是:找到圖片——讀取圖片——發送圖片,如果是發送5個圖片時, ...
  • 蒼穹之邊,浩瀚之摯,眰恦之美; 悟心悟性,善始善終,惟善惟道! —— 朝槿《朝槿兮年說》 寫在開頭 我們都知道,經過多年的發展和無數Java開發者的不懈努力,Java已經由一門單純的電腦編程語言,逐漸演變成一套強大的以及仍在可持續發展中的技術體系平臺。 雖然,Java設計者們根據不同的技術規範,把 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 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 ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...