AIDL基本使用

AIDL的概念

AIDL:全稱是Android Interface Definition Language(Android接口定義語(yǔ)言)。它主要用在Android進(jìn)程間通信中,Android中有一種進(jìn)程間通信方式是Binder,AIDL就是幫我們自動(dòng)生成了Binder相關(guān)代碼,不需要我們自己去手動(dòng)書寫復(fù)雜的Binder類,我們只需要在AIDL接口文件中書寫自己的調(diào)用遠(yuǎn)程服務(wù)的業(yè)務(wù)方法就可以了,大大簡(jiǎn)化了開(kāi)發(fā)過(guò)程。

AIDL支持的數(shù)據(jù)類型

  • 八種基本數(shù)據(jù)類型:byte、char、short、int、long、float、double、boolean
  • String,CharSequence
  • 實(shí)現(xiàn)了Parcelable接口的數(shù)據(jù)類型
  • List 類型。List承載的數(shù)據(jù)必須是AIDL支持的類型,或者是其它聲明的AIDL對(duì)象
  • Map類型。Map承載的數(shù)據(jù)必須是AIDL支持的類型,或者是其它聲明的AIDL對(duì)象

AIDL使用步驟

例子源自《Android開(kāi)發(fā)藝術(shù)探索》,點(diǎn)擊獲取Demo

Server端

1.首先創(chuàng)建一個(gè)Book類和兩個(gè)aidl文件

class Book : Parcelable {
    var bookId: Int
    var bookName: String?

    constructor(bookId: Int, bookName: String?) {
        this.bookId = bookId
        this.bookName = bookName
    }

    override fun describeContents(): Int {
        return 0
    }

    override fun writeToParcel(dest: Parcel, flags: Int) {
        dest.writeInt(bookId)
        dest.writeString(bookName)
    }

    constructor(source: Parcel) {
        bookId = source.readInt()
        bookName = source.readString()
    }

    override fun toString(): String {
        return "Book{" +
                "bookId=" + bookId +
                ", bookName='" + bookName + '\'' +
                '}'
    }


    companion object CREATOR : Parcelable.Creator<Book> {
        override fun createFromParcel(parcel: Parcel): Book {
            return Book(parcel)
        }

        override fun newArray(size: Int): Array<Book?> {
            return arrayOfNulls(size)
        }
    }
}

Book.aidl文件

// Book.aidl
package com.example.helloaidl;

parcelable Book;

IBookManager.aidl文件

// IBookManager.aidl
package com.example.helloaidl;
import com.example.helloaidl.Book;

interface IBookManager {
    // 獲取圖書列表
    List<Book> getBookList();

    //添加圖書
    void addBook(in Book book);
}

2.rebuild項(xiàng)目,會(huì)自動(dòng)生成一個(gè) IBookManager的java類, 里面書寫了Binder相關(guān)代碼。

public interface IBookManager extends android.os.IInterface
{
  /** Default implementation for IBookManager. */
  public static class Default implements com.example.helloaidl.IBookManager
  {
    // 獲取圖書列表

    @Override public java.util.List<com.example.helloaidl.Book> getBookList() throws android.os.RemoteException
    {
      return null;
    }
    //添加圖書

    @Override public void addBook(com.example.helloaidl.Book book) throws android.os.RemoteException
    {
    }
    @Override
    public android.os.IBinder asBinder() {
      return null;
    }
  }
  /** Local-side IPC implementation stub class. */
  public static abstract class Stub extends android.os.Binder implements com.example.helloaidl.IBookManager
  {
    private static final java.lang.String DESCRIPTOR = "com.example.helloaidl.IBookManager";
    
