AIDL 預設不支援任意物件跨進程傳遞。需實現 Parcelable 介面,並在 AIDL 中宣告 parcelable 關鍵字,讓編譯器生成序列化/反序列化代碼。
writeToParcel、CREATOR、describeContents。parcelable ClassName; (無方法,僅標記可序列化)。import package.ClassName; 在方法簽名中使用。package com.example.aidlservicedemo.domain;
parcelable Message;
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 略
}
// User.aidl
package com.example.aidlservicedemo.domain;
parcelable User;
// User.java 同理實現 Parcelable (id, name, ...)
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);
}
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; }
}
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...
writeInt/readInt, writeString/readString, writeParcelable/readParcelable 等。writeXxx 與 readXxx 順序必須完全對應,否則資料錯位。getMes(user) → Proxy 將 user writeToParcel → Binder 驅動傳輸。onTransact → createFromParcel 還原 User → 執行業務邏輯。List → 每個 Message writeToParcel → 傳回。createFromParcel 還原 List → 返回給呼叫者。public static finalClassNotFoundException 或 BadParcelableException。Native Crash。建議用 Kotlin @Parcelize 自動生成。List,但元素必須為已宣告 parcelable 的類型。
@Parcelize
data class Message(
val id: Int,
val msgText: String,
val fromName: String,
val date: String
) : Parcelable
// 自動生成 writeToParcel、CREATOR、describeContents
配合 androidExtensions 或 kotlin-parcelize 插件,極大簡化樣板代碼。