Android: AIDL --- Android中的远程接口
http://labs.chinamobile.com/community/my_blog/517/4850
AIDL(AndRoid接口描述语言)是一种借口描述语言; 编译器可以通过aidl文件生成一段代码，通过预先定义的接口达到两个进程内部通信进程的目的. 如果需要在一个Activity中, 访问另一个Service中的某个对象, 需要先将对象转化成AIDL可识别的参数(可能是多个参数), 然后使用AIDL来传递这些参数, 在消息的接收端, 使用这些参数组装成自己需要的对象.
AIDL的IPC的机制和COM或CORBA类似, 是基于接口的，但它是轻量级的。它使用代理类在客户端和实现层间传递值. 如果要使用AIDL, 需要完成2件事情: 1. 引入AIDL的相关类.; 2. 调用aidl产生的class.
具体实现步骤如下:
1、创建AIDL文件, 在这个文件里面定义接口, 该接口定义了可供客户端访问的方法和属性。 如: ITaskBinder.adil
package com.cmcc.demo;
import com.cmcc.demo.ITaskCallback;
interface ITaskBinder {
boolean isTaskRunning();
void stopRunningTask();
void registerCallback(ITaskCallback cb);
void unregisterCallback(ITaskCallback cb);
}
其中: ITaskCallback在文件ITaskCallback.aidl中定义:
package com.cmcc.demo;
interface ITaskCallback {
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中接口以内嵌类的方式实现:
privatefinalITaskBinder.Stub mBinder =newITaskBinder.Stub() {
publicvoidstopRunningTask() {
//@TODO
}
publicbooleanisTaskRunning() {
//@TODO
returnfalse;
}
publicvoidregisterCallback(ITaskCallback cb) {
if(cb !=null) mCallbacks.register(cb);
}
publicvoidunregisterCallback(ITaskCallback cb) {
if(cb !=null) mCallbacks.unregister(cb);
}
};
在MyActivity.java中ITaskCallback.aidl接口实现:
privateITaskCallback mCallback =newITaskCallback.Stub() {
publicvoidactionPerformed(intid) {
//TODO
printf("callback id=" + id);
}
};
4、向客户端提供接口ITaskBinder, 如果写的是service，扩展该Service并重载onBind ()方法来返回一个实现上述接口的类的实例。这个地方返回的mBinder,就是上面通过内嵌了定义的那个. (MyService.java)
publicIBinder onBind(Intent t) {
printf("service on bind");
returnmBinder;
}
在Activity中, 可以通过Binder定义的接口, 来进行远程调用.
5、在服务器端回调客户端的函数. 前提是当客户端获取的IBinder接口的时候,要去注册回调函数, 只有这样, 服务器端才知道该调用那些函数在:MyService.java中:
voidcallback(intval) {
finalintN = mCallbacks.beginBroadcast();
for(inti=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();
}
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代码中.
package com.cmcc.demo;
// import 引入语句
import com.cmcc.demo.ITaskCallback;
interface ITaskBinder {
//函数跟java一样, 可以有0到多个参数 ,可以有一个返回值
boolean isTaskRunning();
void stopRunningTask();
//参数可以是另外的一个aidl定义的接口
void registerCallback(ITaskCallback cb);
void unregisterCallback(ITaskCallback cb);
//参数可以是String, 可以用in表入输入类型, out表示输出类型.
int getCustomerList(in String branch, out String[] customerList);
}
.抛出的异常不要返回给调用者. 跨进程抛异常处理是不可取的.
.IPC调用是同步的。如果你知道一个IPC服务需要超过几毫秒的时间才能完成地话，你应该避免在Activity的主线程中调用。 也就是IPC调用会挂起应用程序导致界面失去响应. 这种情况应该考虑单起一个线程来处理.
.不能在AIDL接口中声明静态属性。
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
package com.cmcc.demo;
interface ITaskCallback {
void actionPerformed(int actionId);
}
2. ITaskBinder.aidl
package com.cmcc.demo;
import com.cmcc.demo.ITaskCallback;
interface ITaskBinder {
boolean isTaskRunning();
void stopRunningTask();
void registerCallback(ITaskCallback cb);
void unregisterCallback(ITaskCallback cb);
}
3. MyService.java
packagecom.cmcc.demo;
importandroid.app.Service;
importandroid.content.Intent;
importandroid.os.IBinder;
importandroid.os.RemoteCallbackList;
importandroid.os.RemoteException;
importandroid.util.Log;
publicclassMyServiceextendsService {
@Override
publicvoidonCreate() {
printf("service create");
}
@Override
publicvoidonStart(Intentintent,intstartId) {
printf("service start id=" + startId);
callback(startId);
}
@Override
publicIBinder onBind(Intent t) {
printf("service on bind");
returnmBinder;
}
@Override
publicvoidonDestroy() {
printf("service on destroy");
super.onDestroy();
}
@Override
publicbooleanonUnbind(Intent intent) {
printf("service on unbind");
returnsuper.onUnbind(intent);
}
publicvoidonRebind(Intent intent) {
printf("service on rebind");
super.onRebind(intent);
}
privatevoidprintf(String str) {
Log.e("TAG", "###################------ " + str + "------");
}
voidcallback(intval) {
finalintN = mCallbacks.beginBroadcast();
for(inti=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();
}
privatefinalITaskBinder.Stub mBinder =newITaskBinder.Stub() {
publicvoidstopRunningTask() {
}
publicbooleanisTaskRunning() {
returnfalse;
}
publicvoidregisterCallback(ITaskCallback cb) {
if(cb !=null) mCallbacks.register(cb);
}
publicvoidunregisterCallback(ITaskCallback cb) {
if(cb !=null) mCallbacks.unregister(cb);
}
};
finalRemoteCallbackList<ITaskCallback> mCallbacks
=newRemoteCallbackList<ITaskCallback>();
}
4. MyActivity.java
packagecom.cmcc.demo;
importandroid.app.Activity;
importandroid.content.ComponentName;
importandroid.content.Context;
importandroid.content.Intent;
importandroid.content.ServiceConnection;
importandroid.graphics.Color;
importandroid.os.Bundle;
importandroid.os.IBinder;
importandroid.os.RemoteException;
importandroid.util.Log;
importandroid.view.View;
importandroid.view.ViewGroup;
importandroid.view.View.OnClickListener;
importandroid.widget.AbsoluteLayout;
importandroid.widget.Button;
importandroid.widget.LinearLayout;
importandroid.widget.RelativeLayout;
importandroid.widget.TextView;
importjava.io.BufferedReader;
importjava.io.File;
importjava.io.FileOutputStream;
importjava.io.FileReader;
importjava.io.PrintWriter;
publicclassMyActivityextendsActivity {
privateButton btnOk;
privateButton btnCancel;
@Override
publicvoidonCreate(Bundle icicle) {
super.onCreate(icicle);
setContentView(R.layout.test_service);
btnOk = (Button)findViewById(R.id.btn_ok);
btnCancel = (Button)findViewById(R.id.btn_cancel);
btnOk.setText("Start Service");
btnCancel.setTag("Stop Service");
btnOk.setOnClickListener(newOnClickListener() {
publicvoidonClick(View v) {
onOkClick();
}
});
btnCancel.setOnClickListener(newOnClickListener() {
publicvoidonClick(View v) {
onCancelClick();
}
});
}
voidonOkClick() {
Bundle args =newBundle();
Intent intent =newIntent(this, MyService.class);
intent.putExtras(args);
//printf("send intent to start");
//startService(intent);
bindService(intent, mConnection, Context.BIND_AUTO_CREATE);
startService(intent);
}
voidonCancelClick() {
Intent intent =newIntent(this, MyService.class);
//printf("send intent to stop");
unbindService(mConnection);
//stopService(intent);
}
privatevoidprintf(String str) {
Log.e("TAG", "###################------ " + str + "------");
}
ITaskBinder mService;
privateServiceConnection mConnection =newServiceConnection() {
publicvoidonServiceConnected(ComponentName className,
IBinder service) {
mService = ITaskBinder.Stub.asInterface(service);
try{
mService.registerCallback(mCallback);
}catch(RemoteException e) {
}
}
publicvoidonServiceDisconnected(ComponentName className) {
mService =null;
}
};
privateITaskCallback mCallback =newITaskCallback.Stub() {
publicvoidactionPerformed(intid) {
printf("callback id=" + id);
}
};
}