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函数 
******************************* 
*/ 

上述代码的下载地址

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

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏DOTNET

Entity Framework——并发策略

使用EF框架遇到并发时,一般采取乐观并发控制。 1支持并发检验 为支持并发检验,需要对实体进行额外的设置。默认情况下是不支持并发检验的。有以下两种方式: ...

4188
来自专栏Java3y

权限管理系统

前言 前面我们做的小项目都是一个表的,业务代码也相对简单。现在我们来做一个权限管理系统,体验一下多表的业务逻辑,顺便巩固一下过滤器的知识。! ---- 目的 现...

2876
来自专栏MasiMaro 的技术博文

OLEDB存取BLOB型数据

现代数据库系统除了支持一些标准的通用数据类型以外,大多数还支持一种称之为BLOB型的数据。 BLOB全称为big large object bytes, 大二...

1403
来自专栏编程

防止黑客SQL注入的方法

一、SQL注入简介 SQL注入是比较常见的网络攻击方式之一,它不是利用操作系统的BUG来实现攻击,而是针对程序员编程时的疏忽,通过SQL语句,实现无帐号登录,甚...

2447
来自专栏JavaEE

mybatis-plus的使用 ------ 入门

mybatis在持久层框架中还是比较火的,一般项目都是基于ssm。虽然mybatis可以直接在xml中通过SQL语句操作数据库,很是灵活。但正其操作都要通过SQ...

3.2K4
来自专栏杂烩

MongoDB Java环境下的开发 原

        在项目下建立一个lib文件夹,将下载的驱动包放到lib下并build到path下:

982
来自专栏逸鹏说道

C# 温故而知新:Stream篇(四)下

上面的例子是将一个文件作为整体进行操作,这样会带来一个问题,当文件很大或者网络不是很稳定的时候会发生意想不到的错误 那我们该怎么解决...

3375
来自专栏CaiRui

flask + pymysql操作Mysql数据库

安装flask-sqlalchemy、pymysql模块 pip install flask-sqlalchemy pymysql  ### Flask-SQL...

5919
来自专栏安恒网络空间安全讲武堂

听说thinkphp又出事了?

0x01 前言 听说thinkphp又出事了,之前看过一次tp5的源码,不过只看了查询(select)的过程,这次问题出在update和insert中,但是归根...

3264
来自专栏Java学习123

MyEclipse10.7安装jad反编译插件

3107

扫码关注云+社区

领取腾讯云代金券