深入BREW接口机制

初学Brew时，最烦人的就是接口的定义了，一大堆的宏，让人不知所云。这里，将以helloworld为例，我们一步一步揭开它的神秘面纱。

1．helloworld：

typedef struct _helloworld {

       AEEApplet      a ;           //第一个成分必须是 AEEApplet

    AEEDeviceInfo  DeviceInfo; // 设备信息

    IDisplay      *pIDisplay;  // 显示

    IShell        *pIShell;    //指向Shell

    //加入自己的变量

} helloworld;

 

2．AEEApplet

看看， 什么是AEEApplet呢?

typedef struct _AEEApplet AEEApplet;

struct _AEEApplet

{

   DECLARE_VTBL(IApplet) 

   AEECLSID       clsID;  

   uint32         m_nRefs;                     // Applet reference counter

       ……  //其它的变量定义

};

DECLARE_VTBL(IApplet)又是什么？

它的宏定义为:

#define DECLARE_VTBL(iname)      iname   vt##iname;

解开后为 

struct _AEEApplet

{

   IApplet vtApplet;  //定义了一个接口

   AEECLSID       clsID;  

   uint32         m_nRefs;                     // Applet reference counter

       ……  //其它的变量定义

};

3．IApplet

IApplet又是什么东东呢？ 这个比较难找。

在AEE.h中找到如下代码：

typedef struct _IApplet         IApplet;

#define INHERIT_IApplet(iname) /

   INHERIT_IBase(iname); /

   boolean  (*HandleEvent)(iname * po, AEEEvent evt, uint16 wp, uint32 dwp)

 

QINTERFACE(IApplet)

{

   INHERIT_IApplet(IApplet);

};

#define IAPPLET_AddRef(p)                    GET_PVTBL(p,IApplet)->AddRef(p)

#define IAPPLET_Release(p)                   GET_PVTBL(p,IApplet)->Release(p)

还是看看解开后是什么吧：

struct _IApplet {

  struct IAppletVtbl *pvt;

};

typedef struct IAppletVtbl IAppletVtbl;

struct IAppletVtbl

{

    uint32 (*AddRef) (IApplet*);

uint32 (*Release) (IApplet*);

boolean (*HandleEvent)(IApplet * po, uint16 evt, uint16 wp, uint32 dwp);

};

至于宏定义

#define IAPPLET_AddRef(p)                    GET_PVTBL(p,IApplet)->AddRef(p)

展开来后则成了：

#define IAPPLET_AddRef(p)  (IApplet  *)p->pvt->AddRef(p)

我们看到IApplet的定义中，只有一个变量，是一个指向vbtl的指针，名字为pvt，这就解释了为什么我们的Applet也会有一个pvt指针啦。

因为helloworld的第一个变量为IApplet类型的，当我们对helloworld时行向上转型到IApplet时，我们就可以使用IApplet类型中定义的成员变量。可以理解成C++中的子类与父类的继承关系。

4．AEEApplet_New

再回到AEEAppGen.c中，我们就能更好的理解AEEApplet_New的思想了。

在分配Applet内存时，分配的并不仅仅是helloworld结构内存的大小，而是helloworld结构大小再加上IappletVtbl的大小。

(AEEApplet*)MALLOC(nSize + sizeof(IAppletVtbl))

从前面的定义我们知道，IAppletVtbl实际是一组函数指针，给vtbl分配了内存后，就要对它进行初始化，让它指向实际的函数地址。这样才可以通过我们前面的宏定义来执行实际的函数：

如#define IAPPLET_AddRef(p)  (IApplet  *)p->pvt->AddRef(p)

这一段代码如下：

   appFuncs = (IAppletVtbl *)((byte *)pme + nSize);//让appFuns指向实际分配的内存块

   //Initialize the individual entries in the VTBL

   appFuncs->AddRef      = AEEApplet_AddRef; //实际的AddRef函数地址

   appFuncs->Release     = AEEApplet_Release;//实际的Release函数地址

   appFuncs->HandleEvent = AEEApplet_HandleEvent;//实际的HandleEvent地址

下面就要对Iapplet的pvt进行符值，让它指向这一块vtbl啦。

   INIT_VTBL(pme, IApplet, *appFuncs); 

宏展开再看看：

   ((IApplet *)pme)->pvt = (IAppletVtbl *)appFuncs;

5．结论：

由此我们可以看到，在brew中，所谓的接口，不过是一个指针，不同类型的接口的指针指向了不同的的函数指针表，可以理解为C++中的Vtbl。

对于某一接口的的实例，它的第一个变量就是指向Vtbl的指针，一般来讲，它的Vtbl表是存在这个类实例的尾端的。在这个类初始化时，必须同时对它的vtbl也要初始化。