分享

使用AIDL实现进程间的通信之复杂类型传递

 w_hf的图书馆 2011-07-27

  

上次讲到简单的AIDL进程间通信的操作,客户端向服务端发送一个String类型的参数,服务端也返回一个String类型的结果,看似已经可以完成基本的需要了。不过在有的时候,简单的数据类型并不能满足我们的需求,我们就需要考虑怎样向服务端传递复杂的数据类型。今天就来讲一下如何向服务端传递复杂类型的问题。

首先要了解一下AIDL对Java类型的支持。

1.AIDL支持Java原始数据类型。

2.AIDL支持String和CharSequence。

3.AIDL支持传递其他AIDL接口,但你引用的每个AIDL接口都需要一个import语句,即使位于同一个包中。

4.AIDL支持传递实现了android.os.Parcelable接口的复杂类型,同样在引用这些类型时也需要import语句。(Parcelable接口告诉Android运行时在封送(marshalling)和解封送(unmarshalling)过程中实现如何序列化和反序列化对象,你可以很容易联想到java.io.Serializable接口。有些朋友可能会有疑问,两种接口功能确实类似,但为什么Android不用内置的Java序列化机制,而偏偏要搞一套新东西呢?这是因为Android团队认为Java中的序列化太慢,难以满足Android的进程间通信需求,所以他们构建了Parcelable解决方案。Parcelable要求显示序列化类的成员,但最终序列化对象的速度将快很多。另外要注意的是,Android提供了两种机制来将数据传递给另一个进程,第一种是使用Intent将数据束(Bundle)传递给活动,第二种也就是Parcelable传递给服务。这两种机制不可互换,不要混淆。也就是说,Parcelable无法传递给活动,只能用作AIDL定义的一部分)。

5.AIDL支持java.util.List和java.util.Map,但是有一些限制。集合中项的允许数据类型包括Java原始类型、String、CharSequence或是android.os.Parcelable。无需为List和Map提供import语句,但需要为Parcelable提供import语句。

6.非原始类型中,除了String和CharSequence以外,其余均需要一个方向指示符。方向指示符包括in、out、和inout。in表示由客户端设置,out表示由服务端设置,inout表示客户端和服务端都设置了该值。

接下来就演示一下具体的流程:

我们先看一下服务端的结构:

其中,Person类是我们要在服务端和客户端中间进行传递的类型,代码如下:

  1. package com.scott.aidl;
  2. import android.os.Parcel;
  3. import android.os.Parcelable;
  4. public class Person implements Parcelable {
  5. private String name;
  6. private int sex;
  7. //必须提供一个名为CREATOR的static final属性 该属性需要实现android.os.Parcelable.Creator<T>接口
  8. public static final Parcelable.Creator<Person> CREATOR = new Parcelable.Creator<Person>() {
  9. @Override
  10. public Person createFromParcel(Parcel source) {
  11. return new Person(source);
  12. }
  13. @Override
  14. public Person[] newArray(int size) {
  15. return new Person[size];
  16. }
  17. };
  18. public Person() {
  19. }
  20. private Person(Parcel source) {
  21. readFromParcel(source);
  22. }
  23. @Override
  24. public int describeContents() {
  25. return 0;
  26. }
  27. //注意写入变量和读取变量的顺序应该一致 不然得不到正确的结果
  28. @Override
  29. public void writeToParcel(Parcel dest, int flags) {
  30. dest.writeString(name);
  31. dest.writeInt(sex);
  32. }
  33. //注意读取变量和写入变量的顺序应该一致 不然得不到正确的结果
  34. public void readFromParcel(Parcel source) {
  35. name = source.readString();
  36. sex = source.readInt();
  37. }
  38. public String getName() {
  39. return name;
  40. }
  41. public void setName(String name) {
  42. this.name = name;
  43. }
  44. public int getSex() {
  45. return sex;
  46. }
  47. public void setSex(int sex) {
  48. this.sex = sex;
  49. }
  50. }

 

然后我们需要在同一包下建立一个与包含复杂类型的Person.java文件匹配的Person.aidl文件,代码如下:

  1. package com.scott.aidl;
  2. parcelable Person;

 

这个Person.aidl文件很简单,就是定义了一个Parcelable类,告诉系统我们需要序列化和反序列化的类型。每一个实现了Parcelable的类型都需要对应的.aidl文件。AIDL编译器在编译AIDL文件时会自动查找此类文件。

接下来,我们需要创建一个IGreetService.aidl文件,以接收类型为Person的输入参数,以便客户端可以将Person传递给服务。

  1. package com.scott.aidl;
  2. import com.scott.aidl.Person;
  3. interface IGreetService {
  4. String greet(in Person person);
  5. }

 

