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的定义：
[cpp] view plain copy
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 //仅支持聚合 三个宏定义如下：
[cpp] view plain copy
#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通过以下的宏来支持外部组件聚合其他组件的接口。
[cpp] view plain copy
#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.内部组件代码
[cpp] view plain copy
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.外部组件代码
[cpp] view plain copy
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.测试代码
[cpp] view plain copy
#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函数
*******************************
*/ 上述代码的下载地址