ANDROID AIDL

也可参考：http://buaadallas.blog.51cto.com/399160/372090 的Android AIDL(Android Interface Definition Language)介绍

 

AIDL，全称是Android Interface Definition Language（接口描述语言），主要用户Android不同进程间的通信。

 

建立AIDL服务的步骤（1）

建立AIDL服务要比建立普通的服务复杂一些，具体步骤如下：

（1）在Eclipse Android工程的Java包目录中建立一个扩展名为aidl的文件。该文件的语法类似于Java代码，但会稍有不同。详细介绍见实例52的内容。

（2）如果aidl文件的内容是正确的，ADT会自动生成一个Java接口文件（*.java）。

（3）建立一个服务类（Service的子类）。

（4）实现由aidl文件生成的Java接口。

（5）在AndroidManifest.xml文件中配置AIDL服务，尤其要注意的是，<action>标签中 android:name的属性值就是客户端要引用该服务的ID，也就是Intent类的参数值。这一点将在实例52和实例53中看到。

实例52：建立AIDL服务

AIDL服务工程目录：src/ch08/ch08_aidl

客户端程序工程目录：src/ch08/ch08_aidlclient

本例中将建立一个简单的AIDL服务。这个AIDL服务只有一个getValue方法，该方法返回一个String类型的值。在安装完服务后，会在 客户端调用这个getValue方法，并将返回值在TextView组件中输出。建立这个AIDL服务的步骤如下：

（1）建立一个aidl文件。在Java包目录中建立一个IMyService.aidl文件。IMyService.aidl文件的位置如图 8.24所示。

图8.24  IMyService.aidl文件的位置

IMyService.aidl文件的内容如下：

package net.blogjava.mobile.aidl; interface IMyService { String getValue(); }

 

IMyService.aidl文件的内容与Java代码非常相似，但要注意，不能加修饰符（例如，public、private）、AIDL服务 不支持的数据类型（例如，InputStream、OutputStream）等内容。

（2）如果IMyService.aidl文件中的内容输入正确，ADT会自动生成一个IMyService.java文件。读者一般并不需要关心 这个文件的具体内容，也不需要维护这个文件。关于该文件的具体内容，读者可以查看本节提供的源代码。

（3）编写一个MyService类。MyService是Service的子类，在MyService类中定义了一个内嵌类 （MyServiceImpl），该类是IMyService.Stub的子类。MyService类的代码如下：

package net.blogjava.mobile.aidl; import android.app.Service; import android.content.Intent; import android.os.IBinder; import android.os.RemoteException; public class MyService extends Service { public class MyServiceImpl extends IMyService.Stub { @Override public String getValue() throws RemoteException { return "Android/OPhone开发讲义"; } } @Override public IBinder onBind(Intent intent) { return new MyServiceImpl(); } }

 

在编写上面代码时要注意如下两点：

IMyService.Stub是根据IMyService.aidl文件自动生成的，一般并不需要管这个类的内容，只需要编写一个继承于 IMyService.Stub类的子类（MyServiceImpl类）即可。

onBind方法必须返回MyServiceImpl类的对象实例，否则客户端无法获得服务对象。

（4）在AndroidManifest.xml文件中配置MyService类，代码如下：

<service android:name=".MyService"> <intent-filter> <action android:name="net.blogjava.mobile.aidl.IMyService"/> </intent-filter > </service>

 

其中"net.blogjava.mobile.aidl.IMyService"是客户端用于访问AIDL服务的ID。

下面来编写客户端的调用代码。首先新建一个Eclipse Android工程（ch08_aidlclient），并将自动生成的IMyService.java文件连同包目录一起复制到 ch08_aidlclient工程的src目录中，如图8.25所示。

图8.25  IMyService.java文件 在 ch08_aidlclient工程中的位置

调用AIDL服务首先要绑定服务，然后才能获得服务对 象，代码如下：

