Java 二進制文件讀寫實戰：DataOutput/DataInput 序列化協議設計

二進制序列化在高效能網絡通訊、嵌入式設備交互、本地緩存持久化場景廣泛應用。本文設計一套基於 DataOutput/DataInput 的自描述協議，支援基本型別、字符串、位圖、集合擴展，並給出完整可運行示例與效能分析。

一、協議設計原則

1. 定長型別：int/long/double 直接佔固定字節，無需長度前綴。
2. 變長型別：字符串採用 UTF-8 長度(2字節) + 字節數組（writeUTF/readUTF），位圖採用 長度(4字節) + 字節數組。
3. 順序嚴格：寫入/讀取字段順序完全一致，版本演進僅支援末尾新增字段。
4. 介面隔離：領域物件實作 Writable 介面，邏輯與存儲解耦。

二、核心介面與實體類

public interface Writable {
    void write(DataOutput out) throws IOException;
    void read(DataInput in) throws IOException;
}

public class UserProfile implements Writable {
    private int id;
    private String uuid;
    private int age;
    private boolean admin;
    private String username;
    private String password;
    private String bio;
    private byte[] avatar; // 圖片二進制

    // Getter/Setter 省略...

    @Override
    public void write(DataOutput out) throws IOException {
        out.writeInt(id);
        out.writeUTF(uuid);
        out.writeInt(age);
        out.writeBoolean(admin);
        out.writeUTF(username);
        out.writeUTF(password);
        out.writeUTF(bio);
        // 位圖：先寫長度，再寫字節
        out.writeInt(avatar != null ? avatar.length : -1);
        if (avatar != null) out.write(avatar);
    }

    @Override
    public void read(DataInput in) throws IOException {
        this.id = in.readInt();
        this.uuid = in.readUTF();
        this.age = in.readInt();
        this.admin = in.readBoolean();
        this.username = in.readUTF();
        this.password = in.readUTF();
        this.bio = in.readUTF();
        int len = in.readInt();
        if (len >= 0) {
            this.avatar = new byte[len];
            in.readFully(this.avatar); // 必須用 readFully 確保讀滿
        } else {
            this.avatar = null;
        }
    }

    // 工具方法：InputStream → byte[]
    public static byte[] toByteArray(InputStream is) throws IOException {
        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        byte[] buf = new byte[8192];
        int len;
        while ((len = is.read(buf)) != -1) bos.write(buf, 0, len);
        return bos.toByteArray();
    }

    // 工具方法：byte[] → File
    public static void writeToFile(byte[] data, File file) throws IOException {
        try (FileOutputStream fos = new FileOutputStream(file)) {
            fos.write(data);
        }
    }
}

三、完整測試主程式

public static void main(String[] args) throws IOException {
    UserProfile user = new UserProfile();
    user.setId(1001);
    user.setUuid(UUID.randomUUID().toString());
    user.setAge(28);
    user.setAdmin(false);
    user.setUsername("likehua");
    user.setPassword("secret");
    user.setBio("Java二進制序列化測試，支援中文、Emoji😀、長文本...");
    user.setAvatar(toByteArray(new FileInputStream("c:/1.jpg")));

    // 序列化到文件
    File dataFile = new File("c:/user.dat");
    try (DataOutputStream dos = new DataOutputStream(new FileOutputStream(dataFile))) {
        user.write(dos);
    }
    System.out.println("序列化完成，文件大小: " + dataFile.length() + " bytes");

    // 反序列化
    UserProfile restored = new UserProfile();
    try (DataInputStream dis = new DataInputStream(new FileInputStream(dataFile))) {
        restored.read(dis);
    }
    System.out.println("反序列化結果:");
    System.out.println("  ID: " + restored.getId());
    System.out.println("  UUID: " + restored.getUuid());
    System.out.println("  Username: " + restored.getUsername());
    System.out.println("  Bio: " + restored.getBio());
    System.out.println("  Avatar length: " + (restored.getAvatar() != null ? restored.getAvatar().length : "null"));

    // 還原圖片驗證
    if (restored.getAvatar() != null) {
        writeToFile(restored.getAvatar(), new File("c:/restored.jpg"));
        System.out.println("圖片已還原至 c:/restored.jpg");
    }
}

四、效能與空間對比（測試數據：含 100KB 圖片）

五、進階擴展：集合與巢狀物件

// List 寫入
out.writeInt(list.size());
for (String s : list) out.writeUTF(s);

// List 寫入
out.writeInt(list.size());
for (UserProfile u : list) u.write(out);

// 讀取對應
int size = in.readInt();
List list = new ArrayList<>(size);
for (int i = 0; i < size; i++) list.add(in.readUTF());

六、避坑指南

1. readFully 必須用於定長字節數組，read(byte[]) 可能讀不滿導致後續字段偏移錯誤。
2. writeUTF 限制 64KB（長度用 unsigned short），超長字符串需自行寫 writeInt(len) + write(bytes)。
3. 字節序：DataOutput 固定大端序，跨語言解析需注意（C/C++ 需 ntohl 轉換）。
4. 版本演進：在協議開頭寫入 magic number + version，反序列化時按版本分派解析邏輯。

七、總結

DataOutput/DataInput 提供最接近底層的二進制序列化能力，適合效能敏感、跨語言互操作、無 Schema 管理成本的場景。生產系統建議引入 Protobuf/FlatBuffers 獲得結構化協議演進能力；原型驗證、內部 RPC、嵌入式設備通訊可直接使用本文協議模板。

1. 上一篇文章： JDBC 處理 CLOB 大文本字段完整實戰指南
2. 下一篇文章： Java 對象序列化與反序列化深度指南：API、接口、版本兼容與安全實踐

Java 相關知識

Java 設計模式實戰：策略+工廠方法+裝飾器打造圖書折扣系統

需求描述 書店推出多重折扣規則： 新書：無折扣 計算機類：

使用 NetBeans 6.0 快速構建 Java 桌面資料庫應用程式教學

教學目標與技術棧 本教學示範如何利用 NetBeans ID

Spring DAO 層設計哲學：統一異常體系與模板模式

持久化技術百花齊放，Spring 如何整合？ Hiberna

Bootstrap + Jstree 實現樹形選單完整 CRUD 源碼教學

前言 jsTree 是基於 jQuery 的輕量級樹形選單插