AIDL简介
AIDL是一种语言。也是用于android的跨进程通信的技术手段。AIDL全称“android interface definition language”,也可翻译为:安卓接口定义语言。跨进程,那么就需要有两个以上的进程,其中一个对外暴露接口,另外一个通过调用接口,实现数据共享。对外暴露接口的我们可以称之为服务端,连接调用的称其为客户端。
AIDL语法
AIDL的语法十分简单,与Java语言基本保持一致,需要记住的规则有以下几点:
- AIDL文件以 .aidl 为后缀名
- AIDL支持的数据类型分为如下几种:
- 八种基本数据类型:byte、char、short、int、long、float、double、boolean
- String,CharSequence
- 实现了Parcelable接口的数据类型
- List 类型。List承载的数据必须是AIDL支持的类型,或者是其它声明的AIDL对象
- Map类型。Map承载的数据必须是AIDL支持的类型,或者是其它声明的AIDL对象
- AIDL文件可以分为两类。一类用来声明实现了Parcelable接口的数据类型,以供其他AIDL文件使用那些非默认支持的数据类型。还有一类是用来定义接口方法,声明要暴露哪些接口给客户端调用,定向Tag就是用来标注这些方法的参数值
- 定向Tag。定向Tag表示在跨进程通信中数据的流向,用于标注方法的参数值,分为 in、out、inout 三种。其中 in 表示数据只能由客户端流向服务端, out 表示数据只能由服务端流向客户端,而 inout 则表示数据可在服务端与客户端之间双向流通。此外,如果AIDL方法接口的参数值类型是:基本数据类型、String、CharSequence或者其他AIDL文件定义的方法接口,那么这些参数值的定向 Tag 默认是且只能是 in,所以除了这些类型外,其他参数值都需要明确标注使用哪种定向Tag。定向Tag具体的使用差别后边会有介绍
- 明确导包。在AIDL文件中需要明确标明引用到的数据类型所在的包名,即使两个文件处在同个包名下
AIDL应用
首页介绍下服务端的代码,我们先定义一个数据共享的基类。命名为Book,因为是客户端和服务端交互,故需序列化,实现Parcelable。具体代码如下:
package com.zr.server;
import android.os.Parcel;
import android.os.Parcelable;
/**
* @auther EnzoChan
* created:2019/2/14
* desc:
*/
public class Book implements Parcelable {
private String name;
public Book(Parcel parcel) {
this.name = parcel.readString();
}
public Book(String name) {
this.name = name;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel parcel, int i) {
parcel.writeString(this.name);
}
public void readFromParcel(Parcel dest) {
name = dest.readString();
}
public static final Creator<Book> CREATOR = new Creator<Book>() {
@Override
public Book createFromParcel(Parcel parcel) {
return new Book(parcel);
}
@Override
public Book[] newArray(int i) {
return new Book[i];
}
};
}
注:客户端和服务端数据共享类的包名需一致,否则调用不起来。
创建基类对应的aidl文件,声明其包名,和类型。
创建方法:包名右键->new->AIDL->AIDL File。
内容如下:
// Book.aidl
package com.zr.server;
parcelable Book;
创建对外暴露接口的控制器,编写对外暴露的接口方法及传参。
demo中对外暴露两个方法,一个获取书籍列表一个增加图书方法(该方法客户端服务端都可传参),
具体代码如下:
// BookConteoller.aidl
package com.zr.server;
import com.zr.server.Book;
import java.util.List;
// Declare any non-default types here with import statements
interface BookConteoller {
List<Book> getBookList();
void addBookInOut(inout Book book);
}
构建(build)工程生成aidl文件,这里说明下,.aidl文件并不是主要起作用的文件,而是根据.aidl文件生成的Interace文件的实例代码。在此我们可以理解.aidl就是一个模板。
创建服务类及实现内部类
package com.zr.server;
import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
import android.os.RemoteException;
import android.util.Log;
import java.util.ArrayList;
import java.util.List;
/**
* @auther EnzoChan
* created:2019/2/14
* desc:
*/
public class AIDLService extends Service {
private final String TAG = "Server";
private List<Book> bookList;
@Override
public void onCreate() {
Log.i(TAG, "服务开启");
super.onCreate();
bookList = new ArrayList<>();
initData();
}
private void initData() {
Book info = new Book("或者");
Book info1 = new Book("或者1");
Book info2 = new Book("或者2");
bookList.add(info);
bookList.add(info1);
bookList.add(info2);
}
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
Log.i(TAG, "服务调用");
return super.onStartCommand(intent, flags, startId);
}
@Override
public void onDestroy() {
super.onDestroy();
Log.i(TAG, "服务关闭");
}
private final BookConteoller.Stub stub = new BookConteoller.Stub() {
@Override
public List<Book> getBookList() throws RemoteException {
return bookList;
}
@Override
public void addBookInOut(Book book) throws RemoteException {
if (book != null) {
book.setName("服务器改了新书的名字 Inout");
bookList.add(book);
} else {
Log.e(TAG, "空对象====== ");
}
}
};
@Override
public IBinder onBind(Intent intent) {
return stub;
}
}
至此,服务端的代码介绍差不多。
将服务端的aidl文件直接拷贝到客户端,然后Book.java也需要拷贝,并且包名需要一致。
剩下的就是连接服务,并且调用接口。demo简单实现,具体代码如下:
package com.zr.client;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.os.Build;
import android.os.Bundle;
import android.os.IBinder;
import android.os.RemoteException;
import android.support.v7.app.AppCompatActivity;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
import com.zr.server.Book;
import com.zr.server.BookConteoller;
import java.util.List;
public class ClientMainActivity extends AppCompatActivity implements View.OnClickListener {
private BookConteoller bookConteoller;
private boolean connected;
private List<Book> bookList;
private ServiceConnection serviceConnection = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
bookConteoller = BookConteoller.Stub.asInterface(iBinder);
connected = true;
Toast.makeText(ClientMainActivity.this, "绑定成功!", Toast.LENGTH_SHORT).show();
}
/**
* 正常情况该方法不会被调用,只有在程序被意外关闭或者进程被杀才自动调用
* 也就是当服务异常意外断开的时候,这个方法才会被调用,手动unBindService是不会走这个方法的
*/
@Override
public void onServiceDisconnected(ComponentName componentName) {
bookConteoller = null;
connected = false;
}
};
/**
* 获取图书列表
*/
private Button mBtnGetList;
/**
* 添加图书
*/
private Button mBtnAdd;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_client_main);
initView();
}
private void bindMyService() {
String manufacturer = Build.MANUFACTURER;
if ("Meizu".equals(manufacturer)) {
//解决魅族5.0以后无法隐士启动服务
Intent intent = new Intent();
intent.setComponent(new ComponentName("com.zr.server", "com.zr.server.AIDLService"));
intent.setAction("com.zr.server.action");
startService(intent);
boolean flag = bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);
Log.i("AIDL", flag + "");
} else {
Intent mIntent = new Intent();
mIntent.setPackage("com.zr.server");
mIntent.setAction("com.zr.server.action");
bindService(mIntent, serviceConnection, Context.BIND_AUTO_CREATE);
}
}
@Override
public void onClick(View view) {
switch (view.getId()) {
case R.id.btn_connect:
bindMyService();
break;
case R.id.btn_getList:
if (connected) {
try {
bookList = bookConteoller.getBookList();
mBtnGetList.setText("获取图书列表 一共" + bookList.size() + "本");
} catch (RemoteException e) {
e.printStackTrace();
}
} else {
Toast.makeText(this, "服务没有开启", Toast.LENGTH_SHORT).show();
}
break;
case R.id.btn_add:
if (connected) {
Book book = new Book("客户端假的呀");
try {
bookConteoller.addBookInOut(book);
} catch (RemoteException e) {
e.printStackTrace();
}
} else {
Toast.makeText(this, "服务没有开启", Toast.LENGTH_SHORT).show();
}
break;
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (connected) {
unbindService(serviceConnection);
}
}
private void initView() {
mBtnGetList = (Button) findViewById(R.id.btn_getList);
mBtnGetList.setOnClickListener(this);
mBtnAdd = (Button) findViewById(R.id.btn_add);
mBtnAdd.setOnClickListener(this);
findViewById(R.id.btn_connect).setOnClickListener(this);
}
}
简单的实现了aidl调用的demo。
代码传送门