版本：1.7

框架集成

Spring Fory

spring-fory 为 Fory JSON 提供 Spring MVC 消息转换器、 Spring WebFlux 编解码器以及 Spring Boot 自动配置 starter。它支持常规 JSON 请求和响应体，并在 WebFlux 中支持流式 JSON 和 NDJSON。

请参阅项目的安装和使用指南，选择与 Spring 版本匹配的适配器或 starter，并配置应用。

Kotlin 集成

当框架在运行时提供 Kotlin KType，且回调无法使用 reified 类型参数时，请使用 jsonTypeRef<Any?>(kType)。传入的 KType 决定完整 JSON 类型，包括嵌套泛型参数和可空性。 Any? 只是回调中值的静态视图，不会将传入类型替换为动态 JSON Schema。

从 Kotlin 函数或 Java Method 获取 KType，需要应用添加 kotlin-reflect 依赖。其版本应与应用的 Kotlin 版本保持一致：

dependencies {
  implementation(kotlin("reflect"))
}

例如，发现并保留控制器方法的响应类型：

import java.io.OutputStream
import kotlin.reflect.jvm.kotlinFunction
import org.apache.fory.json.kotlin.ForyJsonKotlin
import org.apache.fory.json.kotlin.jsonTypeRef

data class Employee(val id: Long, val name: String)
data class Response<T>(val flag: Boolean, val data: T? = null, val msg: String? = null)

class EmployeeController {
  fun employees(): Response<List<Employee>> =
    Response(true, listOf(Employee(1, "Alice")))
}

val json = ForyJsonKotlin.builder().build()
val method = EmployeeController::class.java.getMethod("employees")
val responseType = jsonTypeRef<Any?>(requireNotNull(method.kotlinFunction).returnType)

fun writeResponse(value: Any?, output: OutputStream) {
  json.writeJsonTo(value, responseType, output)
}

fun readResponse(bytes: ByteArray): Any? = json.fromJson(bytes, responseType)

每个声明类型只需发现一次，并复用对应类型令牌。对于请求体，应获取对应 Kotlin 值参数的 KType。如果方法仍有未解析的类型参数，转换前必须提供具体类型实参；星投影和逆变投影仍不受支持。若选择了比 Any? 更具体的静态类型，调用方必须保证它与传入的 KType 一致。

在 Spring MVC 中，将请求或响应适配到转换器时，应保留控制器的 Kotlin 声明。 SmartHttpMessageConverter 可以通过应用提供的读写 hints 接收该 KType 或 Fory 类型令牌。如果存在 ResponseEntity<Response<List<Employee>>> 等 HTTP 包装类型，应先选取消息体类型 Response<List<Employee>>，再构造令牌。

只提供运行时对象的 AbstractHttpMessageConverter 回调会丢失泛型参数。 AbstractGenericHttpMessageConverter 能保留 Java 泛型，但 TypeRef.of(javaType) 无法恢复 Kotlin 可空性。单独使用 Java Type 或运行时值，都无法恢复完整 Kotlin 声明。应在获取该声明后使用 jsonTypeRef(kType)；此 API 不会自动安装 Spring 转换器。

Spring Fory​

Kotlin 集成​

Spring Fory

Kotlin 集成