Android AIDL 分析 例子 源码


在Android中, 每个应用程序都可以有自己的进程. 在写UI应用的时候, 经常要用到Service. 在不同的进程中, 怎样传递对象呢? 显然, Java中不允许跨进程内存共享. 因此传递对象, 只能把对象拆分成操作系统能理解的简单形式, 以达到跨界对象访问的目的. 在J2EE中,采用RMI的方式, 可以通过序列化传递对象. 在Android中, 则采用AIDL的方式. 理论上AIDL可以传递Bundle,实际上做起来却比较麻烦. 

AIDL(AndRoid接口描述语言)是一种借口描述语言; 编译器可以通过aidl文件生成一段代码，通过预先定义的接口达到两个进程内部通信进程的目的. 如果需要在一个Activity中, 访问另一个Service中的某个对象, 需要先将对象转化成AIDL可识别的参数(可能是多个参数), 然后使用AIDL来传递这些参数, 在消息的接收端, 使用这些参数组装成自己需要的对象. 

AIDL的IPC的机制和COM或CORBA类似, 是基于接口的，但它是轻量级的。它使用代理类在客户端和实现层间传递值. 如果要使用AIDL, 需要完成2件事情: 1. 引入AIDL的相关类.; 2. 调用aidl产生的class. 

具体实现步骤如下: 

1、创建AIDL文件, 在这个文件里面定义接口, 该接口定义了可供客户端访问的方法和属性。 如: ITaskBinder.adil 

  1. package com.cmcc.demo;   
  2.   
  3. import com.cmcc.demo.ITaskCallback;   
  4.   
  5. interface ITaskBinder {   
  6.   
  7. boolean isTaskRunning();   
  8. void stopRunningTask();   
  9. void registerCallback(ITaskCallback cb);   
  10. void unregisterCallback(ITaskCallback cb); }  
其中: ITaskCallback在文件ITaskCallback.aidl中定义: 
  1. package com.cmcc.demo;   
  2.   
  3. interface ITaskCallback {   
  4. void actionPerformed(int actionId); }  
注意: 理论上, 参数可以传递基本数据类型和String, 还有就是Bundle的派生类, 不过在Eclipse中,目前的ADT不支持Bundle做为参数, 据说用Ant编译可以, 我没做尝试. 
2、编译AIDL文件, 用Ant的话, 可能需要手动, 使用Eclipse plugin的话,可以根据adil文件自动生产java文件并编译, 不需要人为介入. 
3、在Java文件中, 实现AIDL中定义的接口. 编译器会根据AIDL接口, 产生一个JAVA接口。这个接口有一个名为Stub的内部抽象类，它继承扩展了接口并实现了远程调用需要的几个方法。接下来就需要自己去实现自定义的几个接口了. 

ITaskBinder.aidl中接口的实现, 在MyService.java中接口以内嵌类的方式实现: 

