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,並且不會是其他值。
要傳遞自定義類型,首先要讓自定義類型支持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()); }