    /**
   * Stub構(gòu)造函數(shù)
   */
    public Stub()
    {
      this.attachInterface(this, DESCRIPTOR);
    }
    /**
     * 將IBinder 轉(zhuǎn)換為BookManagerService interface
     */
    public static com.example.helloaidl.IBookManager asInterface(android.os.IBinder obj)
    {
      if ((obj==null)) {
        return null;
      }
      android.os.IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
      if (((iin!=null)&&(iin instanceof com.example.helloaidl.IBookManager))) {
        return ((com.example.helloaidl.IBookManager)iin);
      }
      return new com.example.helloaidl.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
    {
      java.lang.String descriptor = DESCRIPTOR;
      switch (code)
      {
        case INTERFACE_TRANSACTION:
        {
          reply.writeString(descriptor);
          return true;
        }
        case TRANSACTION_getBookList:
        {
          data.enforceInterface(descriptor);
          java.util.List<com.example.helloaidl.Book> _result = this.getBookList();
          reply.writeNoException();
          reply.writeTypedList(_result);
          return true;
        }
        case TRANSACTION_addBook:
        {
          data.enforceInterface(descriptor);
          com.example.helloaidl.Book _arg0;
          if ((0!=data.readInt())) {
            _arg0 = com.example.helloaidl.Book.CREATOR.createFromParcel(data);
          }
          else {
            _arg0 = null;
          }
          this.addBook(_arg0);
          reply.writeNoException();
          return true;
        }
        default:
        {
          return super.onTransact(code, data, reply, flags);
        }
      }
    }
    /**
    * 代理
    */
    private static class Proxy implements com.example.helloaidl.IBookManager
    {
      private android.os.IBinder mRemote;
      
      /**
      * Proxy構(gòu)造函數(shù)
      */
      Proxy(android.os.IBinder remote)
      {
        mRemote = remote;
      }
      @Override public android.os.IBinder asBinder()
      {
        return mRemote;
      }
      public java.lang.String getInterfaceDescriptor()
      {
        return DESCRIPTOR;
      }
      //獲取圖書列表

      @Override public java.util.List<com.example.helloaidl.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.helloaidl.Book> _result;
        try {
          _data.writeInterfaceToken(DESCRIPTOR);
          boolean _status = mRemote.transact(Stub.TRANSACTION_getBookList, _data, _reply, 0);
          if (!_status && getDefaultImpl() != null) {
            return getDefaultImpl().getBookList();
          }
          _reply.readException();
          _result = _reply.createTypedArrayList(com.example.helloaidl.Book.CREATOR);
        }
        finally {
          _reply.recycle();
          _data.recycle();
        }
        return _result;
      }
      
      //添加圖書
      @Override public void addBook(com.example.helloaidl.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);
          }
          boolean _status = mRemote.transact(Stub.TRANSACTION_addBook, _data, _reply, 0);
          if (!_status && getDefaultImpl() != null) {
            getDefaultImpl().addBook(book);
            return;
          }
          _reply.readException();
        }
        finally {
          _reply.recycle();
          _data.recycle();
        }
      }
      public static com.example.helloaidl.IBookManager sDefaultImpl;
    }
    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 static boolean setDefaultImpl(com.example.helloaidl.IBookManager impl) {
      if (Stub.Proxy.sDefaultImpl == null && impl != null) {
        Stub.Proxy.sDefaultImpl = impl;
        return true;
      }
      return false;
    }
    public static com.example.helloaidl.IBookManager getDefaultImpl() {
      return Stub.Proxy.sDefaultImpl;
    }
  }
  // 鑾峰彇鍥句功鍒楄〃

  public java.util.List<com.example.helloaidl.Book> getBookList() throws android.os.RemoteException;
  //娣誨姞鍥句功

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

3.編寫遠(yuǎn)程服務(wù)代碼 BookManagerService,為了演示進(jìn)程間的通信機(jī)制,故需要將Service與Activity處于不同的進(jìn)程,需要在AndroidManifest.xml中,把service配置成android:process=":remote"

class BookManagerService : Service() {
    private val TAG = BookManagerService::class.java.simpleName

    //使用CopyOnWriteArrayList來(lái)支持并發(fā)讀寫
    private val mBookList = CopyOnWriteArrayList<Book>()

    override fun onBind(intent: Intent): IBinder? {
        return mBinder
    }


    private val mBinder = object : IBookManager.Stub() {
        override fun addBook(book: Book) {
            mBookList.add(book)
        }

        override fun getBookList(): List<Book> {
            return mBookList
        }

    }

}
<service
        android:name="com.example.helloaidl.BookManagerService
        android:enabled="true"
        android:exported="true"
        android:process=":remote">
</service>
客戶端

創(chuàng)建Activity,在manifest中注冊(cè),完整代碼如下:

class BookManagerActivity : AppCompatActivity() {

    private val TAG = BookManagerActivity::class.java.simpleName

    private var mRemoteBookManager: IBookManager? = null
    private var boookId = 1

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        bindService()
        initListener()
    }

    //綁定遠(yuǎn)程服務(wù)端
    private fun bindService() {
        val intent = Intent(this, BookManagerService::class.java)
        intent.setPackage(packageName)
        bindService(intent, mConnection, Context.BIND_AUTO_CREATE)
    }

    //注冊(cè)按鈕監(jiān)聽(tīng),調(diào)用遠(yuǎn)程耗時(shí)方法需要開(kāi)啟線程
    private fun initListener() {
        btnGetBookList.setOnClickListener {
            Toast.makeText(this, "GetBookList", Toast.LENGTH_SHORT).show()
            Thread {
                try {
                    mRemoteBookManager?.let { mRemoteBookManager ->
                        val list = mRemoteBookManager.bookList
                        Log.i(TAG, "query book list: $list")
                    }
                } catch (e: RemoteException) {
                    e.printStackTrace()
                }
            }.start()
        }
        btnAddBook.setOnClickListener {
            Toast.makeText(this, "AddBook", Toast.LENGTH_SHORT).show()
            Thread {
                try {
                    mRemoteBookManager?.apply {
                        val newBook = Book( boookId++, "Book$boookId")
                        Log.i(TAG, "add book: $newBook")
                        addBook(newBook)
                    }
                } catch (e: RemoteException) {
                    e.printStackTrace()
                }
            }.start()
        }
    }

    override fun onDestroy() {
        unBindService()
        super.onDestroy()
    }

    private fun unBindService() {
        unbindService(mConnection)
    }

    //服務(wù)端連接狀態(tài)回調(diào)
    private var mConnection = object : ServiceConnection {
        override fun onServiceConnected(name: ComponentName?, service: IBinder?) {
            Log.e(TAG, "onServiceConnected: $mRemoteBookManager")
            //將服務(wù)端返回的Binder對(duì)象轉(zhuǎn)換為aidl對(duì)象
            mRemoteBookManager = IBookManager.Stub.asInterface(service)
            Log.e(TAG, "onServiceConnected: $mRemoteBookManager")
        }

        override fun onServiceDisconnected(name: ComponentName?) {
            Log.i(TAG, "onServiceDisconnected ThreadName: ${Thread.currentThread().name}")
            mRemoteBookManager = null
        }
    }

}

點(diǎn)擊獲取Demo

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容