在Android 中有一种服务说是服务其实倒不如说是一个接口,这个接口名为:Android Interface Definition Language ,这个接口可提供跨进程访问服务,英文缩写为:AIDL。
此种服务的好处在于,多个应用程序之间建立共同的服务机制,通过AIDL在不同应用程序之间达到数据的共享和数据相互操作,下面将通过一个DEMO 演示AIDL 是如何为应用程序之间提供服务的。
本文大纲为:
- 1、创建AIDL 服务端。
- 2、创建AIDL 客户端。
- 3、客户端调用服务端提供的服务接口。
- 4、小结。
本文要实现的功能大致如下:创建AIDL服务端,此服务端将提供一个Student 的javabean 提供客户端取得数据,因为aidl 支持的数据类型比较简单,故这里建议把常用的数据类型的数据写入服务。
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);
}
1、创建AIDL 服务端
在Android 的src 文件夹下的任意包里面新建文件,后缀名为*.aidl,如下图
输入如下代码:
package com.aidl.test;
import com.aidl.test.Student;//Parcelables, 在Eclipse+ADT下编译不过, 或许以后会有所支持).interface IMyService
{
Map getMap(in String test_class,in Student student);
Student getStudent();
}
Student 类是一个序列化的类,这里使用Parcelable 接口来序列化是Google 提供的一个比Serializable 效率更高的序列化类。Student
package
com.aidl.test;
import
android.os.Parcel;
import
android.os.Parcelable;
public
class
Student
implements
Parcelable {
private
int
age;
private
String name;
public
int
getAge() {
return
age;
}
public
void
setAge(
int
age) {
this
.age
=
age;
}
public
String getName() {
return
name;
}
public
void
setName(String name) {
this
.name
=
name;
}
public
static
final
Parcelable.Creator
<
Student
>
CREATOR
=
new
Creator
<
Student
>
() {
@Override
public
Student[] newArray(
int
size) {
//
TODO Auto-generated method stub
return
new
Student[size];
}
@Override
public
Student createFromParcel(Parcel source) {
//
TODO Auto-generated method stub
return
new
Student(source);
}
};
public
Student() {
}
public
Student(Parcel pl) {
age
=
pl.readInt();
name
=
pl.readString();
}
@Override
public
int
describeContents() {
//
TODO Auto-generated method stub
return
0
;
}
@Override
public
void
writeToParcel(Parcel dest,
int
flags) {
//
TODO Auto-generated method stub
dest.writeInt(age);
dest.writeString(name);
}
}
在这里必须注意,编写javabean时必须注意如下三点:
- 在Student 类中必须有一个静态常量,常量名必须是CREATOR,而且CREATOR 常量的数据类型必须是 Parcelable.Creator
- 在writeToParcel 方法中需要将要序列化的值写入到 Parcel对象中。
- 编写完Student 为时,必须再新建一个Student.aidl 文件,此文件输入以下内容:
parcelable Student; 这里的书写是供上面我们说过的接口
如果上面的步骤顺利通过的话,Android 将会自动在gen 目录下R文件的相同目录生成一个以*.aidl 文件命名的*.java 文件,如下图:
顺利生成成功后,我们再来编写一个AIDL 服务类,代码如下:
如上代码,MyService 服务类有一个子类并继承自我们上面生成的*.java 文件重写其中我们在*.aidl 中声明的两个接口方法,实现了其功能。上面IBinder 必须返回此服务类的子类对象,否则客户端将无法获得服务对象。
package
com.aidl.test;
import
java.util.HashMap;
import
java.util.Map;
import
android.app.Service;
import
android.content.Intent;
import
android.os.IBinder;
import
android.os.RemoteException;
public
class
MyService
extends
Service {
@Override
public
IBinder onBind(Intent intent) {
//
TODO Auto-generated method stub
return
new
MyServiceimpl();
}
public
class
MyServiceimpl
extends
IMyService.Stub {
@Override
public
Student getStudent()
throws
RemoteException {
//
TODO Auto-generated method stub
Student st
=
new
Student();
st.setAge(
18
);
st.setName(
"
terry
"
);
return
st;
}
@Override
public
Map getMap(String testClass, Student student)
throws
RemoteException {
//
TODO Auto-generated method stub
Map
<
String, Object
>
map
=
new
HashMap
<
String, Object
>
();
map.put(
"
class
"
,
"
五年级
"
);
map.put(
"
age
"
, student.getAge());
map.put(
"
name
"
, student.getName());
return
map;
}
}
}
最后,即然有服务的操作,那么就得在manifest文件中注册服务类,代码如下:
<
service
android:name
=".MyService"
>
<
intent-filter
>
<
action
android:name
="com.aidl.test.IMyService"
></
action
>
</
intent-filter
>
</
service
>
至此,服务端就己经开发完成了,下面接着开发客启端。
2、创建AIDL 客户端
同样是新建一个项目,这里要注意,需要将服务端生成成功后的gen 目录下的包复制过来,放到我们新建项目的src 文件夹下,如下图:
因为IMyService 这个生成类,引用到了Student 这个javabean 所以这里一并将javabean也复制过来。
至此,客户端的创建己经完毕,下面我们就要利用创建的客户端去调用服务端的方法。
3、客户端调用服务端提供的服务接口
先看一下运行效果:
细心的朋友会发现,上面的数据不是我们在上面客户端为Student 设置的数据吗?怎么在这个程序里面也同样得到了?没错。这就是aidl 的魅力,下面来看看如何调用 吧,图中有两个按钮,一个按钮为绑定AIDL 服务,即通过Activity 的 bindService 绑定 AIDL 外部服务,全部代码如下:
package
com.aidl.client;
import
com.aidl.test.IMyService;
import
android.app.Activity;
import
android.app.AlertDialog;
import
android.content.ComponentName;
import
android.content.Context;
import
android.content.Intent;
import
android.content.ServiceConnection;
import
android.os.Bundle;
import
android.os.IBinder;
import
android.os.RemoteException;
import
android.view.View;
import
android.view.View.OnClickListener;
import
android.widget.Button;
public
class
aidlActivity
extends
Activity
implements
OnClickListener {
Button btn1, btn2;
private
IMyService myService
=
null
;
private
ServiceConnection serviceConnection
=
new
ServiceConnection() {
@Override
public
void
onServiceDisconnected(ComponentName name) {
//
TODO Auto-generated method stub
}
@Override
public
void
onServiceConnected(ComponentName name, IBinder service) {
//
TODO Auto-generated method stub
myService
=
IMyService.Stub.asInterface(service);
btn2.setEnabled(
true
);
}
};
@Override
public
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setContentView(R.layout.main);
btn1
=
(Button) findViewById(R.id.Button01);
btn2
=
(Button) findViewById(R.id.Button02);
btn2.setEnabled(
false
);
btn1.setOnClickListener(
this
);
btn2.setOnClickListener(
this
);
}
@Override
public
void
onClick(View v) {
//
TODO Auto-generated method stub
switch
(v.getId()) {
case
R.id.Button01:
bindService(
new
Intent(
"
com.aidl.test.IMyService
"
),
serviceConnection, Context.BIND_AUTO_CREATE);
break
;
case
R.id.Button02:
StringBuilder sb
=
new
StringBuilder();
try
{
sb.append(
"
学生名称为:
"
+
myService.getStudent().getName()
+
"
\n
"
);
sb.append(
"
年龄为:
"
+
myService.getStudent().getAge()
+
"
\n
"
);
sb.append(
"
map 对象内容为如下:
"
+
myService.getMap(
"
中国
"
, myService.getStudent())
.toString());
}
catch
(RemoteException e) {
//
TODO Auto-generated catch block
e.printStackTrace();
}
new
AlertDialog.Builder(aidlActivity.
this
).setTitle(
"
调用外部服务
"
)
.setMessage(sb.toString()).setPositiveButton(
android.R.string.ok,
null
).show();
break
;
default
:
break
;
}
}
}
在ServiceConnetction里面对IMyService 进行初始化,即可操作该对象,该对象就可以得到我们所有要处理的数据。
4、小结
- aidl 文件调用javabean 的aidl文件必须导包;
- javabean 必须序列化,如果没有用javabean可以用简单的变量代替,如返回一个整型,返回一个字符串等。
- 使用aidl 必须同时存在客户端和服务端,即客户端在本机上,服务端也在本机上,要使用客户端必须服务端事先在本机上注册过服务。