向一个类中添加某个接口的实现，这是很常见的需求，特别是用在事件通知、连接点中更是多见。MFC类库内的很多类也都有这样的需求，比如类COleControl就实现了很多的接口。MFC自己实现的方法都用的是嵌套类，并且定义了几个宏来简化该过程。用同样的方法，我们也可以很方便的在自己的类中添加一个接口的实现。CCmdTarget中实现了接口IDispatch，以及IUnknown 的三个函数的缺省实现。一般的MFC类都会从CCmdTarget继承，所以这里讲的是典型的向CCmdTarget的派生类添加接口的方法。
比如，有一个类CSampleView从CView中继承。现在要给它添加一个新的接口IMyTest，该接口只有一个空的方法Test()。添加过程如下：
(1)CSampleView类定义中加入以下代码：
DECLARE_INTERFACE_MAP() //声明接口映射
BEGIN_INTERFACE_PART(TestInterface, IMyTest) //声明实现接口IMyTest的嵌套类
STDMETHOD(Test)();
END_INTERFACE_PART(FontNotify2) |
(2)CSampleView类实现中加入以下代码：
|
BEGIN_INTERFACE_MAP(CSampleView, CCmdTarget)
INTERFACE_PART(CSampleView, IID_IMyTest, TestInterface)
END_INTERFACE_MAP()
STDMETHODIMP_(ULONG) CSampleView::XTestInterface::AddRef( )
{
METHOD_PROLOGUE_EX(CSampleView, TestInterface)
return (ULONG)pThis->ExternalAddRef();
}
STDMETHODIMP_(ULONG) CSampleView::XTestInterface::Release( )
{
METHOD_PROLOGUE_EX(CSampleView, TestInterface)
return (ULONG)pThis->ExternalRelease();
}
STDMETHODIMP CSampleView::XTestInterface::QueryInterface( REFIID iid, LPVOID FAR* ppvObj )
{
METHOD_PROLOGUE_EX(CSampleView, TestInterface)
return (HRESULT)pThis->ExternalQueryInterface(&iid, ppvObj) ;
}
STDMETHODIMP CSampleView::XTestInterface::Test()
{
METHOD_PROLOGUE_EX(CSampleView, TestInterface)
// do something you like
return S_OK ;
} |
揭开宏的神秘面纱，看看它到底是什么东西。以下都是简化的版本。
(1)DECLARE_INTERFACE_MAP
|
struct AFX_INTERFACEMAP_ENTRY
{
const void* piid;
// the interface id (IID) (NULL for aggregate)
size_t nOffset;
// offset of the interface vtable from m_unknown
};
struct AFX_INTERFACEMAP
{
const AFX_INTERFACEMAP* (PASCAL* pfnGetBaseMap)(); // NULL is root class
const AFX_INTERFACEMAP_ENTRY* pEntry; // map for this class
};
#define DECLARE_INTERFACE_MAP() \
private: \
static const AFX_INTERFACEMAP_ENTRY _interfaceEntries[]; \
protected: \
static AFX_DATA const AFX_INTERFACEMAP interfaceMap; \
static const AFX_INTERFACEMAP* PASCAL _GetBaseInterfaceMap(); \
virtual const AFX_INTERFACEMAP* GetInterfaceMap() const; \ |
(2)BEGIN_INTERFACE_PART/END_INTERFACE_PART
|
#define BEGIN_INTERFACE_PART(localClass, baseClass) \// 定义了一个嵌套类
class X##localClass : public baseClass \
{ \
public: \
STDMETHOD_(ULONG, AddRef)(); \
STDMETHOD_(ULONG, Release)(); \
STDMETHOD(QueryInterface)(REFIID iid, LPVOID* ppvObj); \
#define END_INTERFACE_PART(localClass) \
} m_x##localClass; \
friend class X##localClass; \ |
(3)BEGIN_INTERFACE_MAP/INTERFACE_PART/END_INTERFACE_MAP
|
#define offsetof(s,m) (size_t)&(((s *)0)->m)
#define BEGIN_INTERFACE_MAP(theClass, theBase) \
const AFX_INTERFACEMAP* PASCAL theClass::_GetBaseInterfaceMap() \
{ return &theBase::interfaceMap; } \
const AFX_INTERFACEMAP* theClass::GetInterfaceMap() const \
{ return &theClass::interfaceMap; } \
AFX_COMDAT const AFX_DATADEF AFX_INTERFACEMAP theClass::interfaceMap = \
{ &theClass::_GetBaseInterfaceMap, &theClass::_interfaceEntries[0], }; \
AFX_COMDAT const AFX_DATADEF AFX_INTERFACEMAP_ENTRY theClass::_interfaceEntries[] = \
{ \
#define INTERFACE_PART(theClass, iid, localClass) \
{ &iid, offsetof(theClass, m_x##localClass) }, \
#define END_INTERFACE_MAP() \
{ NULL, (size_t)-1 } \
}; \ |
(4)METHOD_PROLOGUE_EX
|
#define METHOD_PROLOGUE_EX(theClass, localClass) \
METHOD_PROLOGUE(theClass, localClass) \
#define METHOD_PROLOGUE(theClass, localClass) \
theClass* pThis = \
((theClass*)((BYTE*)this - offsetof(theClass, m_x##localClass))); \
AFX_MANAGE_STATE(pThis->m_pModuleState) \
pThis; // avoid warning from compiler \ |
METHOD_PROLOGUE最大的作用就是得到pThis指针。该宏用在嵌套类的成员函数中，pThis是其父类的指针，这里也即是CSampleView的this指针。
这些宏与MFC中的消息映射宏非常的相似，在侯捷的《深入浅出MFC》中对消息映射宏有非常详细的讲述。我也无意画蛇添足。它的基本思想就是把各个嵌套类的对象(即m_x开头的变量)放到一个数组里，这样在QueryInterface时就可以得到这些接口的指针了，所谓的接口指针也就是这些嵌套类对象的地址。
CCmdTarget包含了三个函数：ExternalAddRef、ExternalRelease、ExternalQueryInterface。这样我们就不用自己实现IUnknown接口了，只要简单地调用父类的函数就可以了，这实在是很方便。ExternalQueryInterface的执行过程就是先在子类中找要查询的接口，如果找到了就返回其接口指针。如果找不到就通过GetBaseInterfaceMap到父类中去找，以此类推。跟消息映射的处理方法是一样的。
