Android开发笔记-AIDL开发

概述


AIDL (Android Interface Definition Language)是Android内部进程通信(IPC)的接口定义语言,通过它可以定义客户端与服务器端的通信接口,实现跨进程通信。

只有当需要允许来自不同应用的客户端跨进程通信访问Service,且想要在Service中处理多线程的时候AIDL才是必要的。如果不需要执行不同应用之间的IPC并发,可以通过实现Binder建立接口;如果需要执行IPC,但不需要处理多线程,可以使用Messenger实现接口。

在使用AIDL之前,需要先了解Bound Services

使用AIDL三部曲


1. 创建.aidl文件

在src/main/aidl/%packagename%/下创建.aidl文件,定义接口方法。

.aidl文件中只能定义方法,不能定义静态变量。

.aidl文件支持的数据类型:

  • 基本数据类型(int, byte, char, float, boolean, ...)
  • String
  • CharSequence
  • Array
  • List
  • Map
  • Parcelable

特殊关键字in, out, inout :

  • in表示由客户端设置,修饰输入参数,非基本类型的输入参数必须使用in修饰

  • out表示由服务器端设置,修饰输出参数,非基本类型的输出参数必须使用out修饰

  • inout表示既是输入参数,也是输出参数

      void copyArray(in byte[] source, out byte[] dest);
    
      void sort(inout int[] source);
    

示例

// IRemoteService.aidl
package com.example.android;

// Declare any non-default types here with import statements

/** Example service interface */
interface IRemoteService {
    /** Request the process ID of this service, to do evil things with it. */
    int getPid();

    /** Demonstrates some basic types that you can use as parameters
     * and return values in AIDL.
     */
    void basicTypes(int anInt, long aLong, boolean aBoolean, float aFloat, 
        double aDouble, String aString);
}

2. 实现接口

build项目,Android SDK tools会自动生成.java文件,实现其内部抽象类Stub。

抽象类Stub继承Binder,并实现了.aidl文件中定义的接口。

private final IRemoteService.Stub mBinder = new IRemoteService.Stub() {
    public int getPid() {
        return Process.myPid();
    }

    public void basicTypes(int anInt, long aLong, boolean aBoolean,
        float aFloat, double aDouble, String aString) {
    }
};

注意:

  • RPC调用是同步的,执行耗时操作时,不应该在主线程调用其方法
  • 抛出的异常不会发送给客户端

3. 公开接口

创建一个Service,实现其onBind(intent)方法,返回实现接口的对象。

public class RemoteService extends Service {
    @Override
    public void onCreate() {
        super.onCreate();
    }

    @Override
    public IBinder onBind(Intent intent) {
        // Return the interface
        return mBinder;
    }

    private final IRemoteService.Stub mBinder = new IRemoteService.Stub() {
        public int getPid(){
            return Process.myPid();
        }
        public void basicTypes(int anInt, long aLong, boolean aBoolean,
            float aFloat, double aDouble, String aString) {
        }
    };
}

客户端绑定Service时,通过ServiceConnection对象获取返回的IBinder对象,即可调用远程方法。

IRemoteService mIRemoteService;
private ServiceConnection mConnection = new ServiceConnection() {
    // Called when the connection with the service is established
    public void onServiceConnected(ComponentName className, IBinder service) {
        // Following the example above for an AIDL interface,
        // this gets an instance of the IRemoteInterface, which we can use 
        // to call on the service
        mIRemoteService = IRemoteService.Stub.asInterface(service);
    }

    // Called when the connection with the service disconnects unexpectedly
    public void onServiceDisconnected(ComponentName className) {
        Log.e(TAG, "Service has unexpectedly disconnected");
        mIRemoteService = null;
    }
};

相关类


Parcelable(自定义数据类型)

Parcelable接口是Android特有的,实现该接口的对象可以被序列化,可以用于进程间通信。