注意,我们需要在参数上加入方向指示符in,代表参数由客户端设置,我们还需要为Person提供一个import语句(虽然说在同一个包下)。

此时,在eclipse插件的帮助下,AIDL编译器会自动编译生成一个IGreetService.java文件,格式化后的代码如下:

  1. package com.scott.aidl;
  2. public interface IGreetService extends android.os.IInterface {
  3. /** Local-side IPC implementation stub class. */
  4. public static abstract class Stub extends android.os.Binder implements com.scott.aidl.IGreetService {
  5. private static final java.lang.String DESCRIPTOR = "com.scott.aidl.IGreetService";
  6. /** Construct the stub at attach it to the interface. */
  7. public Stub() {
  8. this.attachInterface(this, DESCRIPTOR);
  9. }
  10. /**
  11. * Cast an IBinder object into an com.scott.aidl.IGreetService
  12. * interface, generating a proxy if needed.
  13. */
  14. public static com.scott.aidl.IGreetService asInterface(android.os.IBinder obj) {
  15. if ((obj == null)) {
  16. return null;
  17. }
  18. android.os.IInterface iin = (android.os.IInterface) obj.queryLocalInterface(DESCRIPTOR);
  19. if (((iin != null) && (iin instanceof com.scott.aidl.IGreetService))) {
  20. return ((com.scott.aidl.IGreetService) iin);
  21. }
  22. return new com.scott.aidl.IGreetService.Stub.Proxy(obj);
  23. }
  24. public android.os.IBinder asBinder() {
  25. return this;
  26. }
  27. @Override
  28. public boolean onTransact(int code, android.os.Parcel data, android.os.Parcel reply, int flags)
  29. throws android.os.RemoteException {
  30. switch (code) {
  31. case INTERFACE_TRANSACTION: {
  32. reply.writeString(DESCRIPTOR);
  33. return true;
  34. }
  35. case TRANSACTION_greet: {
  36. data.enforceInterface(DESCRIPTOR);
  37. com.scott.aidl.Person _arg0;
  38. if ((0 != data.readInt())) {
  39. _arg0 = com.scott.aidl.Person.CREATOR.createFromParcel(data);
  40. } else {
  41. _arg0 = null;
  42. }
  43. java.lang.String _result = this.greet(_arg0);
  44. reply.writeNoException();
  45. reply.writeString(_result);
  46. return true;
  47. }
  48. }
  49. return super.onTransact(code, data, reply, flags);
  50. }
  51. private static class Proxy implements com.scott.aidl.IGreetService {
  52. private android.os.IBinder mRemote;
  53. Proxy(android.os.IBinder remote) {
  54. mRemote = remote;
  55. }
  56. public android.os.IBinder asBinder() {
  57. return mRemote;
  58. }
  59. public java.lang.String getInterfaceDescriptor() {
  60. return DESCRIPTOR;
  61. }
  62. public java.lang.String greet(com.scott.aidl.Person person) throws android.os.RemoteException {
  63. android.os.Parcel _data = android.os.Parcel.obtain();
  64. android.os.Parcel _reply = android.os.Parcel.obtain();
  65. java.lang.String _result;
  66. try {
  67. _data.writeInterfaceToken(DESCRIPTOR);
  68. if ((person != null)) {
  69. _data.writeInt(1);
  70. person.writeToParcel(_data, 0);
  71. } else {
  72. _data.writeInt(0);
  73. }
  74. mRemote.transact(Stub.TRANSACTION_greet, _data, _reply, 0);
  75. _reply.readException();
  76. _result = _reply.readString();
  77. } finally {
  78. _reply.recycle();
  79. _data.recycle();
  80. }
  81. return _result;
  82. }
  83. }
  84. static final int TRANSACTION_greet = (android.os.IBinder.FIRST_CALL_TRANSACTION + 0);
  85. }
  86. public java.lang.String greet(com.scott.aidl.Person person) throws android.os.RemoteException;
  87. }

 

该文件的大纲视图如下:

