AIDL --- Android中的远程接口_如何获取某一个apk中的aidl接口-CSDN博客

在Android 中, 每个应用程序都可以有自己的进程. 在写UI 应用的时候, 经常要用到Service. 在不同的进程中, 怎样传递对象呢? 显然, Java 中不允许跨进程内存共享. 因此传递对象, 只能把对象拆分成操作系统能理解的简单形式, 以达到跨界对象访问的目的. 在J2EE 中, 采用RMI 的方式, 可以通过序列化传递对象. 在Android 中, 则采用AIDL 的方式. 理论上AIDL 可以传递Bundle, 实际上做起来却比较麻烦.

AIDL(AndRoid 接口描述语言) 是一种借口描述语言; 编译器可以通过aidl 文件生成一段代码，通过预先定义的接口达到两个进程内部通信进程的目的. 如果需要在一个Activity 中, 访问另一个Service 中的某个对象, 需要先将对象转化成AIDL 可识别的参数( 可能是多个参数), 然后使用AIDL 来传递这些参数, 在消息的接收端, 使用这些参数组装成自己需要的对象.

AIDL 的IPC 的机制和COM 或CORBA 类似, 是基于接口的，但它是轻量级的。它使用代理类在客户端和实现层间传递值. 如果要使用AIDL, 需要完成2 件事情: 1. 引入AIDL 的相关类.; 2. 调用aidl 产生的class.

具体实现步骤如下:

1 、创建AIDL 文件, 在这个文件里面定义接口, 该接口定义了可供客户端访问的方法和属性。如: ITaskBinder.adil

package com.cmcc.demo;

import com.cmcc.demo.ITaskCallback;

interface ITaskBinder {

boolean isTaskRunning();

void stopRunningTask();

void registerCallback(ITaskCallback cb);

void unregisterCallback(ITaskCallback cb);

}

其中 : ITaskCallback 在文件 ITaskCallback.aidl 中定义 :

package com.cmcc.demo;

interface ITaskCallback {

void actionPerformed(int actionId);

}

注意 : 理论上 , 参数可以传递基本数据类型和 String, 还有就是 Bundle 的派生类 , 不过在 Eclipse 中 , 目前的 ADT 不支持 Bundle 做为参数 , 据说用 Ant 编译可以 , 我没做尝试 .

2 、编译AIDL 文件, 用Ant 的话, 可能需要手动, 使用Eclipse plugin 的话, 可以根据adil 文件自动生产java 文件并编译, 不需要人为介入.

3 、在Java 文件中, 实现AIDL 中定义的接口. 编译器会根据AIDL 接口, 产生一个JAVA 接口。这个接口有一个名为Stub 的内部抽象类，它继承扩展了接口并实现了远程调用需要的几个方法。接下来就需要自己去实现自定义的几个接口了.

ITaskBinder.aidl 中接口的实现, 在MyService.java 中接口以内嵌类的方式实现:

private final ITaskBinder.Stub mBinder = new ITaskBinder.Stub() {

public void stopRunningTask() {

//@TODO

}

public boolean isTaskRunning() {

//@TODO

return false ;

}

public void registerCallback(ITaskCallback cb) {

if (cb != null ) mCallbacks .register(cb);

}

public void unregisterCallback(ITaskCallback cb) {

if (cb != null ) mCallbacks .unregister(cb);

}

};

在 MyActivity.java 中 ITaskCallback.aidl 接口实现 :

private ITaskCallback mCallback = new ITaskCallback.Stub() {

public void actionPerformed( int id) {

//TODO

printf( "callback id=" + id);

}

};

4 、向客户端提供接口ITaskBinder, 如果写的是service ，扩展该Service 并重载onBind () 方法来返回一个实现上述接口的类的实例。这个地方返回的mBinder, 就是上面通过内嵌了定义的那个. (MyService.java)

public IBinder onBind (Intent t) {

printf( "service on bind" );

return mBinder ;

}

在 Activity 中 , 可以通过 Binder 定义的接口 , 来进行远程调用 .

