首页
/ Retrofit 2.12.0 版本发布:流式序列化与性能优化

Retrofit 2.12.0 版本发布:流式序列化与性能优化

2025-05-31 00:39:28作者:冯爽妲Honey

项目简介

Retrofit 是 Square 公司开发的一款广受欢迎的 Android 和 Java 类型安全的 HTTP 客户端库。它通过将 HTTP API 转换为 Java 接口的方式,简化了网络请求的处理流程,让开发者能够以声明式的方式定义 API 请求,而无需关心底层的网络通信细节。

版本亮点

Retrofit 2.12.0 版本带来了一个重要的新特性:流式序列化支持。这一改进显著提升了 Retrofit 在处理大型请求体时的性能和资源利用率。

流式序列化特性详解

在之前的版本中,Retrofit 的转换器(Converters)会在创建 HTTP 请求时就完成请求体的序列化工作。这意味着:

  1. 序列化操作会在调用线程上同步执行
  2. 即使使用异步调用(如 Call.enqueue),序列化仍然在调用线程完成
  3. 对于大型对象,这可能导致主线程卡顿或内存压力

2.12.0 版本引入了流式序列化功能,允许将序列化过程推迟到 HTTP 请求体实际写入时进行。这一改变带来了以下优势:

  • 后台线程执行:当使用 Call.enqueue 时,序列化操作会自动转移到后台线程
  • 内存效率:减少了内存峰值使用量,特别是处理大型请求体时
  • 响应速度:主线程不会被序列化操作阻塞

支持的转换器

目前,以下第一方转换器已支持流式序列化功能,通过新增的 withStreaming() 工厂方法启用:

  • Gson 转换器
  • Jackson 转换器
  • Moshi 转换器
  • Protobuf 转换器
  • Wire 转换器

开发者只需在创建转换器实例时调用 withStreaming() 方法即可启用这一优化功能。

其他改进

原始类型标签支持修复

2.12.0 版本还修复了原始类型与 @Tag 注解一起使用时的问题。现在,原始类型值会被自动装箱,并以装箱后的类作为键存储,确保了类型安全性。

这一改进使得以下代码能够正常工作:

@GET("/user")
Call<User> getUser(@Tag int userId);

升级建议

对于现有项目,特别是那些处理大型请求体或对性能敏感的应用,建议升级到 2.12.0 版本以获得流式序列化带来的性能优势。升级过程通常只需修改依赖版本号,但需要注意:

  1. 检查自定义转换器的兼容性
  2. 评估流式序列化对现有业务逻辑的影响
  3. 对于需要立即序列化的特殊场景,可以继续使用默认的非流式模式

总结

Retrofit 2.12.0 通过引入流式序列化支持,进一步提升了框架的性能和资源利用率,特别是在处理大型请求体时表现更为出色。这一改进保持了 Retrofit 一贯的简洁 API 设计理念,同时为开发者提供了更高效的网络请求处理能力。结合对原始类型标签支持的修复,这个版本为 Retrofit 生态带来了更加完善的功能体验。

登录后查看全文
热门项目推荐
相关项目推荐