在 java 对象序列化中,自定义 writeobject 的核心做法是在实现 serializable 接口的类中定义一个私有的、无参的 void writeobject(java.io.objectoutputstream out) 方法。当调用 objectoutputstream.writeobject() 时,反射机制会自动检测并优先执行这个私有方法,从而允许你在默认序列化逻辑之前或之后介入,处理敏感字段加密、版本兼容或状态转换等需求。

如何正确委托默认序列化行为
在自定义的 writeObject 方法中,必须显式调用 out.defaultWriteObject() 来触发默认的序列化流程。如果不调用该方法,所有非静态、非瞬态(transient)的字段将不会被写入流中,导致反序列化时数据丢失。通常的做法是先调用 defaultWriteObject() 保存基础状态,然后再通过 out.writeObject() 写入经过特殊处理的额外数据,例如对密码字段进行加密后再写入。

import java.io.IOException;
import java.io.ObjectOutputStream;
import java.io.Serializable;
public class User implements Serializable {
private String username;
private transient String password; // 标记为瞬态,默认不序列化
public User(String username, String password) {
this.username = username;
this.password = password;
}
// 自定义序列化方法:必须是 private void
private void writeObject(ObjectOutputStream out) throws IOException {
// 1. 先执行默认序列化,保存 username
out.defaultWriteObject();
// 2. 手动处理 transient 字段,例如加密后写入
String encryptedPwd = encrypt(password);
out.writeObject(encryptedPwd);
}
private String encrypt(String pwd) {
return "ENC:" + pwd; // 简单模拟加密
}
}
如何处理集合或动态字段的序列化
对于包含集合或动态数量的字段,自定义 writeObject 可以优化性能并控制内存占用。默认序列化会写入整个集合结构,而自定义方法可以先写入集合的大小,再逐个遍历写入元素。这种方式不仅减少了字节数组的长度,还能在读取时按需加载,避免一次性加载大量无用数据。同时,这也为后续添加版本控制提供了空间,比如在写入头部添加版本号标识。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import java.io.IOException;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.util.List;
public class Report implements Serializable {
private String title;
private List<string> dataPoints; // 动态数据列表
public Report(String title, List<string> dataPoints) {
this.title = title;
this.dataPoints = dataPoints;
}
private void writeObject(ObjectOutputStream out) throws IOException {
// 1. 默认序列化标题
out.defaultWriteObject();
// 2. 自定义序列化集合:先写大小,再写内容
out.writeInt(dataPoints.size());
for (String point : dataPoints) {
out.writeObject(point);
}
}
}</string></string>
writeObject 方法签名必须满足什么条件才能被识别
为了让 JVM 的序列化机制正确识别并调用自定义的 writeObject,该方法必须严格遵循以下签名规范:访问修饰符必须是 private,返回类型必须是 void,方法名必须是 writeObject,且参数列表必须且只能包含一个 java.io.ObjectOutputStream 类型的参数。任何细微的差异,如将 private 改为 public,或者增加额外的参数,都会导致该方法被视为普通方法而被忽略,JVM 将回退到默认的序列化行为。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










