Binder 机制-分析记录

//Aidl 需要声名 导入 引用类。与JAVA 机制不同
// Declare any non-default types here with import statements

public interface IBookManager extends android.os.IInterface {

    /**
     * 声明IBookManager.aidl 中 自定义的方法
     */
    public java.util.List 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 _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 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 _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机制 实现客户端与服务端 双向通信