Kotlin 序列化：Kotlinx Serialization 反射无依赖实践

// 源代码
@Serializable
data class User(
    val id: Long,
    val name: String,
    val email: String
)

// 编译后生成的 Serializer（伪代码）
object User$$serializer : KSerializer<User> {
    override val descriptor = SerialDescriptor.build(
        "User",
        PrimitiveKind.LONG,
        PrimitiveKind.STRING,
        PrimitiveKind.STRING
    )

    override fun serialize(encoder: Encoder, value: User) {
        val output = encoder.beginStructure(descriptor)
        output.encodeLongElement(descriptor, 0, value.id)
        output.encodeStringElement(descriptor, 1, value.name)
        output.encodeStringElement(descriptor, 2, value.email)
        output.endStructure(descriptor)
    }

    override fun deserialize(decoder: Decoder): User {
        // 类似实现，调用 decodeLongElement 等
    }
}

// Json.encodeToString() 内部调用链
Json.encodeToString(serializer, value)
  → AbstractEncoder.encodeValue(value)
    → User$$serializer.serialize(encoder, value)
      → encoder.beginStructure(descriptor)
        → JsonEncoder.beginStructure()
          → JsonWriter.writeBeginObject()
            → StringBuilder.append("{")
      → encodeStringElement() / encodeLongElement()
        → write member by member
      → endStructure()
        → writeEndObject()

// 全程无反射，方法调用全在编译时确定

// build.gradle.kts - JS IR 配置
kotlin {
    js(IR) {
        browser { }
        nodejs { }
        binaries.executable()
    }
    // 启用 serialization plugin
    pluginOptions {
        add("org.jetbrains.kotlin.plugin.serialization")
    }
}

// JS 端执行序列化
// import kotlinx.serialization.json.json.encodeToString
val jsonString = Json.encodeToString(User.serializer(), user)

// 编译后输出纯 JS 代码，无 Kotlin runtime 序列化逻辑

// kotlin.metadata.annotation 标注的 @Serializable 类
// 在 WASM 编译时生成等价的 WASM bytecode
// 避免了 JS 的 JSON.parse/stringify 开销

// Kotlin/WASM 当前状态
// - Kotlin 1.9+ 实验性支持
// - Serialization 1.6+ 支持
// - 性能优于 JS/IR 目标

// Gson: 反射获取字段 → 创建 Java bean wrapper → 递归处理
// 每个字段: getDeclaredFields() → AccessibleObject.setAccessible()
// 开销: ~300 bytes per object

// Moshi: 代码生成后反射减少，但仍需要 ReflectiveCache
// 每个类型: JsonAdapter.lookup() → adapter.serialize()
// 开销: ~180 bytes per object

// Kotlinx: 编译器生成静态调用，无反射开销
// User$$serializer.serialize() 直接调用 encodeLongElement()
// 开销: ~40 bytes per object (主要是 StringBuilder 扩容)

// 1. 添加依赖
// build.gradle.kts
plugins {
    "org.jetbrains.kotlin.plugin.serialization" version "1.9.22"
}
dependencies {
    "org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.2"
}

// 2. 注解迁移
// Gson: @SerializedName("field_name")
// Serialization: @SerialName("field_name")
@Serializable
@SerialName("user_id")
data class User(val id: Long)

// 3. Spring Boot 配置替换
// Gson: @Bean fun Gson(): Gson { ... }
// Serialization: ContentNegotiationConfigurer
// spring.codec.json-visualization-library 需要配置