学步园

也可参考：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;<br /> interface IMyService {<br /> String getValue();<br /> }<br />

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; </p> <p> import android.app.Service;<br /> import android.content.Intent;<br /> import android.os.IBinder;<br /> import android.os.RemoteException;<br /> public class MyService extends Service {<br /> public class MyServiceImpl extends IMyService.Stub<br /> {<br /> @Override<br /> public String getValue() throws RemoteException<br /> {<br /> return "Android/OPhone开发讲义";<br /> }<br /> }<br /> @Override<br /> public IBinder onBind(Intent intent)<br /> {<br /> return new MyServiceImpl();<br /> }<br /> }

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

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

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

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

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

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

使用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;<br /> import net.blogjava.mobile.complex.type.aidl.Product;<br /> interface IMyService{<br /> Map getMap(in String country, in Product product);<br /> Product getProduct();<br /> }

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

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

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

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

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

在编写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; </p> <p>import java.util.HashMap;<br /> import java.util.Map;<br /> import android.app.Service;<br /> import android.content.Intent;<br /> import android.os.IBinder;<br /> import android.os.RemoteException;<br /> // AIDL服务类<br /> public class MyService extends Service<br /> {<br /> public class MyServiceImpl extends IMyService.Stub<br /> {<br /> @Override<br /> public Product getProduct() throws RemoteException<br /> {<br /> Product product = new Product();<br /> product.setId(1234);<br /> product.setName("汽车");<br /> product.setPrice(31000);<br /> return product;<br /> }<br /> @Override<br /> public Map getMap(String country, Product product) throws RemoteException<br /> {<br /> Map map = new HashMap<String, String>();<br /> map.put("country", country);<br /> map.put("id", product.getId());<br /> map.put("name", product.getName());<br /> map.put("price", product.getPrice());<br /> map.put("product", product);<br /> return map;<br /> }<br /> }<br /> @Override<br /> public IBinder onBind(Intent intent)<br /> {<br /> return new MyServiceImpl();<br /> }<br /> }

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

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

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

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

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

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