Android艺术探索笔记 - 创建AIDL文件后自动生成的文件分析

最新推荐文章于 2024-04-21 22:50:25 发布

洌冰

最新推荐文章于 2024-04-21 22:50:25 发布

阅读量344

点赞数

分类专栏： Android 文章标签： android

Android 专栏收录该内容

119 篇文章 6 订阅

订阅专栏

在Eclipse新建aidl如下
Book.aidl定义:



//Book类在aidl的声明，要在IBookManagerimportbook类，否则IBookManager报错找不到Book类
package com.example.testbinder;


parcelable Book;

IBookManager.aidl定义:


package com.example.testbinder;

import com.example.testbinder.Book;

interface IBookManager{
  List<Book> getBookList();
  void addBook(in Book book);
}

在项目中创建IBookManager.aidl时，会在gen目录下生成一个对应的java文件，这个文件是aidl执行过程的核心。代码整理后如下

/*
 * This file is auto-generated.  DO NOT MODIFY.
 * Original file: /home/caihuijian/workspacefolder/TestBinder/src/com/example/testbinder/IBookManager.aidl
 */
package com.example.testbinder;

public interface IBookManager extends android.os.IInterface {
    // 内部类 Stub，继承了Binder，所以Stub就是一个Binder类
    /** Local-side IPC implementation stub class. */
    public static abstract class Stub extends android.os.Binder implements
            com.example.testbinder.IBookManager {

        // Binder唯一标识，一般用当前aidl的完整包名+类名表示
        private static final java.lang.String DESCRIPTOR = "com.example.testbinder.IBookManager";

        /** Construct the stub at attach it to the interface. */
        // 构造函数
        public Stub() {
            // 关联指定接口和Binder this--接口, DESCRIPTOR--代表binder
            this.attachInterface(this, DESCRIPTOR);
        }

        /**
         * Cast an IBinder object into an com.example.testbinder.IBookManager
         * interface, generating a proxy if needed.
         * 
         * 将IBinder转化为com.example.testbinder.IBookManager的接口对象
         * 代码分析：如果客户端和服务端同进程，则返回服务端的Stub对象本身 否则返回封装后的Stub.Proxy对象
         */
        public static com.example.testbinder.IBookManager asInterface(
                android.os.IBinder obj) {
            if ((obj == null)) {
                return null;
            }

            // 尝试从本地实现接口接收binder对象，如果得到的是null，你就需要从服务器端得到Binder对象，来转化成客户端所需的AIDL对象，即需要实例化proxy类来通过transact方法收集回调
            android.os.IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
            if (((iin != null) && (iin instanceof com.example.testbinder.IBookManager))) {
                // 无需跨进程
                return ((com.example.testbinder.IBookManager) iin);
            }
            // 跨进程case
            return new com.example.testbinder.IBookManager.Stub.Proxy(obj);
        }

        //返回当前binder对象
        @Override
        public android.os.IBinder asBinder() {
            return this;
        }

        // 运行在服务器端
        // onTransact只有当客户端和服务端不在同一个进程时才会调用
        // code代表请求类型 data中存放请求的参数，之后执行指定方法，
        // reply是服务器返回的结果，flags标明是否有返回值，0为有（双向），1为没有（单向），
        // 执行完毕向reply写入结果，如果有的话，return值代表返回成功或失败
        // 方法运行在服务端的binder线程池，客户端请求后通过底层代码将请求封装后交由该方法处理
        @Override
        public boolean onTransact(int code, android.os.Parcel data,
                android.os.Parcel reply, int flags)
                throws android.os.RemoteException {
            switch (code) {
            case INTERFACE_TRANSACTION: {
                reply.writeString(DESCRIPTOR);
                return true;
            }
            case TRANSACTION_getBookList: {
                data.enforceInterface(DESCRIPTOR);
                java.util.List<com.example.testbinder.Book> _result = this
                        .getBookList();
                reply.writeNoException();
                reply.writeTypedList(_result);
                return true;
            }
            case TRANSACTION_addBook: {
                data.enforceInterface(DESCRIPTOR);
                com.example.testbinder.Book _arg0;
                if ((0 != data.readInt())) {
                    _arg0 = com.example.testbinder.Book.CREATOR
                            .createFromParcel(data);
                } else {
                    _arg0 = null;
                }
                this.addBook(_arg0);
                reply.writeNoException();
                return true;
            }
            }
            return super.onTransact(code, data, reply, flags);
        }

        private static class Proxy implements
                com.example.testbinder.IBookManager {
            private android.os.IBinder mRemote;

            Proxy(android.os.IBinder remote) {
                mRemote = remote;
            }

            @Override
            public android.os.IBinder asBinder() {
                return mRemote;
            }

            public java.lang.String getInterfaceDescriptor() {
                return DESCRIPTOR;
            }

            //运行在客户端，运行步骤如下
            //1创建输入型参数data和输出型参数reply，注意他们都是parcel类型的
            //2创建返回值对象result（如果有的话）
            //3将参数写入data（如果有参数）
            //4调用transact发起远程请求，接着当前线程挂起

            //5远程服务端的onTransact调用并返回结果
            //6挂起的线程继续执行，从reply中取出返回结果result（如果有的话），并返回result
            @Override
            public java.util.List<com.example.testbinder.Book> getBookList()
                    throws android.os.RemoteException {
                android.os.Parcel _data = android.os.Parcel.obtain();
                android.os.Parcel _reply = android.os.Parcel.obtain();
                java.util.List<com.example.testbinder.Book> _result;
                try {
                    _data.writeInterfaceToken(DESCRIPTOR);
                    mRemote.transact(Stub.TRANSACTION_getBookList, _data,
                            _reply, 0);
                    _reply.readException();
                    _result = _reply
                            .createTypedArrayList(com.example.testbinder.Book.CREATOR);
                } finally {
                    _reply.recycle();
                    _data.recycle();
                }
                return _result;
            }

            //执行过程和getBookList一样
            @Override
            public void addBook(com.example.testbinder.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();
                }
            }
        }

        // 两个int值，用于标记调用的是哪个接口
        static final int TRANSACTION_getBookList = (android.os.IBinder.FIRST_CALL_TRANSACTION + 0);
        static final int TRANSACTION_addBook = (android.os.IBinder.FIRST_CALL_TRANSACTION + 1);
    }

    // 两个接口
    public java.util.List<com.example.testbinder.Book> getBookList()
            throws android.os.RemoteException;

    public void addBook(com.example.testbinder.Book book)
            throws android.os.RemoteException;
}