宏的使用方式

下面举例记录宏的一种使用方式。

##name  用来在宏定义中传递名称变量。

由于宏定义仅直接插入调用处，可以用来进行函数声明

4.1 interface_cast

[-> IInterface.h]

1 template<typename INTERFACE>
2 inline sp<INTERFACE> interface_cast(const sp<IBinder>& obj)
3 {
4     return INTERFACE::asInterface(obj); //【见小节4.2】
5 }

 

这是一个模板函数，可得出，interface_cast<IServiceManager>() 等价于 IServiceManager::asInterface()。接下来,再来说说asInterface()函数的具体功能。

4.2 IServiceManager::asInterface

对于asInterface()函数，通过搜索代码，你会发现根本找不到这个方法是在哪里定义这个函数的, 其实是通过模板函数来定义的，通过下面两个代码完成的：

1 //位于IServiceManager.h文件 【见小节4.3】
2 DECLARE_META_INTERFACE(ServiceManager)
3 //位于IServiceManager.cpp文件 【见小节4.4】
4 IMPLEMENT_META_INTERFACE(ServiceManager,"android.os.IServiceManager")

 

接下来，再说说这两行代码分别完成的功能：

4.3 DECLARE_META_INTERFACE

[-> IInterface.h]

1 #define DECLARE_META_INTERFACE(INTERFACE)                               \
2     static const android::String16 descriptor;                          \
3     static android::sp<I##INTERFACE> asInterface(                       \
4             const android::sp<android::IBinder>& obj);                  \
5     virtual const android::String16& getInterfaceDescriptor() const;    \
6     I##INTERFACE();                                                     \
7     virtual ~I##INTERFACE();                                            \

 

位于IServiceManager.h文件中,INTERFACE=ServiceManager展开即可得：

[-> IServiceManager.h]

1 static const android::String16 descriptor;
2 
3 static android::sp< IServiceManager > asInterface(const android::sp<android::IBinder>& obj)
4 
5 virtual const android::String16& getInterfaceDescriptor() const;
6 
7 IServiceManager ();
8 virtual ~IServiceManager();

 

该过程主要是声明asInterface(),getInterfaceDescriptor()方法.

4.4 IMPLEMENT_META_INTERFACE

[-> IInterface.h]

 1 #define IMPLEMENT_META_INTERFACE(INTERFACE, NAME)                       \
 2     const android::String16 I##INTERFACE::descriptor(NAME);             \
 3     const android::String16&                                            \
 4             I##INTERFACE::getInterfaceDescriptor() const {              \
 5         return I##INTERFACE::descriptor;                                \
 6     }                                                                   \
 7     android::sp<I##INTERFACE> I##INTERFACE::asInterface(                \
 8             const android::sp<android::IBinder>& obj)                   \
 9     {                                                                   \
10         android::sp<I##INTERFACE> intr;                                 \
11         if (obj != NULL) {                                              \
12             intr = static_cast<I##INTERFACE*>(                          \
13                 obj->queryLocalInterface(                               \
14                         I##INTERFACE::descriptor).get());               \
15             if (intr == NULL) {                                         \
16                 intr = new Bp##INTERFACE(obj);                          \
17             }                                                           \
18         }                                                               \
19         return intr;                                                    \
20     }                                                                   \
21     I##INTERFACE::I##INTERFACE() { }                                    \
22     I##INTERFACE::~I##INTERFACE() { }                                   \

 

位于IServiceManager.cpp文件中,INTERFACE=ServiceManager, NAME=”android.os.IServiceManager”展开即可得：

[-> IServiceManager.cpp]

 1 const android::String16 IServiceManager::descriptor(“android.os.IServiceManager”);
 2 
 3 const android::String16& IServiceManager::getInterfaceDescriptor() const
 4 {
 5      return IServiceManager::descriptor;
 6 }
 7 
 8  android::sp<IServiceManager> IServiceManager::asInterface(const android::sp<android::IBinder>& obj)
 9 {
10        android::sp<IServiceManager> intr;
11         if(obj != NULL) {
12            intr = static_cast<IServiceManager *>(
13                obj->queryLocalInterface(IServiceManager::descriptor).get());
14            if (intr == NULL) {
15                intr = new BpServiceManager(obj);  //【见小节4.5】
16             }
17         }
18        return intr;
19 }
20 
21 IServiceManager::IServiceManager () { }
22 IServiceManager::~ IServiceManager() { }

 

不难发现，[小节4.2]的IServiceManager::asInterface() 等价于 new BpServiceManager()。在这里，更确切地说应该是new BpServiceManager(BpBinder)。

 

5.1

Native层的Binder架构,通过如下两个宏,非常方便地创建了new Bp##INTERFACE(obj):

1 //用于申明asInterface(),getInterfaceDescriptor()
2 #define DECLARE_META_INTERFACE(INTERFACE) 
3 #define IMPLEMENT_META_INTERFACE(INTERFACE, NAME) //用于实现上述两个方法

 

例如:

1 // 实现BPServiceManager对象
2 IMPLEMENT_META_INTERFACE(ServiceManager,"android.os.IServiceManager")

 

等价于:

 1 const android::String16 IServiceManager::descriptor(“android.os.IServiceManager”);
 2 const android::String16& IServiceManager::getInterfaceDescriptor() const
 3 {
 4      return IServiceManager::descriptor;
 5 }
 6 
 7  android::sp<IServiceManager> IServiceManager::asInterface(const android::sp<android::IBinder>& obj)
 8 {
 9        android::sp<IServiceManager> intr;
10         if(obj != NULL) {
11            intr = static_cast<IServiceManager *>(
12                obj->queryLocalInterface(IServiceManager::descriptor).get());
13            if (intr == NULL) {
14                intr = new BpServiceManager(obj);
15             }
16         }
17        return intr;
18 }
19 
20 IServiceManager::IServiceManager () { }
21 IServiceManager::~ IServiceManager() { }