萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C++ 封裝 MySQL API 實戰:模塊化設計、SQL 拼裝器與現代 C++ 技巧

每個與 MySQL 打交道的 C++ 開發者都曾想封裝一套好用的庫。本文分享一個遵循簡單、低學習成本、模塊化、大量使用 STL/模板四大原則的封裝實踐,包含 MySQL 客戶端封裝與 SQL 拼裝器兩大獨立模塊。

設計原則回顧

  1. 簡單:不為微小效率犧牲接口清晰度,拒絕過度優化。
  2. 低學習成本:採用 SQL 拼接器而非 ORM,習慣寫原生 SQL 的開發者零門檻上手。
  3. 模塊化:客戶端封裝與 SQL 拼裝器完全解耦,可單獨使用或任意組合。
  4. STL + 模板 + stringstream:類型轉換統一走流,消除大量重複代碼。

模塊一:MySQL 客戶端封裝 (CMYSQLWrapper)

核心接口

class CMYSQLWrapper {
public:
    // 連接(支持自動重連)
    int Open(const char* ip, const char* user, const char* pwd, const char* db);
    void Close();

    // 執行 SQL(多態重載)
    int Query(const char* sql);                                    // 通用執行
    int Query(const char* sql, vector>& vecData); // SELECT 映射到 vector
    int Query(const char* sql, int& affectRows);                   // INSERT/UPDATE/DELETE 返回影響行數

    // 結果集手動管理
    int Result(MYSQL_RES*& result);
    int AffectedRows();

    // 字符串轉義
    string EscStr(const char* src, uint32_t len);
    string EscStr(const char* src);

    // 錯誤信息
    const char* GetErrMsg();
};

關鍵實現細節

  • 自動重連:mysql_options(&mysql, MYSQL_OPT_RECONNECT, &true_val)。
  • 結果集映射:vector> 逐行逐列提取,MYSQLValue 內部用 stringstream 統一轉 string,調用者再按需轉型。
  • Blob 處理:EscStr 專門處理二進制數據轉義。
  • RAII 輔助類:StMYSQLRes 析構時自動 mysql_free_result,防泄漏。

模塊二:SQL 拼裝器 (SQLJoin)

設計目標

用流式 API 構建 SQL,避免手工拼接字符串的錯誤、注入風險、可讀性差。

使用示例

SQLJoin sql;
sql << "SELECT * FROM users WHERE id = " << user_id
    << " AND name = " << name
    << " AND age > " << min_age;
string final_sql = sql.str();  // 自動處理轉義、引號、NULL

核心機制

  • 重載 operator<< 接受任意類型(內建類型、string、自定義類型),內部走 ostringstream。
  • 針對 string 自動添加單引號並轉義;NULL 關鍵字特殊處理。
  • 支持 IN (?, ?, ...) 批量參數展開。

編譯與依賴

  • 依賴 MySQL C API (libmysqlclient)。
  • CMake 建議:find_package(MySQL REQUIRED),鏈接 ${MYSQL_LIBRARIES}。
  • C++11 或以上(需 auto、unordered_map、initializer_list 等特性)。

總結

這套封裝在多個項目中穩定運行,證明了「不造輪子、造好輪子」的價值:把 C API 的繁瑣封裝起來,把 SQL 的靈活還給開發者,才是 C++ 數據庫訪問層的甜蜜點。

copyright © 萬盛學電腦網 all rights reserved