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

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