Android - Moshi中的多种响应类型

Moshi 是 Square 公司推出的一个现代的 JSON 库，用于 Android 和 Java 中的 JSON 解析。它比 Gson 更加简洁，并且提供了 Kotlin 支持。在处理 API 响应时，经常会遇到需要解析多种不同类型的数据结构的情况。以下是一些基础概念以及如何使用 Moshi 处理多种响应类型的详细解答。

基础概念

1. Polymorphic Json Deserialization（多态 JSON 反序列化） 这是指在反序列化 JSON 数据时，能够根据数据中的某些字段来确定具体的对象类型。例如，一个 API 可能返回两种不同的用户类型，每种类型都有不同的字段。

2. Type Adapter（类型适配器） Moshi 使用类型适配器来指导如何将 JSON 数据转换为 Java/Kotlin 对象，以及如何将对象转换回 JSON。

类型与应用场景

1. 使用 @JsonClass(generateAdapter = true) 对于简单的数据类，可以使用这个注解来自动生成适配器。

@JsonClass(generateAdapter = true)
data class User(val name: String, val age: Int)

2. 自定义类型适配器 当需要处理更复杂的逻辑或多个可能的类型时，可以创建自定义的类型适配器。

应用场景

当 API 返回的数据结构可能有多种格式时。
当需要根据 JSON 中的某个字段来决定实例化哪个类时。

示例代码

假设我们有一个 API，它可能返回 Admin 或 RegularUser 类型的用户。

sealed class UserType {
    data class Admin(val name: String, val permissions: List<String>) : UserType()
    data class RegularUser(val name: String, val email: String) : UserType()
}

class UserTypeAdapter {
    @FromJson
    fun fromJson(json: String): UserType {
        val moshi = Moshi.Builder().build()
        val delegate = moshi.adapter(UserType::class.java)
        return delegate.fromJson(json)
    }

    @ToJson
    fun toJson(userType: UserType): String {
        val moshi = Moshi.Builder().build()
        val delegate = moshi.adapter(UserType::class.java)
        return delegate.toJson(userType)
    }
}