private final ITaskBinder.Stub mBinder = new ITaskBinder.Stub() {

  1. public void stopRunningTask() { //@TODO }    
  2.   
  3. public boolean isTaskRunning() { //@TODO return false; }    
  4.   
  5. public void registerCallback(ITaskCallback cb) { if (cb != null) mCallbacks.register(cb);} public void unregisterCallback(ITaskCallback cb) { if (cb != null)mCallbacks.unregister(cb); } };   
在MyActivity.java中ITaskCallback.aidl接口实现: 
  1. private ITaskCallback mCallback = new ITaskCallback.Stub() {   
  2. public void actionPerformed(int id) { //TODO printf("callback id=" + id); } };   
4、向客户端提供接口ITaskBinder, 如果写的是service，扩展该Service并重载onBind ()方法来返回一个实现上述接口的类的实例。这个地方返回的mBinder,就是上面通过内嵌了定义的那个. (MyService.java) 
  1. public IBinder onBind(Intent t) { printf("service on bind"); return mBinder; }   
在Activity中, 可以通过Binder定义的接口, 来进行远程调用. 
5、在服务器端回调客户端的函数. 前提是当客户端获取的IBinder接口的时候,要去注册回调函数, 只有这样, 服务器端才知道该调用那些函数在:MyService.java中: 
  1. void callback(int val) {  
  2. final int N = mCallbacks.beginBroadcast();  
  3. for (int i=0; i<N; i++) {  
  4. try {  
  5. mCallbacks.getBroadcastItem(i).actionPerformed(val);  
  6. } catch (RemoteException e) {  
  7. // The RemoteCallbackList will take care of removing   
  8. // the dead object for us.   
  9. }  
  10. }  
  11. mCallbacks.finishBroadcast();  
  12. }  
AIDL的创建方法: 
AIDL语法很简单,可以用来声明一个带一个或多个方法的接口，也可以传递参数和返回值。由于远程调用的需要, 这些参数和返回值并不是任何类型.下面是些AIDL支持的数据类型: 
1. 不需要import声明的简单Java编程语言类型(int,boolean等) 
2. String, CharSequence不需要特殊声明 
3. List, Map和Parcelables类型, 这些类型内所包含的数据成员也只能是简单数据类型, String等其他比支持的类型. 
下面是AIDL语法: 
  1. interface ITaskBinder {   
  2. //函数跟java一样, 可以有0到多个参数 ,可以有一个返回值 boolean isTaskRunning();    
  3. void stopRunningTask(); //参数可以是另外的一个aidl定义的接口 void registerCallback(ITaskCallback cb);    
  4. void unregisterCallback(ITaskCallback cb);   
  5. //参数可以是String, 可以用in表入输入类型, out表示输出类型.    
  6. int getCustomerList(in String branch, out String customerList);   
  7. }   
实现接口时有几个原则: 
.抛出的异常不要返回给调用者. 跨进程抛异常处理是不可取的. 
.IPC调用是同步的。如果你知道一个IPC服务需要超过几毫秒的时间才能完成地话，你应该避免在Activity的主线程中调用。 也就是IPC调用会挂起应用程序导致界面失去响应. 这种情况应该考虑单起一个线程来处理. 
.不能在AIDL接口中声明静态属性。 

IPC的调用步骤: 
1. 声明一个接口类型的变量，该接口类型在.aidl文件中定义。 
2. 实现ServiceConnection。 
3. 调用ApplicationContext.bindService(),并在ServiceConnection实现中进行传递. 
4. 在ServiceConnection.onServiceConnected()实现中，你会接收一个IBinder实例(被调用的Service). 调用 YourInterfaceName.Stub.asInterface((IBinder)service)将参数转换为YourInterface类型。 
5. 调用接口中定义的方法。 你总要检测到DeadObjectException异常，该异常在连接断开时被抛出。它只会被远程方法抛出。 
6. 断开连接，调用接口实例中的ApplicationContext.unbindService() 

整个源码程序如下所示: 
1. ITaskCallback.aidl 
  1. package com.cmcc.demo;   
  2.   
  3. interface ITaskCallback {   
  4. void actionPerformed(int actionId); }   
2. ITaskBinder.aidl 
  1. package com.cmcc.demo;   
  2.   
  3. import com.cmcc.demo.ITaskCallback;   
  4.   
  5. interface ITaskBinder {   
  6.   
  7. boolean isTaskRunning();   
  8. void stopRunningTask();   
  9. void registerCallback(ITaskCallback cb);   
  10. void unregisterCallback(ITaskCallback cb); }  
3. MyService.java 
  1. package com.cmcc.demo;   
  2.   
  3. import android.app.Service;   
  4. import android.content.Intent;   
  5. import android.os.IBinder;   
  6. import android.os.RemoteCallbackList;   
  7. import android.os.RemoteException;   
  8. import android.util.Log;   
  9.   
  10. public class MyService extends Service {   
  11.   
  12. @Override public void onCreate() { printf("service create"); }   
  13. @Override public void onStart(Intent intent, int startId) { printf("service start id=" +startId); callback(startId); }   
  14. @Override public IBinder onBind(Intent t) { printf("service on bind"); return mBinder; }   
  15. @Override public void onDestroy() { printf("service on destroy"); super.onDestroy(); }   
  16. @Override public boolean onUnbind(Intent intent) { printf("service on unbind"); returnsuper.onUnbind(intent); }   
  17. public void onRebind(Intent intent) { printf("service on rebind");super.onRebind(intent); }   
  18. private void printf(String str) { Log.e("TAG", "###################------ " + str + "------"); }   
  19. void callback(int val) { final int N = mCallbacks.beginBroadcast(); for (int i=0; i<N;i++) { try { mCallbacks.getBroadcastItem(i).actionPerformed(val); } catch(RemoteException e) { // The RemoteCallbackList will take care of removing // the dead object for us. } } mCallbacks.finishBroadcast(); }    
  20.   
  21. private final ITaskBinder.Stub mBinder = new ITaskBinder.Stub() { public voidstopRunningTask() {   
  22. }   
  23. public boolean isTaskRunning() { return false; }   
  24. public void registerCallback(ITaskCallback cb) { if (cb != null) mCallbacks.register(cb);} public void unregisterCallback(ITaskCallback cb) { if (cb != null)mCallbacks.unregister(cb); } };   
  25. final RemoteCallbackList  
  26. <itaskcallback>mCallbacks = new RemoteCallbackList  
  27. <itaskcallback>(); }   
4. MyActivity.java 
  1. package com.cmcc.demo;   
  2.   
  3. import android.app.Activity;   
  4. import android.content.ComponentName;   
  5. import android.content.Context;   
  6. import android.content.Intent;   
  7. import android.content.ServiceConnection;   
  8. import android.graphics.Color;   
  9. import android.os.Bundle;   
  10. import android.os.IBinder;   
  11. import android.os.RemoteException;   
  12. import android.util.Log;   
  13. import android.view.View;   
  14. import android.view.ViewGroup;   
  15. import android.view.View.OnClickListener;   
  16. import android.widget.AbsoluteLayout;   
  17. import android.widget.Button;   
  18. import android.widget.LinearLayout;   
  19. import android.widget.RelativeLayout;   
  20. import android.widget.TextView;   
  21.   
  22. import java.io.BufferedReader;   
  23. import java.io.File;   
  24. import java.io.FileOutputStream;   
  25. import java.io.FileReader;   
  26. import java.io.PrintWriter;   
  27.   
  28. public class MyActivity extends Activity {   
  29.   
  30. private Button btnOk; private Button btnCancel;   
  31. @Override public void onCreate(Bundle icicle) { super.onCreate(icicle);   
  32. setContentView(R.layout.test_service);   
  33. btnOk = (Button)findViewById(R.id.btn_ok); btnCancel =(Button)findViewById(R.id.btn_cancel);   
  34. btnOk.setText("Start Service"); btnCancel.setTag("Stop Service");   
  35. btnOk.setOnClickListener(new OnClickListener() { public void onClick(View v) {onOkClick(); } });   
  36. btnCancel.setOnClickListener(new OnClickListener() { public void onClick(View v) {onCancelClick(); } }); }   
  37. void onOkClick() { Bundle args = new Bundle();   
  38. Intent intent = new Intent(this, MyService.class); intent.putExtras(args);   
  39. //printf("send intent to start");    
  40.   
  41. //startService(intent); bindService(intent, mConnection, Context.BIND_AUTO_CREATE); startService(intent); }    
  42.   
  43. void onCancelClick() { Intent intent = new Intent(this, MyService.class); //printf("send intent to stop");    
  44.   
  45. unbindService(mConnection); //stopService(intent); }    
  46.   
  47. private void printf(String str) { Log.e("TAG", "###################------ " + str + "------"); }   
  48. ITaskBinder mService;   
  49. private ServiceConnection mConnection = new ServiceConnection() { public voidonServiceConnected(ComponentName className, IBinder service) { mService =ITaskBinder.Stub.asInterface(service); try { mService.registerCallback(mCallback); }catch (RemoteException e) { }   
  50. }   
  51. public void onServiceDisconnected(ComponentName className) { mService = null; } };   
  52. private ITaskCallback mCallback = new ITaskCallback.Stub() { public voidactionPerformed(int id) { printf("callback id=" + id); } }; }   

5. xml文件(略) 

相关内容