Android Binder Mechanism (1)

Binder是Android系统中实现进程间通信的核心机制，其本质是一种Proxy模式的具体实现，就像COM，CORBA一样。

Proxy模式的基本思想是客户端程序通过某种方式得到服务器端的代理对象，所有对服务器端的服务请求都发送给该代理对象，该代理对象负责同服务器端进行通信。从客户端的角度看，访问代理对象就如同访问其它本地对象一样；服务器代理对象则屏蔽了所有的进程间通信细节。

本文计划给出一个具体的例子，然后以这个例子为基础，深入剖析一下Android系统的绑定机制。

实例：新增加一个系统服务ExampleService，该服务可以接受一个整形参数，将其值加上100并返回。客户端应用程序使用此服务计算1+100的值。

代码1: 系统服务ExampleService的具体实现

//File:ExampleService.h
#ifndefANDROID_EXAMPLE_SERVICE_H
#defineANDROID_EXAMPLE_SERVICE_H
#include<utils/threads.h>
#include<utils/RefBase.h>
#include<binder/IInterface.h>
#include<binder/BpBinder.h>
#include<binder/Parcel.h>

namespaceandroid{
classExampleService:publicBBinder
{
mutableMutexmLock;
int32_tmNextConnId;
public:
staticintinstantiate();
ExampleService();
virtual~ExampleService();
virtualstatus_tonTransact(uint32_t,constParcel&,Parcel*,uint32_t);
};
};//namespace
#endif

//File:ExampleService.cpp
#include"ExampleService.h"
#include<binder/IServiceManager.h>
#include<binder/IPCThreadState.h>

namespaceandroid{

staticstructsigactionoldact;
staticpthread_key_tsigbuskey;

intExampleService::instantiate()
{
LOGE("ExampleServiceinstantiate");
//调用ServiceManager的addService方法进行系统服务注册，这样客户端程序就可以通过ServiceManager获得此服务的代理对象，从而请求其提供的服务
intr=defaultServiceManager()->addService(String16("byn.example"),newExampleService());
LOGE("ExampleServicer=%d/n",r);
returnr;
}

ExampleService::ExampleService()
{
LOGV("ExampleServicecreated");
mNextConnId=1;
pthread_key_create(&sigbuskey,NULL);
}

ExampleService::~ExampleService()
{
pthread_key_delete(sigbuskey);
LOGV("ExampleServicedestroyed");
}
//每个系统服务都继承自BBinder类，都应重写BBinder的onTransact虚函数。当用户发送请求到达Service时，系统框架会调用Service的onTransact函数
status_tExampleService::onTransact(uint32_tcode,constParcel&data,Parcel*reply,uint32_tflags)
{
switch(code)
{
case0:{
pid_tpid=data.readInt32();
intnum=data.readInt32();
num=num+100;
reply->writeInt32(num);
returnNO_ERROR;
}
break;
default:
returnBBinder::onTransact(code,data,reply,flags);
}
}
};//namespace

#File:Android.mk
LOCAL_PATH:=$(callmy-dir)
include$(CLEAR_VARS)
LOCAL_SRC_FILES:=/
ExampleService.cpp
LOCAL_C_INCLUDES:=$(JNI_H_INCLUDE)
LOCAL_SHARED_LIBRARIES:=/
libutilslibbinder
LOCAL_PRELINK_MODULE:=false
LOCAL_MODULE:=libExample

include$(BUILD_SHARED_LIBRARY)

在/framework/android/src/frameworks/base下面新建一个文件夹ExampleService，将以上三个文件复制到该文件夹中。

代码2：启动ExampleService的应用程序

//File:ExampleServer.cpp
#include<sys/types.h>
#include<unistd.h>
#include<grp.h>
#include<binder/IPCThreadState.h>
#include<binder/ProcessState.h>
#include<binder/IServiceManager.h>
#include<utils/Log.h>
#include<private/android_filesystem_config.h>
#include"../ExampleService/ExampleService.h"

usingnamespaceandroid;

intmain(intargc,char**argv)
{
sp<ProcessState>proc(ProcessState::self());//要想使用Binder机制，必须要创建一个ProcessState对象
sp<IServiceManager>sm=defaultServiceManager();
LOGI("ServiceManager:%p",sm.get());
ExampleService::instantiate();
ProcessState::self()->startThreadPool();
IPCThreadState::self()->joinThreadPool();
return0;
}

#File:Android.mk
LOCAL_PATH:=$(callmy-dir)
include$(CLEAR_VARS)
LOCAL_SRC_FILES:=/
ExampleServer.cpp
LOCAL_C_INCLUDES:=$(JNI_H_INCLUDE)
LOCAL_SHARED_LIBRARIES:=/
libutilslibbinderlibExample
LOCAL_PRELINK_MODULE:=false
LOCAL_MODULE:=ExampleServer

include$(BUILD_EXECUTABLE)

在/framework/android/src/frameworks/base下面新建一个文件夹ExampleServer，将以上两个文件复制到该文件夹中。

代码3：使用ExampleService的客户端应用程序

//File:Example.h
#ifndefANDROID_BYN_EXAMPLE_H
#defineANDROID_BYN_EXAMPLE_H

namespaceandroid
{
classExample{
public:
voidadd100(intn);
private:
staticconstvoidgetExampleService();
};
};//namespace
#endif//ANDROID_BYN_EXAMPLE_H

//File:Example.cpp
#include<binder/IServiceManager.h>
#include<binder/IPCThreadState.h>
#include"Example.h"

namespaceandroid
{
sp<IBinder>binder;
voidExample::add100(intn)
{
getExampleService();
Parceldata,reply;
intanswer;

data.writeInt32(getpid());
data.writeInt32(n);
LOGE("BpExampleService::createremote()->transact()/n");
binder->transact(0,data,&reply);
answer=reply.readInt32();
printf("answner=%d/n",answer);
return;
}

constvoidExample::getExampleService()
{
sp<IServiceManager>sm=defaultServiceManager();
binder=sm->getService(String16("byn.example"));
LOGE("Example::getExampleService%p/n",sm.get());
if(binder==0){
LOGW("ExampleServicenotpublished,waiting...");
return;
}
}
};//namespace

usingnamespaceandroid;

intmain(intargc,char**argv)
{
Example*p=newExample();
p->add100(1);
return0;
}

#File:Example
LOCAL_PATH:=$(callmy-dir)
include$(CLEAR_VARS)
LOCAL_SRC_FILES:=/
Example.cpp
LOCAL_C_INCLUDES:=$(JNI_H_INCLUDE)
LOCAL_SHARED_LIBRARIES:=/
libutilslibbinderlibExample
LOCAL_PRELINK_MODULE:=false
LOCAL_MODULE:=Example

include$(BUILD_EXECUTABLE)

在/framework/android/src/frameworks/base下面新建一个文件夹Example，将以上三个文件复制到该文件夹中。

Build整个Android系统，这里一共会在系统中生成三个文件，分别是

/system/lib/libExample.so

/system/bin/ExampleServer

/system/bin/Example

然后启动我们新添加的ExampleService系统服务，并启动客户端程序验证运行结果。

$> adb shell

# cd /system/bin

# ./ExampleServer &

# ./Example

answer=101

在接下来的几篇文章中，我们会以这个例子为基础，深入分析一下Android系统中Binder机制的各个部分。

参考文献：

1. 云中漫步博客：http://my.unix-center.net/~Simon_fu/

2. 如何撰写自己的第一个核心服务--高焕堂：http://www.android1.net/Topic.aspx?BoardID=21&TopicID=990