如何在 JSON 序列化中避免顶层方括号（[]）而保持对象列表的灵活构建-java教程-PHP中文网

如何在 JSON 序列化中避免顶层方括号（[]）而保持对象列表的灵活构建

当使用 Jackson 将多个对象序列化为 JSON 字符串时，若直接序列化 List，结果会自动包裹方括号形成 JSON 数组；要输出无顶层数组、仅由逗号分隔的 JSON 对象序列（如用于拼接查询参数），需通过封装容器类绕过默认集合序列化行为。

当使用 jackson 将多个对象序列化为 json 字符串时，若直接序列化 `list`，结果会自动包裹方括号形成 json 数组；要输出无顶层数组、仅由逗号分隔的 json 对象序列（如用于拼接查询参数），需通过封装容器类绕过默认集合序列化行为。

在实际开发中（尤其是构造 REST API 查询参数或批量消息体时），我们常需要将多个结构化对象拼接成一串以英文逗号分隔的 JSON 对象序列，例如：

{"items":[{"itemsCode":"item1","isAvailable":false}],"isActive":false},{"items":[{"entryCode":"item2","isSelected":true}],"isActive":false}

⚠️ 注意：这不是标准 JSON 数组（不以 [...] 包裹），因此不能直接对 List<items></items> 调用 ObjectMapper.writeValueAsString() —— Jackson 会严格遵循 JSON 规范，将 List 序列化为数组，必然产生外层 []。

✅ 正确解法：引入容器类 + 自定义序列化逻辑

Jackson 默认无法“取消”集合的数组语义，但我们可以不序列化 List 本身，而是将其作为字段嵌入一个 POJO 容器中，再按需提取其 JSON 表示——但注意：本例目标并非生成合法 JSON 文档，而是生成可拼接的 JSON 片段字符串。因此更推荐以下两种专业方案：

方案一：手动拼接（推荐用于查询参数场景）

适用于生成非标准 JSON 片段（如 URL 查询值、日志拼接等），简洁可控：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

ObjectMapper mapper = new ObjectMapper();
List<items> itemsList = new ArrayList();

// 在 for 循环中构建并添加
for (/* your data source */) {
    List<item> itemEntries = buildItemEntries(...);
    Boolean isActive = computeIsActive(...);
    itemsList.add(new Items(itemEntries, isActive));
}

// 将每个对象单独序列化，再用逗号连接
String result = itemsList.stream()
    .map(item -> {
        try {
            return mapper.writeValueAsString(item);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("JSON serialization failed", e);
        }
    })
    .collect(Collectors.joining(","));
// 输出：{"items":[...],"isActive":false},{"items":[...],"isActive":false}</item></items>

✅ 优势：无需修改 POJO 结构，语义清晰，完全符合需求；
❌ 注意：确保 Items 类字段命名与 JSON 键一致（建议启用 @JsonProperty 或配置 mapper.enable(SerializationFeature.WRITE_ENUMS_USING_TO_STRING) 等增强可读性）。

方案二：使用 `JsonGenerator` 流式写入（高性能进阶）

适合大数据量、低内存开销场景：

ObjectMapper mapper = new ObjectMapper();
StringWriter writer = new StringWriter();
JsonGenerator gen = mapper.getFactory().createGenerator(writer);

gen.writeStartArray(); // 可选：若仍需数组语义
for (Items item : itemsList) {
    mapper.writeValue(gen, item); // 每次写入一个完整 JSON 对象
}
gen.writeEndArray();
gen.close();

// 若需去除外层 []，取 substring：
String rawJsonObjects = writer.toString().substring(1, writer.toString().length() - 1);

⚠️ 风险提示：手动裁剪 JSON 字符串存在安全隐患（如嵌套数组/对象含 ] 会导致截断错误），不推荐用于不可信数据源。

? 总结与最佳实践

不要试图让 List<t></t> 直接序列化为无 [] 的字符串 —— 这违背 JSON 规范，Jackson 不支持也不应支持；
明确使用场景：若用于 HTTP 查询参数（如 ?data={...},{...}），方案一（流式 map + join）最安全可靠；
POJO 建议优化：为避免字段名混淆（如 isBoolean → isActive），应在 Items 类中使用语义化命名并配合 @JsonProperty 注解；
编码健壮性：始终捕获 JsonProcessingException，并在循环中避免重复创建 ObjectMapper（它是线程安全且开销较大，应复用单例实例）。