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(slot, icon)).sendToTarget();
}
}
......
}