Android Framework AIDL的使用_istatusbar.aidl

    AIDL——Android Interface Definition Language,是一种接口定义语言，用于生成可以在Android设备上两个进程间进行通信的代码。Android Java Service Framework提供的大多数系统服务都是使用AIDL语言生成的。使用AIDL语言，可以自动生成服务接口、服务代理、服务Stub代码。下面我们看看Android framework中使用的aidl.

AIDL支持的数据类型有如下几种：

(1)Java原生类型(int , double, boolean等)、String、CharSequence类：不需要使用import语句。

(2)List、Map类：容器类(container)中的元素必须是Java基本类型、String、CharSequence、AIDL生成的接口类型或Parcelable类型。

以frameworks/base/core/java/com/android/internal/statusbar/IStatusBar.aidl为例

package com.android.internal.statusbar;
 
oneway interface IStatusBar
{
    void setIcon(String slot, in StatusBarIcon icon);
    ......
}

接口声明语句形式为：

interface_header  识别符(identier) 

 {

          interface_items

}

在AIDL语言的接口语法中，有两个Java接口语法不具备的特征。

(1)interface_header可以是"interface" 或者 "oneway interface"。关键字"oneway"表示当服务用户请求相应功能时不需要等待应答可以直接调用返回，可以用于接口声明或方法声明语句中。若接口声明语句使用了"oneway"关键字，则该接口中声明的所有方法都采用了oneway方式。

(2)参数前面的" in "关键字，当服务用户调用服务方法时，该关键字表示相关参数传递的方向。传递方向指示符共有三种:in , out , inout , "in"表示参数要传递到服务方法内部，"out"表示将值返回到服务方法的调用端，"inout"表示传送相应值并接收返回值。

AIDL文件需要在Makefile文件中引入：

frameworks/base/Android.mk

LOCAL_SRC_FILES += \
......
core/java/com/android/internal/statusbar/IStatusBar.aidl \
......

AIDL编译后会自动生成IStatusBar.java文件，类似下面的代码：

public interface IStatusBarextends android.os.IInterface
{
public static abstract class Stub extends android.os.Binder implements com.android.internal.statusbar.IStatusBar{
......
public Stub()
{
this.attachInterface(this, DESCRIPTOR);
}
 
public static com.android.internal.statusbar.IStatusBar asInterface(android.os.IBinder obj)
{
if ((obj==null)) {
return null;
}
android.os.IInterface iin = obj.queryLocalInterface(DESCRIPTOR);
if (((iin!=null)&&(iin instanceof com.android.internal.statusbar.IStatusBar))) {
return ((com.android.internal.statusbar.IStatusBar)iin);
}
return com.android.internal.statusbar.IStatusBar.Stub.Proxy(obj);
}
 
@Override public android.os.IBinder asBinder()
{
return this;
}
 
@Override public boolean onTransact(int code, android.os.Parcel data, android.os.Parcel reply, int flags) throws android.os.RemoteException
{
......
case TRANSACTION_setIcon:
{
    ......
}
}
 
private static class Proxy implements com.android.internal.statusbar.IStatusBar{
private android.os.IBinder mRemote;
Proxy(android.os.IBinder remote)
{
mRemote = remote;
}
@Override public android.os.IBinder asBinder()
{
return mRemote;
}
public java.lang.String getInterfaceDescriptor()
{
return DESCRIPTOR;
}
@Override public void setIcon(java.lang.String data) throws android.os.RemoteException{
    ......
}
public void setIcon(java.lang.String data) throws android.os.RemoteException;
}

    IStatusBar.java文件中有服务接口、服务Stub、服务代理类。Stub类的onTransact()方法从服务用户端接收RPC数据，并调用相应的方法.TRANSACTION_setIcon时setIcon()方法的RPC代码，RPC代码的生成规则以“TRANSACTION_方法名”形式出现。

下面就是创建一个继承Stub的类并实现.aidl文件中声明的方法setIcon()了。

frameworks/base/packages/SystemUI/src/com/android/systemui/statusbar/CommandQueue.java

public class CommandQueue extends IStatusBar.Stub {
......
public void setIcon(String slot, StatusBarIcon icon) {
    	synchronized (mLock) {
          	// don't coalesce these
         	 mHandler.obtainMessage(MSG_ICON, OP_SET_ICON, 0,
                  new Pair<String, StatusBarIcon>(slot, icon)).sendToTarget();
      	}
}
......
}

    到这里所需要的服务就生成了，而服务用户要使用这些服务就需要通过编译器自动生成的Proxy类了，如IStatusBar.java中的代码。Proxy类实现了IStatusBar接口，并生成调用服务setIcon()方法的RPC数据。RPC数据中表示：调用setIcon()方法的RPC代码（TRANSACTION_setIcon）以及IStatusBar接口信息将作为参数传递给BinderProxy的transact()方法，而后通过Binder IPC将RPC数据传递给CommandQueue服务，调用服务的setIcon()方法。