Brew平台中Vtbl使用范例

     在Brew开发中，基本上所有的Brew开放的API都是以Vtbl的形式封装并发布，那么如果我们自己想封装某个模块，怎么用Vtbl来实现呢？接下来看一个用Vtbl封装的IQueue。

 

Queue.h文件

 

---

#ifndef _QUEUE_H_ #define _QUEUE_H_ #include "aeestdlib.h" typedef struct _IQueue IQueue; QINTERFACE(IQueue) { void (*IAdd)(IQueue* a_pQueue,void* a_pData); void (*IInsertAt)(IQueue* a_pQueue,void* a_pData,int a_iIndex); void (*IRemove)(IQueue* a_pQueue,void* a_pData); void (*IRemoveAt)(IQueue* a_pQueue,int a_iIndex); void* (*IAt)(IQueue* a_pQueue,int a_iIndex); int (*IIndexOf)(IQueue* a_pQueue,void* a_pData); int (*ISize)(IQueue* a_pQueue); void* (*ILast)(IQueue* a_pQueue); void* (*IFirst)(IQueue* a_pQueue); void (*IRelease)(IQueue* a_pQueue); }; IQueue* IQUEUE_CreateInstance(void); #define IQUEUE_Add(a_pQueue,a_pData) GET_PVTBL(a_pQueue, IQueue)->IAdd(a_pQueue,a_pData) #define IQUEUE_InsertAt(a_pQueue,a_pData,a_iIndex) GET_PVTBL(a_pQueue, IQueue)->IInsertAt(a_pQueue,a_pData,a_iIndex) #define IQUEUE_Remove(a_pQueue,a_pData) GET_PVTBL(a_pQueue, IQueue)->IRemove(a_pQueue,a_pData) #define IQUEUE_RemoveAt(a_pQueue,a_iIndex) GET_PVTBL(a_pQueue, IQueue)->IRemoveAt(a_pQueue,a_iIndex) #define IQUEUE_At(a_pQueue,a_iIndex) GET_PVTBL(a_pQueue, IQueue)->IAt(a_pQueue,a_iIndex) #define IQUEUE_IndexOf(a_pQueue,a_pData) GET_PVTBL(a_pQueue, IQueue)->IIndexOf(a_pQueue,a_pData) #define IQUEUE_Size(a_pQueue) GET_PVTBL(a_pQueue, IQueue)->ISize(a_pQueue) #define IQUEUE_Last(a_pQueue) GET_PVTBL(a_pQueue, IQueue)->ILast(a_pQueue) #define IQUEUE_First(a_pQueue) GET_PVTBL(a_pQueue, IQueue)->IFirst(a_pQueue) #define IQUEUE_Release(a_pQueue) GET_PVTBL(a_pQueue, IQueue)->IRelease(a_pQueue) #endif

 

Queue.c文件

 

---

#include "Queue.h" static void Queue_Add(IQueue* queue,void* data); static void Queue_InsertAt(IQueue* a_pQueue,void* a_pData,int a_iIndex); static void Queue_Remove(IQueue* queue,void* data); static void Queue_RemoveAt(IQueue* queue,int index); static void * Queue_At(IQueue* queue,int index); static int Queue_IndexOf(IQueue* queue,void* data); static int Queue_Size(IQueue* queue); static void * Queue_Last(IQueue* queue); static void * Queue_First(IQueue* queue); static void Queue_Release(IQueue* queue); typedef struct _Element Element; struct _Element { Element * m_pPre; void * m_pData; Element * m_pNext; }; typedef struct _Queue Queue; struct _Queue { DECLARE_VTBL(IQueue) int m_iSize; Element * m_pFirst; Element * m_pLast; }; #define TAPS_QUEUE_SETVTBL(pVtbl, pfnAdd, / pfnInsert, / pfnRemove, / pfnRemoveAt, / pfnAt, / pfnIndexOf, / pfnSize, / pfnLast, / pfnFirst, / pfnRelease) / (pVtbl)->IAdd = (pfnAdd); / (pVtbl)->IInsertAt = (pfnInsert); / (pVtbl)->IRemove = (pfnRemove); / (pVtbl)->IRemoveAt = (pfnRemoveAt); / (pVtbl)->IAt = (pfnAt); / (pVtbl)->IIndexOf = (pfnIndexOf); / (pVtbl)->ISize = (pfnSize); / (pVtbl)->ILast = (pfnLast); / (pVtbl)->IFirst = (pfnFirst); / (pVtbl)->IRelease = (pfnRelease) IQueue* IQUEUE_CreateInstance(void) { Queue *pMe; VTBL(IQueue) *pVtbl; pMe = MALLOC(sizeof(Queue) + sizeof(VTBL(IQueue))); if (!pMe) return NULL; MALLOC(pMe,0,sizeof(Queue) + sizeof(VTBL(IQueue))); pVtbl = (VTBL(IQueue) *)((byte *)pMe + sizeof(Queue)); TAPS_QUEUE_SETVTBL(pVtbl,Queue_Add,Queue_InsertAt, Queue_Remove,Queue_RemoveAt,Queue_At, Queue_IndexOf,Queue_Size,Queue_Last, Queue_First,Queue_Release); INIT_VTBL(pMe, IQueue, *pVtbl); pMe->m_iSize = 0; pMe->m_pFirst = NULL; pMe->m_pLast = NULL; return (IQueue *)pMe; } static void Queue_Add(IQueue* queue,void* data) { Queue* pQueue = (Queue*)queue; ... } static void Queue_InsertAt(IQueue* a_pQueue,void* a_pData,int a_iIndex) { Queue* pQueue = (Queue*)queue; ... } static void Queue_Remove(IQueue* queue,void* data) { Queue* pQueue = (Queue*)queue; ... } static int Queue_IndexOf(IQueue* queue,void* data) { Queue* pQueue = (Queue*)queue; ... } static void * Queue_At(IQueue* queue,int index) { Queue* pQueue = (Queue*)queue; ... } static void Queue_RemoveAt(IQueue* queue,int index) { Queue* pQueue = (Queue*)queue; ... } static int Queue_Size(IQueue* queue) { Queue* pQueue = (Queue*)queue; return pQueue->m_iSize; } static void * Queue_Last(IQueue* queue) { Queue* pQueue = (Queue*)queue; ... } static void * Queue_First(IQueue* queue) { Queue* pQueue = (Queue*)queue; ... } static void Queue_Release(IQueue* queue) { Queue* pQueue = (Queue*)queue; ... FREEIF(pQueue); }

 

 

---

 

以上是代码示例部分，其中值得注意的是IQueue* IQUEUE_CreateInstance(void)方法中的内存分配部分。

 

pMe = MALLOC(sizeof(Queue) + sizeof(VTBL(IQueue)));

 

     这句代码是在堆上面申请了sizeof(Queue) + sizeof(VTBL(IQueue))大小的空间,不难看出，这个空间的大小是Queue结构体的实体大小加上IQueueVtbl的大小，就是把函数接口部分和数据部分都放在一起，以便内存管理.

 

pVtbl = (VTBL(IQueue) *)((byte *)pMe + sizeof(Queue));

 

     这句代码不难看出,分配的内存空间中，内存前面的sizeof(Queue)大小是数据部分,内存后面的 sizeof(VTBL(IQueue))大小是Vtbl虚函数表部分。