有关两个宏定义的分析

Daniel Wood 20101014

 

转载时请注明出处和作者

文章出处：http://danielwood.cublog.cn

作者：Daniel Wood

--------------------------------------------------------------------------------

这里讲的两个宏定义是IPC中鼎鼎大名的

DECLARE_META_INTERFACE(INTERFACE)

IMPLEMENT_META_INTERFACE(INTERFACE, NAME)

 

定义

frameworks\base\include\utils\IInterface.h

#define DECLARE_META_INTERFACE(INTERFACE) \
    static const String16 descriptor; \
    static sp<I##INTERFACE> asInterface(const sp<IBinder>& obj); \
    virtual String16 getInterfaceDescriptor() const; \

#define IMPLEMENT_META_INTERFACE(INTERFACE, NAME) \
    const String16 I##INTERFACE::descriptor(NAME); \
    String16 I##INTERFACE::getInterfaceDescriptor() const { \
        return I##INTERFACE::descriptor; \
    } \
    sp<I##INTERFACE> I##INTERFACE::asInterface(const sp<IBinder>& obj) \
    { \
        sp<I##INTERFACE> intr; \
        if (obj != NULL) { \
            intr = static_cast<I##INTERFACE*>( \
                obj->queryLocalInterface( \
                        I##INTERFACE::descriptor).get()); \
            if (intr == NULL) { \
                intr = new Bp##INTERFACE(obj); \
            } \
        } \
        return intr; \
    }

说明：其中的I##INTERFACE，##表示连接两个宏定义，在这里INTERFACE是模板名，被当作是宏定义。如果INTERFACE是ServiceManager那么I##INTERFACE就是IServiceManager。

使用：例子ICameraService

定义声明的宏定义：DECLARE_META_INTERFACE(INTERFACE)  

ICameraService.h [frameworks\base\include\ui]

class ICameraService : public IInterface
{
public:
    enum {
        CONNECT = IBinder::FIRST_CALL_TRANSACTION,
    };

public:
    DECLARE_META_INTERFACE(CameraService);

    virtual sp<ICamera> connect(const sp<ICameraClient>& cameraClient) = 0;
};

把这句展开就是：

static const String16 descriptor; \
    static sp<ICameraService > asInterface(const sp<IBinder>& obj); \
    virtual String16 getInterfaceDescriptor() const;


就是说在ICameraService接口类中定义了一个String16的变量和两个函数。

然后在ICameraService.cpp [frameworks\base\libs\ui]中定义另外一个实现的宏定义。

就这么一句：

IMPLEMENT_META_INTERFACE(CameraService, "android.hardware.ICameraService");

展开为：

const String16 ICameraService::descriptor("android.hardware.ICameraService"); \
    String16 ICameraService::getInterfaceDescriptor() const { \
        return ICameraService::descriptor; \
    } \
    sp<ICameraService > ICameraService::asInterface(const sp<IBinder>& obj) \
    { \
        sp<ICameraService > intr; \
        if (obj != NULL) { \
            intr = static_cast<ICameraService *>( \
                obj->queryLocalInterface( \
                        ICameraService::descriptor).get()); \
            if (intr == NULL) { \
                intr = new BpCameraService (obj); \
            } \
        } \
        return intr; \
    }

展开就是说初始化了一个变量descriptor，实现了BpCameraService类的2个函数：getInterfaceDescriptor ()， asInterface()。而且这个宏定义不属于在这个cpp文件中定义的BpCameraService类和在.h文件中定义的BnCameraService类。

在Camera.cpp [frameworks\base\libs\ui]中

 const sp& Camera::getCameraService()函数调用

mCameraService = interface_cast(binder);

著名的interface_cast函数

template<typename INTERFACE>
inline sp<INTERFACE> interface_cast(const sp<IBinder>& obj)
{
    return INTERFACE::asInterface(obj);
}


interface_cast调用的是宏定义中的asInterface函数，然后返回的是new BpCameraService (obj)对象。