//Aidl 需要聲名 導入 引用類。與JAVA 機制不同
// Declare any non-default types here with import statements
public interface IBookManager extends android.os.IInterface {
/**
* 聲明IBookManager.aidl 中 自定義的方法
*/
public java.util.List<com.rango.ipc.Book> getBookList() throws android.os.RemoteException;
public void addBook(com.rango.ipc.Book book) throws android.os.RemoteException;
/**
* 聲明兩個 id 標識 transact 過程中 客戶端請求的方法名稱
*/
static final int TRANSACTION_getBookList = (android.os.IBinder.FIRST_CALL_TRANSACTION + 0);
static final int TRANSACTION_addBook = (android.os.IBinder.FIRST_CALL_TRANSACTION + 1);
/**
* 聲明 一個Binder 類
*/
public static abstract class Stub extends android.os.Binder implements com.rango.ipc.IBookManager {
/**
* Binder 的唯一標識,作為Binder類名標識
*/
private static final String DESCRIPTOR = "com.rango.ipc.IBookManager";
public Stub() {
this.attachInterface(this, DESCRIPTOR);
}
/**
* 用于講服務端的Binder 對象轉換成客戶端所需要的Aidl 接口類型對象
*/
public static com.rango.ipc.IBookManager asInterface(android.os.IBinder obj) {
if ((obj==null)) {
return null;
}
android.os.IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
/** 如果客戶端與 服務端 處在同一進程,那么返回服務端的Sub 對象。*/
if (((iin!=null)&&(iin instanceof com.rango.ipc.IBookManager))) {
return ((com.rango.ipc.IBookManager)iin);
}
/** 否則返回 Stub.proxy 對象 */
return new com.rango.ipc.IBookManager.Stub.Proxy(obj);
}
@Override
public android.os.IBinder asBinder() {
return this;
}
@Override
public boolean onTransact(int code, android.os.Parcel data, android.os.Parcel reply, int flags)
throws android.os.RemoteException {
String descriptor = DESCRIPTOR;
switch (code){
case INTERFACE_TRANSACTION: {
reply.writeString(descriptor);
return true;
}
case TRANSACTION_getBookList: {
data.enforceInterface(descriptor);
java.util.List<com.rango.ipc.Book> _result = this.getBookList();
reply.writeNoException();
reply.writeTypedList(_result);
return true;
}
case TRANSACTION_addBook: {
data.enforceInterface(descriptor);
com.rango.ipc.Book _arg0;
if ((0!=data.readInt())) {
_arg0 = com.rango.ipc.Book.CREATOR.createFromParcel(data);
} else {
_arg0 = null;
}
this.addBook(_arg0);
reply.writeNoException();
return true;
}
default: {
return super.onTransact(code, data, reply, flags);
}
}
}
/**
* Binder 內部代理類。由客戶端創建并使用
*/
private static class Proxy implements com.rango.ipc.IBookManager {
private android.os.IBinder mRemote;
Proxy(android.os.IBinder remote) {
mRemote = remote;
}
@Override
public android.os.IBinder asBinder() {
return mRemote;
}
public String getInterfaceDescriptor() {
return DESCRIPTOR;
}
@Override
public java.util.List<com.rango.ipc.Book> getBookList() throws android.os.RemoteException {
/** 創建 輸入 和 輸入的 Parcel 對象 */
android.os.Parcel _data = android.os.Parcel.obtain();
android.os.Parcel _reply = android.os.Parcel.obtain();
java.util.List<com.rango.ipc.Book> _result;
try {
_data.writeInterfaceToken(DESCRIPTOR);
/**
* 調用 transact 進行RPC(遠程過程調用) 掛起當前線程(即客戶端線程!!如果在UI線程請求,而服務端執行耗時操作,此時等于是讓UI線程陷入等待)。然后服務端的onTransact 會被調用。
*/
mRemote.transact(Stub.TRANSACTION_getBookList, _data, _reply, 0);
_reply.readException();
/** 取出RPC 過程的返回結果 */
_result = _reply.createTypedArrayList(com.rango.ipc.Book.CREATOR);
} finally {
_reply.recycle();
_data.recycle();
}
return _result;
}
@Override
public void addBook(com.rango.ipc.Book book) throws android.os.RemoteException {
android.os.Parcel _data = android.os.Parcel.obtain();
android.os.Parcel _reply = android.os.Parcel.obtain();
try {
_data.writeInterfaceToken(DESCRIPTOR);
if ((book!=null)) {
_data.writeInt(1);
book.writeToParcel(_data, 0);
} else {
_data.writeInt(0);
}
mRemote.transact(Stub.TRANSACTION_addBook, _data, _reply, 0);
_reply.readException();
} finally {
_reply.recycle();
_data.recycle();
}
}
}//end Proxy
}//end Stub
}
END
參考:《Android 開發藝術探索》
拓展使用:利用Binder機制 實現客戶端與服務端 雙向通信