C語言應用服務器內部數據結構（三）：列表支持與完整體系總結

列表類型設計回顧

為滿足查詢類業務「返回多筆同結構記錄」需求，引入 type="list"：

完整接口族

// 基礎標量
int getDataStr(const void* addr, const char* key, int bufLen, char* val);
int putDataStr(void* addr, const char* key, const char* val);
int getDataInt(...); int putDataInt(...);
int getDataDouble(...); int putDataDouble(...);

// 列表
int getDataList(const void* addr, const char* key, DataList* list);
int getDataInList(const void* addr, const DataList* list, int idx,
                  const char* fieldKey, int bufLen, char* val);
int putDataInList(void* addr, const DataList* list, int idx,
                  const char* fieldKey, const char* val);

DataList 結構體定義

typedef struct {
    const void* baseAddr;      // 數據塊基址
    size_t listOffset;         // 列表在塊內偏移
    size_t elementSize;        // 單元素大小（含對齊）
    int maxCount;              // 配置 size
    const FieldMap* subMap;    // 二級映射表指針
    int subMapCount;           // 二級字段數
} DataList;

訪問流程圖解

getDataInList(addr, list, 2, "name", ...)
   │
   ├─ 1. 計算元素基址 = addr + list.listOffset + 2 * list.elementSize
   │
   ├─ 2. 在 list.subMap 中二分查找 "name" → 得到 fieldOffset, fieldLen
   │
   └─ 3. memcpy(dst, 元素基址 + fieldOffset, min(bufLen, fieldLen))

完整體系能力矩陣

適用場景與不適用場景

• ✅ 高性能交易網關、支付核心、實時風控：固定結構、極致延遲、共享內存多進程。
• ✅ 協議解析/組裝層：報文字段與內部字段一對一映射，零拷貝轉換。
• ❌ 文檔型數據、動態屬性、用戶自定義字段：需真正的動態 Map/JSON 庫。
• ❌ 複雜對象圖、遞歸結構：需序列化框架（Protobuf/FlatBuffers/Cap'n Proto）。

系列總結

三篇文章構建了「配置驅動 → 靜態佈局 → 類 Map 接口 → 列表擴展」完整體系。核心價值：
🎯 開發期靈活：改 XML 不改代碼
🎯 運行期高效：零分配、零虛函數、緩存友好
🎯 部署期簡單：單二進制 + XML，熱更配置即可
這是在 C 語言約束下，用「約定優於配置、靜態優於動態」思想實現的工程最優解。