如果想通过远程服务传递自定义的类对象,则该类必须实现Parcelable接口,过程如下:

  • 创建.aidl文件,声明类

      //Rect.aidl
      package com.thea.aidl;
    
      parcelable Rect;
    
  • 实现其writeToParcel()方法

  • 初始化类型为Parcelable.Creator<T>的静态变量CREATOR。

      //Rect.java
      import android.os.Parcel;
      import android.os.Parcelable;
    
      public final class Rect implements Parcelable {
          public int left;
          public int top;
          public int right;
          public int bottom;
      
          public static final Parcelable.Creator<Rect> CREATOR = 
              new Parcelable.Creator<Rect>() {
                  public Rect createFromParcel(Parcel in) {
                      return new Rect(in);
                  }
          
                  public Rect[] newArray(int size) {
                      return new Rect[size];
                  }
          };
      
          public Rect() {
          }
      
          private Rect(Parcel in) {
              readFromParcel(in);
          }
      
          public void writeToParcel(Parcel out) {
              out.writeInt(left);
              out.writeInt(top);
              out.writeInt(right);
              out.writeInt(bottom);
          }
      
          public void readFromParcel(Parcel in) {
              left = in.readInt();
              top = in.readInt();
              right = in.readInt();
              bottom = in.readInt();
          }
      }
    

RemoteCallbackList(远程接口回调)

客户端通过ServiceConnection对象获取返回的IBinder对象,从而调用远程Service的方法。

Service通过客户端注册的回调来调用客户端的方法。RemoteCallbackList就是用来保存注册进来的回调实例,它自动处理了Link-To-Death的问题,当客户端意外退出时,自动删掉对应的实例。

注册回调过程如下:

  • 创建.aidl文件,声明回调接口

      // ICallback.aidl
      package com.thea.aidl;        
      
      interface ICallback {
      
          void onSuccess(in Bundle data);
      
          void onFail(int errCode);
      }
    
  • 在Service中定义RemoteCallbackList变量,在IBinder里实现回调注册方法

      public class RemoteService extends Service {  
          ...
          private RemoteCallbackList<ICallback> mCallbacks = new RemoteCallbackList<>();
      
          private final IRemoteService.Stub mBinder = new IRemoteService.Stub() {
              ...
              @Override        
              public void registerCallback(ICallback cb) throws RemoteException {
                  mCallbacks.register(cb);
              }
      
              @Override        
              public void unregisterCallback(ICallback cb) throws RemoteExceptio {
                  mCallbacks.unregister(cb);
              }
      
              @Override        
              public void call(Bundle data) throws RemoteException {
                  final int len = mCallbacks.beginBroadcast();
                  for (int i = 0; i < len; i++) {
                      try {
                          // 通知回调            
                          mCallbacks.getBroadcastItem(i).onSuccess(data);
                      } catch (RemoteException e) {
                          e.printStackTrace();
                      }
                  }
                  mCallbacks.finishBroadcast();                    
              }
          };
      }
    
  • 客户端实现回调接口,并注册到RemoteService

      public class MainActivity extends AppCompatActivity {
          private final ICallback.Stub mCallback = new ICallback.Stub() {
              public void onSuccess(Bundle data) {
              }
      
              public void onFail(int errCode) {
              }
          };
    
          @Override
          protected void onCreate(Bundle savedInstanceState) {
              super.onCreate(savedInstanceState);
              setContentView(R.layout.activity_main);
              
              registerCallback();
          }
    
          @Override
          public void onDestroy() {            
              super.onDestroy();
              unregisterCallback();            
          }
    
          public void click(View v) {
              mIRemoteService.call(new Bundle()); //会触发onSuccess(Bundle)
          }
    
          public void registerCallback() {
              mIRemoteService.registerCallback(mCallback);
          }
    
          public void unregisterCallback() {
              mIRemoteService.unregisterCallback(mCallback);
          }
      }
    

参考资料

Android Interface Definition Language (AIDL)

Android AIDL使用详解

与Sevice实现双向通信

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,670评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,928评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,926评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,238评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,112评论 4 356
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,138评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,545评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,232评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,496评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,596评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,369评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,226评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,600评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,906评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,185评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,516评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,721评论 2 335

推荐阅读更多精彩内容