Protostuff通过RuntimeSchema动态生成序列化逻辑，无需.proto文件，核心依赖protostuff-core和protostuff-runtime；支持纯POJO、自动处理集合与常见类型，需注意LinkedBuffer手动clear及无参构造函数要求。
Java 中用 Protostuff 实现对象序列化，核心是借助 RuntimeSchema 动态生成序列化/反序列化逻辑，无需预编译 .proto 文件，比原生 Protobuf 更轻量灵活。
添加依赖（Maven）
Protostuff 主要模块包括 core、runtime 和 protostuff-api。常用组合如下：
- protostuff-core：基础序列化能力
- protostuff-runtime：支持 POJO 无注解自动映射（推荐）
在 pom.xml 中引入：
<dependency> <groupId>io.protostuff</groupId> <artifactId>protostuff-core</artifactId> <version>1.8.0</version> </dependency> <dependency> <groupId>io.protostuff</groupId> <artifactId>protostuff-runtime</artifactId> <version>1.8.0</version> </dependency>
定义一个普通实体类（无需实现 Serializable 或加注解）
Protostuff 支持纯 POJO，例如：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
public class User {
private String name;
private int age;
private List<String> tags;
// 必须有无参构造函数
public User() {}
public User(String name, int age) {
this.name = name;
this.age = age;
this.tags = new ArrayList<>();
}
// getter / setter 省略（Protostuff 会通过反射访问字段或调用 getter/setter）
}
⚠️ 注意：字段名需与 getter/setter 匹配；若用字段直访（默认行为），需确保字段非 private 或开启 setAccessible(true)（runtime 模块已默认处理）。
序列化与反序列化代码示例
使用 RuntimeSchema 获取运行时 Schema，再通过 LinkedBuffer 高效序列化：
// 创建 Schema（泛型推导，线程安全，可复用）
RuntimeSchema<User> schema = RuntimeSchema.getSchema(User.class);
// 序列化
User user = new User("Alice", 25);
user.getTags().add("dev");
user.getTags().add("java");
LinkedBuffer buffer = LinkedBuffer.allocate(512);
byte[] data;
try {
data = ProtostuffIOUtil.toByteArray(user, schema, buffer);
} finally {
buffer.clear(); // 必须调用，避免内存复用出错
}
// 反序列化
User deserialized = schema.newMessage();
ProtostuffIOUtil.mergeFrom(data, deserialized, schema);
✅ 关键点：
-
RuntimeSchema.getSchema()是线程安全的，建议缓存复用，不要每次新建 -
LinkedBuffer是堆外缓冲区，clear()必须调用，否则后续写入可能覆盖旧数据 - 不依赖
Serializable，也不强制要求 setter/getter（但推荐保留以兼容性更好）
处理复杂类型与集合（如 Map、嵌套对象）
Protostuff-runtime 默认支持常见 JDK 类型（List、Map、LocalDateTime 等），但部分类型需手动注册：
// 注册 LocalDateTime（Protostuff 1.8+ 已内置，旧版需自定义）
RuntimeSchema.register(new LocalDateTimeSchema());
// 若有自定义类型（如 Address），确保它也是 POJO，并被 RuntimeSchema 自动识别
public class Address {
private String city;
private String zip;
// ... 构造、getter/setter
}
如遇 No serializer found 错误，检查：
- 目标类是否有无参构造器
- 是否含不支持的类型（如 Lambda、ThreadLocal、未注册的第三方类）
- 是否开启了循环引用检测（默认关闭；如需支持，用
GraphIOUtil替代ProtostuffIOUtil）
