如何在BaseX XQuery中基于XML数据构造并发送JSON HTTP请求

你此前关于http:send-request仅支持XML格式请求体的认知，是被文档中占比极高的XML场景示例误导形成的偏差，完全可以直接在XQuery层基于BaseX存储的XML数据构造并发送合法JSON格式的HTTP请求，不需要将发布逻辑迁移到Node层造成冗余开销。

核心实现逻辑 #

认知纠偏 #

• BaseX内置HTTP模块的http:send-request函数，请求体字段并非仅支持XML元素，实际可传入任意类型的序列化字符串；官方示例长期以XML接口调用场景为主，未单独标注纯文本/JSON请求的用法，因此容易造成“仅支持XML传参”的误解。
• BaseX的JSON模块具备完整的结构映射、序列化能力，可实现从XML节点到合法JSON结构的无误差转换，不需要手动拼接字符串规避格式错误。

可直接落地的实现步骤 #

1. 构造可映射为JSON的内存结构
   基于BaseX内置的map、array类型，关联从数据库取出的XML节点数据，直接构造目标API需要的JSON结构，不需要在其他层做重复数据映射：

   (: 示例：从BaseX库取出已审核的公共记录，构造JSON对应的map结构 :)
   let $source-record := db:open("public-data")//sustain-record[@status="approved"]
   let $json-structure := map {
     "recordId": $source-record/@record-id/data(),
     "recordTitle": $source-record/title/text(),
     "publishTags": array {
       $source-record/tags/tag/text()
     },
     "submitTime": current-dateTime()
   }
   

2. 序列化为合法JSON文本
   调用BaseX内置的json:serialize方法，将上述内存结构转为符合JSON语法规范的纯文本字符串，由序列化器自动处理所有特殊字符的转义逻辑：

   let $json-payload := json:serialize($json-structure, map {
     "method": "json",
     "indent": false()
   })
   

3. 组装HTTP请求完成调用
   在http:send-request的配置项中，明确指定JSON格式对应的请求头，将序列化完成的JSON字符串作为请求体传入，和原有XML请求的调用方式保持一致：

   let $response := http:send-request(
     $target-url = "https://your-public-hub/publish-endpoint",
     $url-params = (),
     $request-config = map {
       "method": "POST",
       "headers": map {
         "Content-Type": "application/json",
         "Accept": "application/json"
       },
       "body": $json-payload
     }
   )
   return $response
   

高频踩坑提醒 #

• 不要手动拼接JSON字符串：直接用文本拼接的方式生成JSON内容，遇到引号、换行、特殊符号时极易出现转义错误，必须依赖json:serialize完成格式转换。
• 不要跳过序列化步骤直接传map结构：如果把构造好的map结构直接放到body字段，系统会默认按照XML序列化规则将其转为带XML标签的文本，服务端将无法识别为合法JSON内容。
• 不需要调整原有数据链路：所有取数、结构转换、请求发送的逻辑都可以在现有XQuery执行链路中完成，和原有的XML格式请求执行效率没有差异，不会产生跨层调用的冗余开销。

内容的提问来源于stack exchange，提问作者RdNetwork