ATL源码学习2---聚合的支持

    技术2022-05-11  8

    1.COM组件聚合由来      聚合源自组件重用。当有两个组件A和B,他们分别实现了自己的接口IA和IB。如果有 一个客户程序创建了A对象使得自己可以调用IA的方法,但同时又想获得IB的接口,调用IB的方法。这时候有两种做法:一种是客户程序创建B对象,还有一 种方法是A组件内部创建B组件,然后客户通过某种途径调用B的接口方法。      第一种方法,使得客户必须知道有独立的B组件的存在,第二种方法客户可以认为只有一个组件A,组件A实现了两个接口IA和IB。第二种方法可以制造出一种假象,让客户程序编写更加简单。从组件A如何管理组件B的方法上,第二种方法还可以分为两种:包容和聚合。 包容很简单,如果组件IB接口拥有一个方法PrintB(),那么A组件就要实现一个自己的IB_A接口,并实现IB_A::PrinB( )方法,内部调用IB:: PrinB ()方法。      聚合通常用于IB接口的功能完全不需要做任何的修改,就可以直接交给用户使用的情况。 这时候,如果IB接口的方法很多,包容就显得很笨拙。因为它不得不对每一个方法作一次包装,尽管什么都不做。聚合方式下,A组件直接将IB接口交给客户,客户就可以调用,但是客户仍然以为是A组件实现了IB接口。 2. ATL对聚合的内部组件的支持 ATL通过CComCreator2模板类以及和聚合相关的宏来支持聚合。 CComCreator2的定义: template <class T1, class T2> class CComCreator2 { public: static HRESULT WINAPI CreateInstance(void* pv, REFIID riid, LPVOID* ppv) { ATLASSERT(ppv != NULL); return (pv == NULL) ? T1::CreateInstance(NULL, riid, ppv) : T2::CreateInstance(pv, riid, ppv); } };  

    模板参数T1 和T2 可以是CComCreator或CComFailCreator. 模板参数T1 用来创建非聚合情况下的组件;T2创建被聚合情况下的组件。 和聚合相关的宏有三个: DECLARE_NOT_AGGREGATABLE //不支持聚合 DECLARE_AGGREGATABLE   //支持聚合 DECLARE_ONLY_AGGREGATABLE //仅支持聚合 三个宏定义如下: #define DECLARE_NOT_AGGREGATABLE(x) public:/ typedef ATL::CComCreator2< ATL::CComCreator< ATL::CComObject< x > >, ATL::CComFailCreator<CLASS_E_NOAGGREGATION> > _CreatorClass; #define DECLARE_AGGREGATABLE(x) public:/ typedef ATL::CComCreator2< ATL::CComCreator< ATL::CComObject< x > >, ATL::CComCreator< ATL::CComAggObject< x > > > _CreatorClass; #define DECLARE_ONLY_AGGREGATABLE(x) public:/ typedef ATL::CComCreator2< ATL::CComFailCreator<E_FAIL>, ATL::CComCreator< ATL::CComAggObject< x > > > _CreatorClass;        通过宏的定义可以清楚的看到组件的创建过程。

         如果组件不支持聚合,那么T2就是 CComFailCreator<CLASS_E_NOAGGREGATION>。若想创建被聚合情况下的组件,那么就会调用 CComFailCreator::CreateInstance(),然后直接返回参数CLASS_E_NOAGGREGATION。同样,如果组件仅支持聚合,那么T1就是CComFailCreator<E_FAIL>,创建时直接返回E_FAIL。      CComAggObject提供了两个IUnknown的实现。一个实现用于转发调用给外部的控制对象,包含它的生命期和身份标识符,另一个用于实现外部控制对象的私有用途,用于维护内部对象的生命期和接口查询。CComAggObject拥有IUnknown接口的两套实现方式,一种是通过CComObjectRootEx直接继承获得,一种是通过成员变量CComContainedObject<contained> m_contained间接获得。m_contained变量用于维护m_pOuterUnknown成员。   另外也可以使用CComPloyObject来支持组件聚合。 3.ATL对聚合的外部组件的支持 ATL通过以下的宏来支持外部组件聚合其他组件的接口。 #define COM_INTERFACE_ENTRY_AGGREGATE(iid, punk)/ {&iid,/ (DWORD)offsetof(_ComMapClass, punk),/ _Delegate}, #define COM_INTERFACE_ENTRY_AGGREGATE_BLIND(punk)/ {NULL,/ (DWORD)offsetof(_ComMapClass, punk),/ _Delegate}, #define COM_INTERFACE_ENTRY_AUTOAGGREGATE(iid, punk, clsid)/ {&iid,/ (DWORD)&_CComCacheData</ CComAggregateCreator<_ComMapClass, &clsid>,/ (DWORD)offsetof(_ComMapClass, punk)/ >::data,/ _Cache}, #define COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND(punk, clsid)/ {NULL,/ (DWORD)&_CComCacheData</ CComAggregateCreator<_ComMapClass, &clsid>,/ (DWORD)offsetof(_ComMapClass, punk)/ >::data,/ _Cache},      含有BLIND与没有BLIND的区别是,前者允许外部对象随着内部对象的扩展而扩展,即将内部所有的接口全部聚合到外部对象中。带来的问题是可能暴露内部对象的实体身份信息。后者只能计划选择要聚合的接口。      含有AUTO与没有AUTO的区别是,前者不需要对聚合对象执行任何的初始化,在需要它们时再创建,避免资源浪费。没有AUTO则必须在FinalConstruct函数中预先初始化被聚合的对象。 4.ATL聚合的实例 1.内部组件代码 class ATL_NO_VTABLE CB : public CComObjectRootEx<CComSingleThreadModel>, public CComCoClass<CB, &CLSID_B>, public IB { public: CB() { } DECLARE_REGISTRY_RESOURCEID(IDR_B) DECLARE_AGGREGATABLE(CB); //声明组件CB可以被聚合 DECLARE_PROTECT_FINAL_CONSTRUCT() BEGIN_COM_MAP(CB) COM_INTERFACE_ENTRY(IB) END_COM_MAP() // IB public: STDMETHOD(PrintB)(){ cout<<"执行PrintB函数"<<endl; return 0; }; }; 2.外部组件代码 class ATL_NO_VTABLE CA : public CComObjectRootEx<CComSingleThreadModel>, public CComCoClass<CA, &CLSID_A>, public IA { public: CA(){} DECLARE_REGISTRY_RESOURCEID(IDR_A) DECLARE_GET_CONTROLLING_UNKNOWN() BEGIN_COM_MAP(CA) COM_INTERFACE_ENTRY(IA) COM_INTERFACE_ENTRY_AGGREGATE_BLIND(m_pIB.p) //聚合B组件的IB接口,也可以使用COM_INTERFACE_ENTRY_AUTOAGGREGATE宏,则不需要在FinalConstruct //函数中创建B对象。 END_COM_MAP() DECLARE_PROTECT_FINAL_CONSTRUCT()//声明和定义了GetControllingUnknown函数 HRESULT FinalConstruct(){ HRESULT hr = S_OK; if(!m_pIB) hr = ::CoCreateInstance(CLSID_B, GetControllingUnknown(), CLSCTX_INPROC_SERVER, IID_IUnknown, (void**)&m_pIB); return hr; } void FinalRelease(){ m_pIB.Release();//避免两次析构内部组件 } public: STDMETHOD(PrintA)(){ cout<<"执行PrintA函数"<<endl; return 0; }; CComPtr<IUnknown> m_pIB; }; 3.测试代码 #include <atlbase.h> #import "../../Aggregate/Aggregate.tlb" no_namespace named_guids raw_interfaces_only int main(int argc, char* argv[]) { ::CoInitialize(NULL); CComPtr<IA> pA; HRESULT hr=pA.CoCreateInstance(CLSID_A); pA->PrintA(); CComPtr<IB> pB; hr=pA->QueryInterface(&pB); pB->PrintB(); pB.Release(); pA.Release(); ::CoUninitialize(); return 0; } /* 运行结果为 ******************************* * 执行PrintA函数 * 执行PrintB函数 ******************************* */

     

    上述代码的下载地址

    http://download.csdn.net/source/1676512


    最新回复(0)