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函数
*******************************
*/
上述代码的下载地址