Java 怎么用 Protostuff 框架序列化实体类对象-java教程-PHP中文网

protostuff通过runtimeschema动态生成序列化逻辑，无需.proto文件，核心依赖protostuff-core和protostuff-runtime；支持纯pojo、自动处理集合与常见类型，需注意linkedbuffer手动clear及无参构造函数要求。

java 怎么用 protostuff 框架序列化实体类对象

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，例如：

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）
}</string>

⚠️ 注意：字段名需与 getter/setter 匹配；若用字段直访（默认行为），需确保字段非 private 或开启 setAccessible(true)（runtime 模块已默认处理）。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

序列化与反序列化代码示例

使用 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);</user>

✅ 关键点：

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 错误，检查：