2024-11-22 stan

交易系统命令处理分析笔记

一、余额查询命令(CMD_BALANCE_QUERY)

1. 业务逻辑流程

1. 参数校验:
   • 检查参数数组不为空
   • 验证user_id参数(必须为整数且>0)
   • 验证可选的资产列表参数
2. 查询处理:
   • 场景1: 只有user_id - 查询所有资产
   • 场景2: 指定资产列表 - 只查询指定资产
3. 返回数据组装:
   • 每个资产包含available和freeze两个余额
   • 考虑精度转换(prec_save和prec_show)
   • JSON格式封装

2. 数据结构和依赖

1. 核心数据结构:

struct balance_key {
    uint32_t    user_id;
    uint32_t    type;
    char        asset[ASSET_NAME_MAX_LEN + 1];
};

1. 主要依赖函数:
   • balance_get(): 查询余额
   • asset_exist(): 验证资产
   • asset_prec()/asset_prec_show(): 获取精度

3. 算法实现和性能

1. 时间复杂度:
   • O(n), n为查询的资产数量
   • 单个资产查询O(1)(哈希表实现)
2. 空间复杂度:
   • O(n), n为返回的资产数量
3. 性能优化:
   • 使用哈希表存储余额
   • 实现余额缓存
   • 支持批量查询

4. 调用场景

1. 直接调用:

    case CMD_BALANCE_QUERY:
        log_trace("from: %s cmd balance query, sequence: %u params: %s", nw_sock_human_addr(&ses->peer_addr), pkg->sequence, params_str);
        ret = on_cmd_balance_query(ses, pkg, params);
        if (ret < 0) {
            log_error("on_cmd_balance_query %s fail: %d", params_str, ret);
        }
        break;

1. 使用限制:
   • 无需检查系统状态
   • 只读操作,并发安全

二、订单取消命令(CMD_ORDER_CANCEL)