3. 自定义Parcelable对象与AIDL序列化

在 Android Binder 通信体系中，所有跨越进程边界的对象都必须被序列化为可打包的字节流。Android 提供两种序列化方案：Serializable（基于 Java 反射，效率低、临时文件多）和 Parcelable（基于明确协议，零反射、零临时文件）。本章将深入 Parcelable 的设计原理，并完整演示如何为自定义数据类实现 Parcelable 接口、编写 writeToParcel 与 CREATOR，最终在 AIDL 接口中正确导入和使用自定义 Parcelable 类型。

3.1 Parcelable 的核心设计理念

Parcelable 不是通用的序列化框架，而是专为 Android Binder 设计的 高性能 IPC 数据契约。其核心思想是：“由对象自己决定如何把内部状态写入 Parcel，以及如何从 Parcel 重建自己”。正因为开发者直接操作 Parcel 的读写方法，避免了反射和临时对象创建，使得 Parcelable 在移动端 IPC 场景下比 Serializable 快 10 倍以上。

3.2 实现 Parcelable 接口的完整流程

以一个业务中常见的 UserInfo 数据类为例，展示从 POJO 到 Parcelable 的完整转化过程。

步骤 1：定义数据类并实现 Parcelable

public class UserInfo implements Parcelable {
    private String userId;
    private String userName;
    private int age;
    private boolean isVip;

    // 构造函数（可选带全部参数的构造）
    public UserInfo(String userId, String userName, int age, boolean isVip) {
        this.userId = userId;
        this.userName = userName;
        this.age = age;
        this.isVip = isVip;
    }

    // ==================== 必须实现的两个核心方法 ====================

    @Override
    public int describeContents() {
        // 如果包含文件描述符（如 Bitmap），返回 CONTENTS_FILE_DESCRIPTOR；否则返回 0
        return 0;
    }

    @Override
    public void writeToParcel(Parcel dest, int flags) {
        // 写入顺序：String → int → boolean （与 CREATOR 中读取顺序必须一致）
        dest.writeString(userId);
        dest.writeString(userName);
        dest.writeInt(age);
        dest.writeByte((byte) (isVip ? 1 : 0));
    }

    // ==================== 必须提供的 CREATOR 静态字段 ====================

    public static final Creator<UserInfo> CREATOR = new Creator<UserInfo>() {
        @Override
        public UserInfo createFromParcel(Parcel in) {
            // 读取顺序必须与 writeToParcel 完全一致
            String userId = in.readString();
            String userName = in.readString();
            int age = in.readInt();
            boolean isVip = in.readByte() != 0;
            return new UserInfo(userId, userName, age, isVip);
        }

        @Override
        public UserInfo[] newArray(int size) {
            return new UserInfo[size];
        }
    };

    // getter 方法（用于后续跨进程业务）
    public String getUserId() { return userId; }
    public String getUserName() { return userName; }
    public int getAge() { return age; }
    public boolean isVip() { return isVip; }
}

步骤 2：各数据类型对应的 Parcel 读写方法

Parcel 为每种基本类型和常见对象类型提供了专门的读写 API，需要一一对应。

3.3 在 AIDL 中导入自定义 Parcelable 类型

自定义 Parcelable 类型要用于 AIDL 接口的参数或返回值，必须经过 三个显式步骤，缺一不可。

1. 在 AIDL 文件中声明包路径和 Parcelable 关键字

// IUserService.aidl
package com.example.server;

// 导入（声明）自定义 Parcelable 类型，注意使用 parcelable 小写关键字
// 路径必须与 Java 类的包名一致
parcelable UserInfo;

2. 在 AIDL 接口中将自定义类型用于方法签名

// IUserService.aidl 完整示例
package com.example.server;

import com.example.server.UserInfo;

interface IUserService {
    // 使用自定义 Parcelable 作为参数和返回值
    boolean addUser(in UserInfo user);
    UserInfo getUserById(String userId);
    List<UserInfo> getAllUsers();
}

3. 确保 Java 源码与 AIDL 文件处于同包或正确项目结构

在 Android Studio 中，AIDL 文件默认放在 src/main/aidl/ 目录下，其包路径必须与对应的 Java 类包路径一致。UserInfo.java 应位于 src/main/java/com/example/server/，而 UserInfo.aidl 声明文件应位于 src/main/aidl/com/example/server/。

3.4 核心流程内联 SVG 结构图

下图展示了自定义 Parcelable 对象从 Java 类设计到 AIDL 接口使用的完整数据流动路径：

3.5 调试步骤与验证方法

Parcelable 实现是否正确，不在编译阶段报错，但运行时错误非常隐蔽（常表现为跨进程调用时数据错乱、字段全为 null、类型转换异常）。建议采用以下验证步骤：

1. 单元测试 Parcel 往返序列化：在同一进程内手动模拟打包和解包，确认对象内容不变。

// 单元测试（JUnit + AndroidX Parcelable 扩展）
public void testParcelableRoundTrip() {
    UserInfo original = new UserInfo("uid001", "张三", 25, true);

    // 写入 Parcel
    Parcel parcel = Parcel.obtain();
    original.writeToParcel(parcel, 0);
    parcel.setDataPosition(0);

    // 重建对象
    UserInfo restored = UserInfo.CREATOR.createFromParcel(parcel);

    // 断言字段一致
    assertEquals(original.getUserId(), restored.getUserId());
    assertEquals(original.getUserName(), restored.getUserName());
    assertEquals(original.getAge(), restored.getAge());
    assertEquals(original.isVip(), restored.isVip());

    parcel.recycle();
}

2. 在 AIDL 接口实际调用中打印日志：分别在客户端调用前、服务端 onTransact 入口处、服务端方法实现中打印 Parcelable 对象的 toString 内容，比对字段完整性。

// 服务端 onTransact 中打桩日志
@Override
protected boolean onTransact(int code, Parcel data, Parcel reply, int flags) throws RemoteException {
    if (code == TRANSACTION_addUser) {
        data.enforceInterface(DESCRIPTOR);
        UserInfo arg0;
        arg0 = data.readTypedObject(UserInfo.CREATOR);  // 读取自定义 Parcelable
        Log.d("BinderTrace", "Server received UserInfo: " + arg0.toString());
        // ...
    }
}

3.6 常见错误与避坑指南

3.7 性能与稳定性优化建议

• 复用 Parcel 对象：每次跨进程调用都调用 Parcel.obtain() 而非 new，用完后立即 recycle()，避免内存抖动。
• 避免超大对象：Parcel 共享内存默认大小约 1MB（不同厂商有差异），单个 Parcelable 对象不应超过 100KB，否则容易触发 TransactionTooLargeException。
• 使用 @Nullable 和空值保护：在 CREATOR 读取时对可能为 null 的 String 或 List 做非空判断：

String userName = in.readString();
if (userName == null) {
    userName = "";
}

• 利用 describeContents 优化共享内存：如果 Parcelable 包含文件描述符（如共享内存 fd），正确返回 CONTENTS_FILE_DESCRIPTOR，让 Binder 驱动做零拷贝优化。