package net.blogjava.mobile; import net.blogjava.mobile.aidl.IMyService; import android.app.Activity; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.ServiceConnection; import android.os.Bundle; import android.os.IBinder; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.TextView; public class Main extends Activity implements OnClickListener { private IMyService myService = null; private Button btnInvokeAIDLService; private Button btnBindAIDLService; private TextView textView; private ServiceConnection serviceConnection = new ServiceConnection() { @Override public void onServiceConnected(ComponentName name, IBinder service) { // 获得服务对象 myService = IMyService.Stub.asInterface(service); btnInvokeAIDLService.setEnabled(true); } @Override public void onServiceDisconnected(ComponentName name) { } }; @Override public void onClick(View view) { switch (view.getId()) { case R.id.btnBindAIDLService: // 绑定AIDL服务 bindService(new Intent("net.blogjava.mobile.aidl.IMyService"),serviceConnection, Context.BIND_AUTO_CREATE); break; case R.id.btnInvokeAIDLService: try { textView.setText(myService.getValue()); // 调用服务端的getValue方法 } catch (Exception e) { } break; } } @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); btnInvokeAIDLService = (Button) findViewById(R.id.btnInvokeAIDLService); btnBindAIDLService = (Button) findViewById(R.id.btnBindAIDLService); btnInvokeAIDLService.setEnabled(false); textView = (TextView) findViewById(R.id.textview); btnInvokeAIDLService.setOnClickListener(this); btnBindAIDLService.setOnClickListener(this); } }

使用bindService方法来绑定AIDL服务。其中需要使用Intent对象指定AIDL服务的ID，也就是<action>标 签中android:name属性的值。

在绑定时需要一个ServiceConnection对象。创建ServiceConnection对象的过程中如果绑定成功，系统会调用 onServiceConnected方法，通过该方法的service参数值可获得AIDL服务对象。

首先运行AIDL服务程序，然后运行客户端程序，单击【绑定AIDL服务】按钮，如果绑定成功，【调用AIDL服务】按钮会变为可选状态，单击这个 按钮，会输出getValue方法的返回值，如图8.26所示。

图8.26  调用AIDL服务的客户端程序

实例53：传递复杂数据的AIDL服务

AIDL服务工程目录：src/ch08/ch08_complextypeaidl

客户端程序工程目录：src/ch08/ch08_complextypeaidlclient

AIDL服务只支持有限的数据类型，因此，如果用AIDL服务传递一些复杂的数据就需要做更一步处理。AIDL服务支持的数据类型如下：

Java的简单类型（int、char、boolean等）。不需要导入（import）。

String和CharSequence。不需要导入（import）。

List和Map。但要注意，List和Map对象的元素类型必须是AIDL服务支持的数据类型。不需要导入（import）。

AIDL自动生成的接口。需要导入（import）。

实现android.os.Parcelable接口的类。需要导入（import）。

其中后两种数据类型需要使用import进行导入，将在本章的后面详细介绍。

传递不需要import的数据类型的值的方式相同。传递一个需要import的数据类型的值（例如，实现 android.os.Parcelable接口的类）的步骤略显复杂。除了要建立一个实现android.os.Parcelable接口的类外，还需 要为这个类单独建立一个aidl文件，并使用parcelable关键字进行定义。具体的实现步骤如下：

（1）建立一个IMyService.aidl文件，并输入如下代码：

package net.blogjava.mobile.complex.type.aidl; import net.blogjava.mobile.complex.type.aidl.Product; interface IMyService{ Map getMap(in String country, in Product product); Product getProduct(); }

 

在编写上面代码时要注意如下两点：

Product是一个实现android.os.Parcelable接口的类，需要使用import导入这个类。

如果方法的类型是非简单类型，例如，String、List或自定义的类，需要使用in、out或inout修饰。其中in表示这个值被客户端设 置；out表示这个值被服务端设置；inout表示这个值既被客户端设置，又被服务端设置。

 

（2）编写Product类。该类是用于传递的数据类型，代码如下：

package net.blogjava.mobile.complex.type.aidl; import android.os.Parcel; import android.os.Parcelable; public class Product implements Parcelable{ private int id; private String name; private float price; public static final Parcelable.Creator<Product> CREATOR = new Parcelable.Creator<Product>(){ public Product createFromParcel(Parcel in) { return new Product(in); } public Product[] newArray(int size) { return new Product[size]; } }; public Product() { } private Product(Parcel in) { readFromParcel(in); } @Override public int describeContents() { return 0; } public void readFromParcel(Parcel in) { id = in.readInt(); name = in.readString(); price = in.readFloat(); } @Override public void writeToParcel(Parcel dest, int flags) { dest.writeInt(id); dest.writeString(name); dest.writeFloat(price); } // 此处省略了属性的getter和setter方法 ... ... }

在编写Product类时应注意如下3点：

Product类必须实现android.os.Parcelable接口。该接口用于序列化对象。在Android中之所以使用 Pacelable接口序列化，而不是java.io.Serializable接口，是因为Google在开发Android时发现 Serializable序列化的效率并不高，因此，特意提供了一个Parcelable接口来序列化对象。

在Product类中必须有一个静态常量，常量名必须是CREATOR，而且CREATOR常量的数据类型必须是 Parcelable.Creator。

在writeToParcel方法中需要将要序列化的值写入Parcel对象。

 

（3）建立一个Product.aidl文件，并输入如下内容：

parcelable Product;

 

（4）编写一个MyService类，代码如下：

package net.blogjava.mobile.complex.type.aidl; import java.util.HashMap; import java.util.Map; import android.app.Service; import android.content.Intent; import android.os.IBinder; import android.os.RemoteException; // AIDL服务类 public class MyService extends Service { public class MyServiceImpl extends IMyService.Stub { @Override public Product getProduct() throws RemoteException { Product product = new Product(); product.setId(1234); product.setName("汽车"); product.setPrice(31000); return product; } @Override public Map getMap(String country, Product product) throws RemoteException { Map map = new HashMap<String, String>(); map.put("country", country); map.put("id", product.getId()); map.put("name", product.getName()); map.put("price", product.getPrice()); map.put("product", product); return map; } } @Override public IBinder onBind(Intent intent) { return new MyServiceImpl(); } }

 

（5）在AndroidManifest.xml文件中配置MyService类，代码如下：

<service android:name=".MyService" > <intent-filter> <action android:name="net.blogjava.mobile.complex.type.aidl.IMyService" /> </intent-filter> </service>

 

在客户端调用AIDL服务的方法与实例52介绍的方法相同，首先将IMyService.java和Product.java文件复制到客户端工程

（ch08_complextypeaidlclient），然后绑定AIDL服务，并获得AIDL服务对象，最后调用AIDL服务中的方法。完整的客户 端代码如下：

 

package net.blogjava.mobile; import net.blogjava.mobile.complex.type.aidl.IMyService; import android.app.Activity; import android.content.ComponentName; import android.content.Context; import android.content.Intent; import android.content.ServiceConnection; import android.os.Bundle; import android.os.IBinder; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.TextView; public class Main extends Activity implements OnClickListener { private IMyService myService = null; private Button btnInvokeAIDLService; private Button btnBindAIDLService; private TextView textView; private ServiceConnection serviceConnection = new ServiceConnection() { @Override public void onServiceConnected(ComponentName name, IBinder service) { // 获得AIDL服务对象 myService = IMyService.Stub.asInterface(service); btnInvokeAIDLService.setEnabled(true); } @Override public void onServiceDisconnected(ComponentName name) { } }; @Override public void onClick(View view) { switch (view.getId()) { case R.id.btnBindAIDLService: // 绑定AIDL服务 bindService(new Intent("net.blogjava. mobile.complex.type.aidl.IMyService"), serviceConnection, Context.BIND_AUTO_CREATE); break; case R.id.btnInvokeAIDLService: try { String s = ""; // 调用AIDL服务中的方法 s = "Product.id = " + myService. getProduct().getId() + "/n"; s += "Product.name = " + myService. getProduct().getName() + "/n"; s += "Product.price = " + myService. getProduct().getPrice() + "/n"; s += myService.getMap("China", myService.getProduct()).toString(); textView.setText(s); } catch (Exception e) { } break; } } @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); btnInvokeAIDLService = (Button) findViewById(R.id.btnInvokeAIDLService); btnBindAIDLService = (Button) findViewById(R.id.btnBindAIDLService); btnInvokeAIDLService.setEnabled(false); textView = (TextView) findViewById(R.id.textview); btnInvokeAIDLService.setOnClickListener(this); btnBindAIDLService.setOnClickListener(this); } }

 

首先运行服务端程序，然后运行客户端程序，单击【绑定AIDL服务】按钮，待成功绑定后，单击【调用AIDL服务】按钮，会输出如图8.27所示的 内容。