5 、在服务器端回调客户端的函数. 前提是当客户端获取的IBinder 接口的时候, 要去注册回调函数, 只有这样, 服务器端才知道该调用那些函数在:MyService.java 中:

void callback( int val) {

final int N = mCallbacks .beginBroadcast();

for ( int i=0; i<N; i++) {

try {

mCallbacks .getBroadcastItem(i).actionPerformed(val);

} catch (RemoteException e) {

// The RemoteCallbackList will take care of removing

// the dead object for us.

}

mCallbacks .finishBroadcast();

}

AIDL 的创建方法:

AIDL 语法很简单, 可以用来声明一个带一个或多个方法的接口，也可以传递参数和返回值。由于远程调用的需要, 这些参数和返回值并不是任何类型. 下面是些AIDL 支持的数据类型:

1. 不需要import 声明的简单Java 编程语言类型(int,boolean 等)

2. String, CharSequence
不需要特殊声明

3. List, Map
和Parcelables
类型, 
这些类型内所包含的数据成员也只能是简单数据类型, String
等其他比支持的类型.

(
另外: 
我没尝试Parcelables, 
在Eclipse+ADT
下编译不过, 
或许以后会有所支持).

下面是AIDL
语法:

 // 
文件名: SomeClass.aidl

 // 
文件可以有注释, 
跟java
的一样

 // 
在package
以前的注释, 
将会被忽略.

 // 
函数和变量以前的注释, 
都会被加入到生产java
代码中.

package com.cmcc.demo;

 // import 
引入语句

import com.cmcc.demo.ITaskCallback;

interface ITaskBinder {

// 函数跟 java 一样 , 可以有 0 到多个参数 , 可以有一个返回值

boolean isTaskRunning();

void stopRunningTask();

// 参数可以是另外的一个 aidl 定义的接口

void registerCallback(ITaskCallback cb);

void unregisterCallback(ITaskCallback cb);

// 参数可以是 String, 可以用 in 表入输入类型 , out 表示输出类型 .

int getCustomerList(in String branch, out String[] customerList);

实现接口时有几个原则:

.
抛出的异常不要返回给调用者. 
跨进程抛异常处理是不可取的.

.IPC
调用是同步的。如果你知道一个IPC
服务需要超过几毫秒的时间才能完成地话，你应该避免在Activity
的主线程中调用。 也就是IPC
调用会挂起应用程序导致界面失去响应. 
这种情况应该考虑单起一个线程来处理.

.
不能在AIDL
接口中声明静态属性。

IPC 的调用步骤:

 
1. 
声明一个接口类型的变量，该接口类型在.aidl
文件中定义。

 2. 
实现ServiceConnection
。

 3. 
调用ApplicationContext.bindService(),
并在ServiceConnection
实现中进行传递.

 
4. 
在ServiceConnection.onServiceConnected()
实现中，你会接收一个IBinder
实例(
被调用的Service). 
调用

    
YourInterfaceName.Stub.asInterface((IBinder)service)
将参数转换为YourInterface
类型。

 5. 
调用接口中定义的方法。 你总要检测到DeadObjectException
异常，该异常在连接断开时被抛出。它只会被远程方法抛出。

 6. 
断开连接，调用接口实例中的ApplicationContext.unbindService()

下面是整个程序 :

1. ITaskCallback.aidl

package com.cmcc.demo;

interface ITaskCallback {

void actionPerformed(int actionId);

}

2. ITaskBinder.aidl

package com.cmcc.demo;

import com.cmcc.demo.ITaskCallback;

interface ITaskBinder {

boolean isTaskRunning();

void stopRunningTask();

void registerCallback(ITaskCallback cb);

void unregisterCallback(ITaskCallback cb);

}

3. MyService.java

package com.cmcc.demo;

import android.app.Service;

import android.content.Intent;

import android.os.IBinder;

import android.os.RemoteCallbackList;

import android.os.RemoteException;

import android.util.Log;

public class MyService extends Service {

@Override

public void onCreate() {

printf( "service create" );

}

@Override

public void onStart(Intent intent , int startId) {

printf( "service start id=" + startId);

callback(startId);

}

@Override

public IBinder onBind(Intent t) {

printf( "service on bind" );

return mBinder ;

}

@Override

public void onDestroy() {

printf( "service on destroy" );

super .onDestroy();

}

@Override

public boolean onUnbind(Intent intent) {

printf( "service on unbind" );

return super .onUnbind(intent);

}

public void onRebind(Intent intent) {

printf( "service on rebind" );

super .onRebind(intent);

}

private void printf(String str) {

Log.e ( "TAG" , "###################------ " + str + "------" );

}

void callback( int val) {

final int N = mCallbacks .beginBroadcast();

for ( int i=0; i<N; i++) {

try {

mCallbacks .getBroadcastItem(i).actionPerformed(val);

} catch (RemoteException e) {

// The RemoteCallbackList will take care of removing

// the dead object for us.

}

mCallbacks .finishBroadcast();

}

private final ITaskBinder.Stub mBinder = new ITaskBinder.Stub() {

public void stopRunningTask() {

}

public boolean isTaskRunning() {

return false ;

}

public void registerCallback(ITaskCallback cb) {

if (cb != null ) mCallbacks .register(cb);

}

public void unregisterCallback(ITaskCallback cb) {

if (cb != null ) mCallbacks .unregister(cb);

}

};

final RemoteCallbackList<ITaskCallback> mCallbacks

= new RemoteCallbackList<ITaskCallback>();

}

4. MyActivity.java

package com.cmcc.demo;

import android.app.Activity;

import android.content.ComponentName;

import android.content.Context;

import android.content.Intent;

import android.content.ServiceConnection;

import android.graphics.Color;

import android.os.Bundle;

import android.os.IBinder;

import android.os.RemoteException;

import android.util.Log;

import android.view.View;

import android.view.ViewGroup;

import android.view.View.OnClickListener;

import android.widget.AbsoluteLayout;

import android.widget.Button;

import android.widget.LinearLayout;

import android.widget.RelativeLayout;

import android.widget.TextView;

import java.io.BufferedReader;

import java.io.File;

import java.io.FileOutputStream;

import java.io.FileReader;

import java.io.PrintWriter;

public class MyActivity extends Activity {

private Button btnOk ;

private Button btnCancel ;

@Override

public void onCreate(Bundle icicle) {

super .onCreate(icicle);

setContentView(R.layout. test_service );

btnOk = (Button)findViewById(R.id. btn_ok );

btnCancel = (Button)findViewById(R.id. btn_cancel );

btnOk .setText( "Start Service" );

btnCancel .setTag( "Stop Service" );

btnOk .setOnClickListener( new OnClickListener() {

public void onClick(View v) {

onOkClick();

}

});

btnCancel .setOnClickListener( new OnClickListener() {

public void onClick(View v) {

onCancelClick();

}

});

}

void onOkClick() {

Bundle args = new Bundle();

Intent intent = new Intent( this , MyService. class );

intent.putExtras(args);

//printf("send intent to start");

//startService(intent);

bindService(intent, mConnection , Context. BIND_AUTO_CREATE );

startService(intent);

}

void onCancelClick() {

Intent intent = new Intent( this , MyService. class );

//printf("send intent to stop");

unbindService( mConnection );

//stopService(intent);

}

private void printf(String str) {

Log.e ( "TAG" , "###################------ " + str + "------" );

}

ITaskBinder mService ;

private ServiceConnection mConnection = new ServiceConnection() {

public void onServiceConnected(ComponentName className,

IBinder service) {

mService = ITaskBinder.Stub.asInterface (service);

try {

mService .registerCallback( mCallback );

} catch (RemoteException e) {

}

public void onServiceDisconnected(ComponentName className) {

mService = null ;

}

};

private ITaskCallback mCallback = new ITaskCallback.Stub() {

public void actionPerformed( int id) {

printf( "callback id=" + id);

}

};

}