http-kit客户端参数编码优化：支持嵌套表单和查询参数

背景介绍

http-kit是一个高性能的Clojure HTTP客户端和服务器库。在最新版本中，开发团队对其客户端参数编码功能进行了重要增强，特别是针对嵌套表单和查询参数的处理方式。

原有问题分析

在之前的版本中，http-kit处理嵌套参数时存在以下局限性：

1. 对于嵌套映射结构，会生成带方括号的键路径
2. 对于向量结构，会采用简单的重复参数名方式
3. 不支持多种编码风格选项

这种处理方式与一些API服务(如Stripe)的预期格式不兼容，导致开发者需要自行预处理参数或寻找替代方案。

解决方案实现

新版本引入了:nested-param-style选项，支持四种编码风格：

1. 默认风格：{:a [1 2 3]} → "a=1&a=2&a=3"
2. 数组风格：{:a [1 2 3]} → "a[]=1&a[]=2&a[]=3"
3. 索引风格：{:a [1 2 3]} → "a[0]=1&a[1]=2&a[2]=3"
4. 逗号分隔风格：{:a [1 2 3]} → "a=1,2,3"

技术实现细节

核心实现基于Clojure的walk/prewalk函数，对参数结构进行递归处理。关键改进包括：

1. 新增name*辅助函数，智能处理不同类型的键名
2. 扩展对向量结构的支持，正确处理索引
3. 重构参数展平逻辑，保持原有功能同时增加灵活性

使用示例

(require '[org.httpkit.client :as http])

;; 使用索引风格编码嵌套参数
(http/post "https://api.example.com" 
  {:form-params {:items [{:name "A" :qty 1} {:name "B" :qty 2}]}
   :nested-param-style :indexed})

兼容性考虑

新版本完全向后兼容：

1. 默认行为保持不变
2. 新增选项不会影响现有代码
3. 开发者可以逐步迁移到新风格

总结

http-kit的这一改进使其参数编码能力达到了与clj-http相当的水平，同时保持了自身的高性能特性。开发者现在可以更灵活地处理复杂API请求，特别是需要特定参数格式的服务集成场景。