[Android Pro] AIDL进程间传递自定义类型参数



1、创建.aidl 文件

AIDL 语法简单,用来声明接口,其中的方法接收参数和返回值,但是参数和返回值的类型是有约束的,且有些类型是需要 import,另外一些则无需这样做。

AIDL 支持的数据类型划分为四类,第一类是 Java 编程语言中的基本类型,第二类包括 String、List、Map 和 CharSequence,第三类是其他 AIDL 生成的 interface,第四类是实现了 Parcelable protocol 的自定义类。

其中,除了第一类外,其他三类在使用时均需要特别小心。

使用第二类时,首先需要明白这些类不需要 import,是内嵌的。其次注意在使用 List 和 Map 此二者容器类时,需注意其元素必须得是 AIDL 支持的数据类型,List 可支持泛型,但是 Map 不支持,同时另外一端负责接收的具体的类里则必须是 ArrayList 和 HashMap。

使用第三、四类时,需要留意它们都是需要 import 的,但是前者传递时,传递的是 reference,而后者则是 value。

在创建 .aidl 文件的过程中,应该注意一旦 method 有参数,则需注意在前面加上 in, out 或 inout,它们被称为 directional tag,但是对于基本类型的参数,默认就是 in,并且不会是其他值。



Aidl默认支持的类型包话java基本类型(int、long、boolean等)和(String、List、Map、CharSequence),如果要传递自定义的类型该如何实现呢? 
要传递自定义类型,首先要让自定义类型支持parcelable协议,实现步骤如下: 
1>自定义类型必须实现Parcelable接口,并且实现Parcelable接口的public void writeToParcel(Parcel dest, int flags)方法 。 
2>自定义类型中必须含有一个名称为CREATOR的静态成员,该成员对象要求实现Parcelable.Creator接口及其方法。 
3> 创建一个aidl文件声明你的自定义类型。 
Parcelable接口的作用:实现了Parcelable接口的实例可以将自身的状态信息(状态信息通常指的是各成员变量的值)写入Parcel,也可以从Parcel中恢复其状态。 Parcel用来完成数据的序列化传递。



1> 创建自定义类型,并实现Parcelable接口,使其支持parcelable协议。如:在cn.jp.domain包下创建Person.java:




package cn.jp.domain; 
import android.os.Parcel; 
import android.os.Parcelable; 
public class Person implements Parcelable 
private Integer id; 
private String name; 
public Person(){} 
public Person(Integer id, String name) { 
this.id = id; 
this.name = name; 
} 
public Integer getId() { 
return id; 
} 
public void setId(Integer id) { 
this.id = id; 
} 
public String getName() { 
return name; 
} 
public void setName(String name) { 
this.name = name; 
} 
@Override 
public int describeContents() { 
return 0; 
} 
@Override 
public void writeToParcel(Parcel dest, int flags) {//把javanbean中的数据写到Parcel 
dest.writeInt(this.id); 
dest.writeString(this.name); 
} 
//添加一个静态成员,名为CREATOR,该对象实现了Parcelable.Creator接口 
public static final Parcelable.Creator<Person> CREATOR = new Parcelable.Creator<Person>(){ 
@Override 
public Person createFromParcel(Parcel source) {//从Parcel中读取数据,返回person对象 
return new Person(source.readInt(), source.readString()); 
} 
@Override 
public Person[] newArray(int size) { 
return new Person[size]; 
} 
}; 
}




2> 在自定义类型所在包下创建一个aidl文件对自定义类型进行声明,文件的名称与自定义类型同名。 

 



package cn.jp.domain; 
parcelable Person;



 

3> 在接口aidl文件中使用自定义类型,需要使用import显式导入,本例在cn.jp.aidl包下创建IPersonService.aidl文件,内容如下: 

 



package cn.itcast.aidl; 
import cn.itcast.domain.Person; 
interface IPersonService { 
      void save(in Person person); 
}



 

4> 在实现aidl文件生成的接口(本例是IPersonService),但并非直接实现接口,而是通过继承接口的Stub来实现(Stub抽象类内部实现了aidl接口),并且实现接口方法的代码。内容如下:

 



public class ServiceBinder extends IPersonService.Stub { 
       @Override 
       public void save(Person person) throws RemoteException { 
              Log.i("PersonService", person.getId()+"="+ person.getName()); 
       } 
}



 

5> 创建一个Service(服务),在服务的onBind(Intent intent)方法中返回实现了aidl接口的对象(本例是ServiceBinder)。内容如下: 

 




public class PersonService extends Service { 
private ServiceBinder serviceBinder = new ServiceBinder(); 
@Override 
public IBinder onBind(Intent intent) { 
        return serviceBinder; 
} 
public class ServiceBinder extends IPersonService.Stub { 
       @Override 
       public void save(Person person) throws RemoteException { 
            Log.i("PersonService", person.getId()+"="+ person.getName()); 
       } 
} 
}




 

其他应用可以通过隐式意图访问服务,意图的动作可以自定义,AndroidManifest.xml配置代码如下: 

 


<service android:name=".PersonService" > 
     <intent-filter> 
          <action android:name="cn.jp.process.aidl.PersonService " /> 
     </intent-filter> 
</service>

 

6> 把应用中的aidl文件和所在package一起拷贝到客户端应用的src目录下,eclipse会自动在客户端应用的gen目录中为aidl文件同步生 成IPersonService.java接口文件,接下来再把自定义类型文件和类型声明aidl文件及所在package一起拷贝到客户端应用的src 目录下。 
最后就可以在客户端应用中实现与远程服务的通信,代码如下: 

 




public class ClientActivity extends Activity { 

private IPersonService personService; 

@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
this.bindService(new Intent("cn.jp.process.aidl.PersonService"), this.serviceConnection, BIND_AUTO_CREATE);//绑定到服务 
}

@Override 
protected void onDestroy() { 
   super.onDestroy(); 
   this.unbindService(serviceConnection);//解除服务 
} 

private ServiceConnection serviceConnection = new ServiceConnection() { 
     @Override 
     public void onServiceConnected(ComponentName name, IBinder service) { 
         personService = IPersonService.Stub.asInterface(service); 
         try { 
             personService.save(new Person(56,"liming")); 
         } catch (RemoteException e) { 
         Log.e("ClientActivity", e.toString()); 
}