Kotlinx.Serialization实现JSON多形态数据解析方案

在实际JSON数据处理中，我们经常会遇到同一个数据结构存在多种JSON表示形式的情况。本文将以Kotlinx.Serialization库为例，深入讲解如何处理一个包含列表的对象在JSON中可能出现的两种不同形态。

场景分析

假设我们需要处理一个包含BBB对象列表的AAA类，其JSON可能呈现两种形式：

1. 标准对象形式：{"data":[{"id":"aaa","name":"aaa"},{"id":"bbb","name":"bbb"}]}
2. 简化数组形式：[{"id":"aaa","name":"aaa"},{"id":"bbb","name":"bbb"}]

基础数据模型定义

首先定义基础数据类结构：

@Serializable
data class AAA(
    @SerialName("data")
    val data: List<BBB> = emptyList()
)

@Serializable
data class BBB(
    @SerialName("id")
    val id: String = "",
    @SerialName("name")
    val name: String = ""
)

自定义序列化方案

要实现两种JSON形式的兼容解析，我们需要自定义序列化器。Kotlinx.Serialization提供了JsonTransformingSerializer来实现这种转换需求：

@Serializable(with = AAASerializer::class)
data class AAA(
    val data: List<BBB> = emptyList()
)

object AAASerializer : JsonTransformingSerializer<AAA>(AAA.serializer()) {
    override fun transformDeserialize(element: JsonElement): JsonElement {
        return when (element) {
            is JsonArray -> buildJsonObject { put("data", element) }
            else -> element
        }
    }
}

关键点解析

1. 注解使用：@Serializable(with = AAASerializer::class)告诉框架使用自定义序列化器
2. 转换逻辑：当输入是JsonArray时，自动包装成包含"data"字段的对象
3. 兼容处理：非数组输入直接透传，保持原有解析逻辑

进阶优化

对于更复杂的场景，可以考虑：

1. 添加序列化时的转换逻辑
2. 处理可能的异常情况
3. 增加日志输出便于调试
4. 考虑性能优化，避免不必要的转换

总结

通过自定义JsonTransformingSerializer，我们实现了灵活处理不同JSON形态的需求。这种方案不仅适用于当前场景，也可以推广到其他需要兼容多种JSON格式的情况。Kotlinx.Serialization的强大扩展能力让我们可以轻松应对各种复杂的数据解析需求。