AIDL-Android中的远程接口

    在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 

Java代码   

1. package com.cmcc.demo;  
2.   
3.    
4.   
5. import com.cmcc.demo.ITaskCallback;  
6.   
7.    
8.   
9. interface ITaskBinder {  
10.   
11.       
12.   
13.     boolean isTaskRunning();  
14.   
15.           
16.   
17.     void stopRunningTask();      
18.   
19.       
20.   
21.     void registerCallback(ITaskCallback cb);      
22.   
23.      
24.   
25.     void unregisterCallback(ITaskCallback cb);  
26.   
27. }  

其中: ITaskCallback在文件ITaskCallback.aidl中定义: 

Java代码   

1. package com.cmcc.demo;  
2.   
3.    
4.   
5. interface ITaskCallback {  
6.   
7.     void actionPerformed(int actionId);  
8.   
9. }  

注意: 理论上, 参数可以传递基本数据类型和String, 还有就是Bundle的派生类,不过在Eclipse中,目前的ADT不支持Bundle做为参数, 据说用Ant编译可以,我没做尝试. 

2、编译AIDL文件, 用Ant的话, 可能需要手动, 使用Eclipseplugin的话,可以根据adil文件自动生产java文件并编译, 不需要人为介入. 

3、在Java文件中, 实现AIDL中定义的接口. 编译器会根据AIDL接口,产生一个JAVA接口。这个接口有一个名为Stub的内部抽象类，它继承扩展了接口并实现了远程调用需要的几个方法。接下来就需要自己去实现自定义的几个接口了. 

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

Java代码   

1. private final ITaskBinder.Stub mBinder = new ITaskBinder.Stub() {  
2.   
3.         public void stopRunningTask() {  
4.   
5.             //@TODO  
6.   
7.         }  
8.   
9.           
10.   
11.         public boolean isTaskRunning() {  
12.   
13.             //@TODO  
14.   
15.             return false;  
16.   
17.         }   
18.   
19.           
20.   
21.         public void registerCallback(ITaskCallback cb) {  
22.   
23.             if (cb != null) mCallbacks.register(cb);  
24.   
25.         }  
26.   
27.         public void unregisterCallback(ITaskCallback cb) {  
28.   
29.             if (cb != null) mCallbacks.unregister(cb);  
30.   
31.         }  
32.   
33. };  

在MyActivity.java中ITaskCallback.aidl接口实现: 

Java代码   

1. private ITaskCallback mCallback = new ITaskCallback.Stub() {  
2.   
3.         public void actionPerformed(int id) {  
4.   
5.            //TODO  
6.   
7.             printf("callback id=" + id);  
8.   
9.         }  
10.   
11. };  

4、向客户端提供接口ITaskBinder, 如果写的是service，扩展该Service并重载onBind()方法来返回一个实现上述接口的类的实例。这个地方返回的mBinder,就是上面通过内嵌了定义的那个.(MyService.java) 

Java代码   

1. public IBinder onBind(Intent t) {  
2.   
3.     printf("service on bind");  
4.   
5.     return mBinder;  

在Activity中, 可以通过Binder定义的接口, 来进行远程调用. 

5、在服务器端回调客户端的函数. 前提是当客户端获取的IBinder接口的时候,要去注册回调函数, 只有这样,服务器端才知道该调用那些函数在:MyService.java中: 

Java代码   

1. void callback(int val) {  
2.   
3.     final int N = mCallbacks.beginBroadcast();  
4.   
5.     for (int i=0; i<N; i++) {  
6.   
7.         try {  
8.   
9.             mCallbacks.getBroadcastItem(i).actionPerformed(val);  
10.   
11.         } catch (RemoteException e) {  
12.   
13.             // The RemoteCallbackList will take care of removing  
14.   
15.             // the dead object for us.  
16.   
17.         }  
18.   
19.     }  
20.   
21.     mCallbacks.finishBroadcast();  

AIDL的创建方法: 

AIDL语法很简单,可以用来声明一个带一个或多个方法的接口，也可以传递参数和返回值。 由于远程调用的需要,这些参数和返回值并不是任何类型.下面是些AIDL支持的数据类型: 

1. 不需要import声明的简单Java编程语言类型(int,boolean等) 
2. String, CharSequence不需要特殊声明 

3. List, Map和Parcelables类型, 这些类型内所包含的数据成员也只能是简单数据类型,String等其他比支持的类型. 
( 
(另外: 我没尝试Parcelables, 在Eclipse+ADT下编译不过,或许以后会有所支持). 
下面是AIDL语法: 
// 文件名: SomeClass.aidl 
// 文件可以有注释, 跟java的一样 
// 在package以前的注释, 将会被忽略. 
// 函数和变量以前的注释, 都会被加入到生产java代码中. 

Java代码   

1. package com.cmcc.demo;  
2.  // import 引入语句  
3.   
4. import com.cmcc.demo.ITaskCallback;  
5.   
6.    
7.   
8. interface ITaskBinder {  
9.   
10.     //函数跟java一样, 可以有0到多个参数 ,可以有一个返回值  
11.   
12.     boolean isTaskRunning();  
13.   
14.           
15.   
16.     void stopRunningTask();      
17.   
18.     //参数可以是另外的一个aidl定义的接口  
19.   
20.     void registerCallback(ITaskCallback cb);      
21.   
22.      
23.   
24. void unregisterCallback(ITaskCallback cb);  
25.   
26. //参数可以是String, 可以用in表入输入类型, out表示输出类型.  
27. int getCustomerList(in String branch, out String[] customerList);  
28.   
29.    
30. }   

实现接口时有几个原则: 
.抛出的异常不要返回给调用者. 跨进程抛异常处理是不可取的. 
.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() 



下面是整个程序: 

Java代码