萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android AIDL 傳遞複雜對象 (Parcelable) 完整實戰:自訂類別跨進程序列化詳解

核心難點

AIDL 預設不支援任意物件跨進程傳遞。需實現 Parcelable 介面,並在 AIDL 中宣告 parcelable 關鍵字,讓編譯器生成序列化/反序列化代碼。

三步驟完成複雜對象傳遞

  1. 資料類別實現 Parcelable:實現 writeToParcel、CREATOR、describeContents。
  2. 資料 AIDL 宣告:parcelable ClassName; (無方法,僅標記可序列化)。
  3. 業務 AIDL 引入:import package.ClassName; 在方法簽名中使用。

完整代碼實作

1. Message.aidl (資料宣告)

package com.example.aidlservicedemo.domain;

parcelable Message;

2. Message.java (資料實現)

public class Message implements Parcelable {
    private int id;
    private String msgText;
    private String fromName;
    private String date;

    public Message(int id, String msgText, String fromName, String date) {
        this.id = id; this.msgText = msgText; this.fromName = fromName; this.date = date;
    }

    // ---- Parcelable 實現 ----
    @Override public int describeContents() { return 0; }

    @Override public void writeToParcel(Parcel dest, int flags) {
        dest.writeInt(id);
        dest.writeString(msgText);
        dest.writeString(fromName);
        dest.writeString(date);
    }

    public static final Creator CREATOR = new Creator() {
        @Override public Message createFromParcel(Parcel source) {
            // 讀取順序 **必須** 與 writeToParcel 完全一致
            return new Message(source.readInt(), source.readString(), source.readString(), source.readString());
        }
        @Override public Message[] newArray(int size) { return new Message[size]; }
    };

    // Getter / toString 略
}

3. User.aidl / User.java (另一個傳入參數類別)

// User.aidl
package com.example.aidlservicedemo.domain;
parcelable User;

// User.java 同理實現 Parcelable (id, name, ...)

4. IGetMsg.aidl (業務介面)

package com.example.aidlservicedemo.domain;

import com.example.aidlservicedemo.domain.Message;
import com.example.aidlservicedemo.domain.User;
import java.util.List;

interface IGetMsg {
    // in 表示單向傳入 (客戶端→服務),List 為回傳
    List getMes(in User us);
}

5. Service 端實現

public class CustomTypeService extends Service {
    private final IGetMsg.Stub binder = new IGetMsg.Stub() {
        @Override public List getMes(User us) throws RemoteException {
            Log.i("AIDL", "收到 User: " + us);
            // 模擬查詢
            List list = new ArrayList<>();
            list.add(new Message(1, "Hello " + us.getName(), "Server", new Date().toString()));
            list.add(new Message(2, "Welcome!", "Server", new Date().toString()));
            return list;
        }
    };
    @Override public IBinder onBind(Intent intent) { return binder; }
}

6. 客戶端調用

IGetMsg msgService;
ServiceConnection conn = new ServiceConnection() {
    @Override public void onServiceConnected(ComponentName name, IBinder binder) {
        msgService = IGetMsg.Stub.asInterface(binder);
    }
    @Override public void onServiceDisconnected(ComponentName name) { msgService = null; }
};

// 呼叫
User user = new User(100, "Andy");
List msgs = msgService.getMes(user); // 同步阻塞,建議放背景執行緒
// 處理 msgs...

Parcelable 與 Parcel 底層機制

  • Parcel:高效序列化容器,底層 C++ 實現,直接操作共享記憶體 (ashmem),支援 writeInt/readInt, writeString/readString, writeParcelable/readParcelable 等。
  • Parcelable:介面規範,要求實現類知道如何將自己「扁平化」進 Parcel 並從 Parcel 恢復。
  • 順序嚴格一致:writeXxx 與 readXxx 順序必須完全對應,否則資料錯位。
  • 效能優於 Serializable:無反射、原生優化、支援共享記憶體零拷貝。

序列化流程圖解 (Logcat 視角)

序列化流程日誌

  1. 客戶端 getMes(user) → Proxy 將 user writeToParcel → Binder 驅動傳輸。
  2. 服務端 Stub onTransact → createFromParcel 還原 User → 執行業務邏輯。
  3. 服務端回傳 List → 每個 Message writeToParcel → 傳回。
  4. 客戶端 Proxy 讀取 Parcel → createFromParcel 還原 List → 返回給呼叫者。

常見坑點與避坑指南

1. CREATOR 必須是 public static final
否則 Stub 找不到,拋 ClassNotFoundException 或 BadParcelableException。
2. 讀寫順序不一致
導致欄位錯位、數值亂碼、甚至 Native Crash。建議用 Kotlin @Parcelize 自動生成。
3. List<Parcelable> 傳遞
AIDL 支援 List,但元素必須為已宣告 parcelable 的類型。
4. 循環引用
Parcelable 不支援循環引用,需手動打破或改用 ID 參考。
5. 版本演進
新增欄位時,**只能在末尾追加**,並提供預設值讀取舊資料,否則舊版本無法反序列化新資料。

現代替代:Kotlin @Parcelize


@Parcelize
data class Message(
    val id: Int,
    val msgText: String,
    val fromName: String,
    val date: String
) : Parcelable
// 自動生成 writeToParcel、CREATOR、describeContents

配合 androidExtensions 或 kotlin-parcelize 插件,極大簡化樣板代碼。

copyright © 萬盛學電腦網 all rights reserved