C語言應用服務器內部數據結構（二）：XML 配置與核心接口實現

XML 配置規範

類型系統擴展

• type="common"：單值字段，同前文。
• type="list"：數組/列表字段。
   size：元素個數上限。
   ref：引用 ListDataDef 定義元素結構。

二級映射機制

1. 一級映射：key → {offset, type, listMeta}。
2. 遇 type="list"，取 ref 查二級映射表（ListDataDef 同構）。
3. 元素大小 = 二級映射總長度（含對齊）。
    列表總長 = size * 元素大小。
4. 訪問時：基址 + 列表offset + index * 元素大小 + 字段offset。

列表專用接口

// 獲取列表上下文（含基址、二級映射指針、size等）
int getDataList(const void* addr, const char* key, struct DataList* outList);

// 列表內元素字段讀寫
int getDataInList(const void* addr, const DataList* list, int idx,
                  const char* fieldKey, int bufLen, char* value);
int putDataInList(void* addr, const DataList* list, int idx,
                  const char* fieldKey, const char* value);

DataList 結構體封裝：baseOffset, elementSize, count, subMap*。

內存佈局示例（續前文）

cardNo     [19] @ 0
amount     [13] @ 20
tradeDate  [8]  @ 36
tradeTime  [6]  @ 48
listData   [3 * 48 = 144] @ 52  (假設對齊後 myListData 元素=48)
  ├─[0] listData1[19] listData2[13] listData3[8] listData4[6]
  ├─[1] ...
  └─[2] ...
總大小 = 52 + 144 = 196 字節

工程落地要點

1. 配置解析器：用 libxml2/expat/tinyxml 解析 XML，構建映射表結構體數組。
2. 查找優化：一級/二級 Key 數組啟動後排序，運行期二分查找 O(log n)。
3. 邊界檢查：idx >= size、fieldKey 不存在、長度超限 統一返回錯誤碼。
4. 版本兼容：配置文件加 version 屬性，啟動時校驗；新字段默認值 0/空串，舊數據自動兼容。

效果驗證

• 單次交易上下文 200 字節，10 萬並發僅佔 20 MB 共享內存。
• 字段讀寫延遲 < 50 ns（單純 memcpy + 索引計算）。
• 新增字段只需熱更 XML + 重啟 Worker 進程，業務代碼零修改。