一、什么是AIDL服务
一般创建的服务并不能被其他的应用程序访问。为了使其他的应用程序也可以访问本应用程序提供的服务,Android系统采用了远程过程调用(Remote Procedure Call,RPC)方式来实现。与很多其他的基于RPC的解决方案一样,Android使用一种接口定义语言(Interface Definition Language,IDL)来公开服务的接口。因此,可以将这种可以跨进程访问的服务称为AIDL(Android Interface Definition Language)服务。
二、AIDL基本语法
AIDL使用简单的语法来声明接口,描述其方法以及方法的参数和返回值。这些参数和返回值可以是任何类型,甚至是其他AIDL生成的接口。
其中对于Java编程语言的基本数据类型 (int, long, char, boolean,String,CharSequence)集合接口类型List和Map,不需要import 语句。
而如果需要在AIDL中使用其他AIDL接口类型,需要import,即使是在相同包结构下。AIDL允许传递实现Parcelable接口的类,需要import
需要特别注意的是,对于非基本数据类型,也不是String和CharSequence类型的,需要有方向指示,包括in、out和inout,in表示由客户端设置,out表示由服务端设置,inout是两者均可设置。
AIDL只支持接口方法,不能公开static变量。
三、android应用层使用AIDL
3.1、简要步骤
1、在Eclipse Android工程的Java包目录中建立一个扩展名为A.aidl的文件,并写下需要的接口。如果aidl文件的内容是正确的,ADT会在gen目录下自动生成一个A.Java接口文件。
2、建立一个服务类(Service的子类)。并在创建的服务类中创建一个内部类,实现由aidl文件生成的Java接口。
3、在服务类的onBind方法返回时,将实现aidl接口的内部类对象返回出去。
4、在AndroidManifest.xml文件中配置AIDL服务,尤其要注意的是,
3.2、具体操作
3.2.1、创建文件IMyService.aidl:
文件内容:
- package du.pack;
- interface IMyService{
- //只有一个接口
- String getValue();
- }
3.2.2、创建服务类及实现内部类
- public class MyService extends Service {
- @Override
- public IBinder onBind(Intent arg0) {
- // 把内部类的对象返回给客户端使用
- return new MyServiceImpl();
- }
- // 创建一个继承自IMyService.Stub的内部类
- public class MyServiceImpl extends IMyService.Stub {
- // 必须实现AIDL文件中的接口
- public String getValue() throws RemoteException {
- return null;
- }
- }
- }
注意,我们写的service中,onBind方法必须返回MyServiceImpl类的对象实例,否则客户端无法获得服务对象。
3.2.3、在AndroidManifest.xml文件中配置MyService类
- <service android:name=".MyService" >
- <intent-filter>
- <action android:name="du.pack.IMyService" />
- intent-filter>
- service>
上面的"du.pack.IMyService"是客户端用于访问AIDL服务的ID。
4、本地客户端的使用方法
4.1、新建一个Eclipse Android工程,并将刚才远程服务端自动生成的gen目录下面的IMyService.java文件连同包目录一起复制到客户端工程的src目录中。
4.2、调用AIDL服务首先要绑定服务,然后才能获得服务对象。
- public class AidlClientTestActivity extends Activity {
- // 远程服务端的对象
- IMyService mIMyService;
- private ServiceConnection mConnection = new ServiceConnection() {
- public void onServiceConnected(ComponentName name, IBinder service) {
- // 绑定成功,得到远程服务端的对象,目标完成!!!
- mIMyService = IMyService.Stub.asInterface(service);
- }
- public void onServiceDisconnected(ComponentName name) {
- // 解除绑定
- mIMyService = null;
- }
- };
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- // 绑定远程服务端服务
- Intent serviceIntent = new Intent("du.pack.IMyService");
- bindService(serviceIntent, mConnection, Context.BIND_AUTO_CREATE);
- }
- }
5、用法小结
回顾一下整个调用的过程:
服务端方面:将需要开放的接口抽象到aidl文件中,然后在自己的内部类中对接口进行实现,并在自己被绑定的时候把内部类对象返回给客户端。客户端方面:当我们需要远程某个Service时,就像在绑定本地的Service一样去bindService,然后在绑定成功的回调函数中(也就是onServiceConnected方法)得到一个Ibinder对象(比如Service),这时调用IMyService.Stub.asInterface(service)这样的语句,就可以得到服务端开放的interface接口对象,此时客户端可以直接调用这个对象的方法,犹如直接调用远程的Service对象一般。
四、Framework中使用AIDL
Framework中使用AIDL我们通过ITelephonyRegistry这个SystemService进行分析。该服务的主要作用就是对通话相关的事件进行监听,我们重心放在AIDL的实现结构上,不去关注ITelephonyRegistry具体的实现。
1、AIDL文件相关
先来看一下这个服务的AIDL文件:
- @ITelephonyRegistry.aidl
- interface ITelephonyRegistry {
- void listen(String pkg, IPhoneStateListener callback, int events, boolean notifyNow);
- void notifyCallState(int state, String incomingNumber);
- void notifyServiceState(in ServiceState state);
- void notifySignalStrength(in SignalStrength signalStrength);
- void notifyMessageWaitingChanged(boolean mwi);
- }
再来看这个服务的真正实现:
- @TelephonyRegistry.java
- class TelephonyRegistry extends ITelephonyRegistry.Stub {
- TelephonyRegistry(Context context) {
- ......
- }
- void listen(String pkg, IPhoneStateListener callback, int events, boolean notifyNow){
- ......
- }
- void notifyCallState(int state, String incomingNumber){
- ......
- }
- void notifyServiceState(in ServiceState state){
- ......
- }
- void notifySignalStrength(in SignalStrength signalStrength){
- ......
- }
- void notifyMessageWaitingChanged(boolean mwi){
- ......
- }
- }
上面的两个文件是这个服务的核心部分,aidl文件规定了这个服务的功能,而java文件是对功能的具体实现。但是,此时的TelephonyRegistry并没有继承Service的类,也就是说,当前他并不具备作为一个Service的资格。那么他是如何变成一个服务的呢?
2、服务的注册过程
在SystemService中可以找到答案。
- @SystemServer.java
- class ServerThread extends Thread {
- @Override
- public void run() {
- try {
- telephonyRegistry = new TelephonyRegistry(context);
- ServiceManager.addService("telephony.registry", telephonyRegistry);
- }
- }
- }
我们看到,在这一步中,把telephonyRegistry对象(也就是ITelephonyRegistry.Stub的子类对象)作为一个Service注册给了ServiceManager。并且注册的名字是“telephony.registry”
有了这一步,TelephonyRegistry就可以作为服务提供者向客户端开放了。也就是说,有了这一步,TelephonyRegistry才算上是一个真正的Service,可以接受客户端的连接申请。
那么接下来,我们怎么得到这个Service呢?
3、如何得到注册的服务
既然通过ServiceManager注册了服务,我们就需要再次通过ServiceManager得到它的服务对象。
- private ITelephonyRegistry sRegistry;
- sRegistry = ITelephonyRegistry.Stub.asInterface(ServiceManager.getService("telephony.registry"));
通过这样的方法,我们就得到了ITelephonyRegistry.aidl的对象sRegistry。
4、流程总结
回顾一下这种AIDL服务的框架:通过继承ITelephonyRegistry.Stub父类去实现AIDL中规定的接口,然后把TelephonyRegistry作为ServiceManager注册给SystemService。客户端可以通过ServiceManager得到TelephonyRegistry的对象,然后就可以去调用AIDL中定义的接口了。