接下来,就该完成我们的AIDLService逻辑部分了,AIDLService.java代码如下:

  1. package com.scott.server;
  2. import android.app.Service;
  3. import android.content.Intent;
  4. import android.os.IBinder;
  5. import android.os.RemoteException;
  6. import android.util.Log;
  7. import com.scott.aidl.IGreetService;
  8. import com.scott.aidl.Person;
  9. public class AIDLService extends Service {
  10. private static final String TAG = "AIDLService";
  11. IGreetService.Stub stub = new IGreetService.Stub() {
  12. @Override
  13. public String greet(Person person) throws RemoteException {
  14. Log.i(TAG, "greet(Person person) called");
  15. String greeting = "hello, " + person.getName();
  16. switch (person.getSex()) {
  17. case 0:
  18. greeting = greeting + ", you're handsome.";
  19. break;
  20. case 1:
  21. greeting = greeting + ", you're beautiful.";
  22. break;
  23. }
  24. return greeting;
  25. }
  26. };
  27. @Override
  28. public IBinder onBind(Intent intent) {
  29. Log.i(TAG, "onBind() called");
  30. return stub;
  31. }
  32. @Override
  33. public boolean onUnbind(Intent intent) {
  34. Log.i(TAG, "onUnbind() called");
  35. return true;
  36. }
  37. @Override
  38. public void onDestroy() {
  39. super.onDestroy();
  40. Log.i(TAG, "onDestroy() called");
  41. }
  42. }

 

最后,在AndroidManifest.xml中配置该服务:

  1. <service android:name=".AIDLService">
  2. <intent-filter>
  3. <action android:name="android.intent.action.AIDLService" />
  4. <category android:name="android.intent.category.DEFAULT" />
  5. </intent-filter>
  6. </service>

 

服务端就已经完成了。接下来我们来看一下客户端的结构:

我们需要把服务端的Person.java、Person.aidl和IGreetService.aidl拷到对应的包下。我们主要来看看MainActivity.java代码:

  1. package com.scott.client;
  2. import android.app.Activity;
  3. import android.content.ComponentName;
  4. import android.content.Context;
  5. import android.content.Intent;
  6. import android.content.ServiceConnection;
  7. import android.os.Bundle;
  8. import android.os.IBinder;
  9. import android.os.RemoteException;
  10. import android.util.Log;
  11. import android.view.View;
  12. import android.widget.Button;
  13. import android.widget.Toast;
  14. import com.scott.aidl.IGreetService;
  15. import com.scott.aidl.Person;
  16. public class MainActivity extends Activity {
  17. private Button bindBtn;
  18. private Button greetBtn;
  19. private Button unbindBtn;
  20. private IGreetService greetService;
  21. private ServiceConnection conn = new ServiceConnection() {
  22. @Override
  23. public void onServiceConnected(ComponentName name, IBinder service) {
  24. Log.i("ServiceConnection", "onServiceConnected() called");
  25. greetService = IGreetService.Stub.asInterface(service);
  26. }
  27. @Override
  28. public void onServiceDisconnected(ComponentName name) {
  29. //This is called when the connection with the service has been unexpectedly disconnected,
  30. //that is, its process crashed. Because it is running in our same process, we should never see this happen.
  31. Log.i("ServiceConnection", "onServiceDisconnected() called");
  32. }
  33. };
  34. @Override
  35. public void onCreate(Bundle savedInstanceState) {
  36. super.onCreate(savedInstanceState);
  37. setContentView(R.layout.main);
  38. bindBtn = (Button) findViewById(R.id.bindBtn);
  39. bindBtn.setOnClickListener(new View.OnClickListener() {
  40. @Override
  41. public void onClick(View v) {
  42. Intent intent = new Intent("android.intent.action.AIDLService");
  43. bindService(intent, conn, Context.BIND_AUTO_CREATE);
  44. bindBtn.setEnabled(false);
  45. greetBtn.setEnabled(true);
  46. unbindBtn.setEnabled(true);
  47. }
  48. });
  49. greetBtn = (Button) findViewById(R.id.greetBtn);
  50. greetBtn.setOnClickListener(new View.OnClickListener() {
  51. @Override
  52. public void onClick(View v) {
  53. try {
  54. Person person = new Person();
  55. person.setName("scott");
  56. person.setSex(0);
  57. String retVal = greetService.greet(person);
  58. Toast.makeText(MainActivity.this, retVal, Toast.LENGTH_SHORT).show();
  59. } catch (RemoteException e) {
  60. Toast.makeText(MainActivity.this, "error", Toast.LENGTH_SHORT).show();
  61. }
  62. }
  63. });
  64. unbindBtn = (Button) findViewById(R.id.unbindBtn);
  65. unbindBtn.setOnClickListener(new View.OnClickListener() {
  66. @Override
  67. public void onClick(View v) {
  68. unbindService(conn);
  69. bindBtn.setEnabled(true);
  70. greetBtn.setEnabled(false);
  71. unbindBtn.setEnabled(false);
  72. }
  73. });
  74. }
  75. }

 

通过这种方式,就可以将Person类型的对象传递到服务端,实现复杂类型的通信传递。

当点击greetBtn时,截图如下:

然后看一下整个过程的日志信息。点击bindBtn、greetBtn、unbindBtn的整个过程日志如下:



    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多