COM的通信原理及ATL的通信操作

一、             COM的通信原理

1、  通信模型:一般,我们只使用客户端程序到组件的通信,并且这种通信是通过组件的接口来实现的。现在,我们讲一下服务器到客户端之间如何打开一个双向通信通道,并提供一个功能更加强大的通信环境。按下面的方法可以提供一个具备回调功能(或称通知)的组件:

a)         在一个组件中描述几个接口,其中一部分接口由组件实现(如IMath),一部分接口则由客户端程序实现(如ICallback)。

b)        在客户端程序中,使用自己喜欢的技术实现一个接口,并由组件来描述(如iCallback)。

c)        组件在其中的一个入站接口上实现一个方法(如IMath::Advise),客户端程序可以通过该方法传送它的一个接口指针(ICallback)。

d)              然后组件通过客户端实现的接口调用接口方法,为客户端程序提供通知消息。

2、  引入和引出接口

COM使用incoming interface(引入接口)和outing interface(引出接口)两个术语,来描述组件可以支持的两种不同类型的接口。一个引入接口是指由组件实现的接口,如IMath是个引入接口,因为它是由你的组件来实现的。一个引出接口是指在组件的类型库中描述的接口,但是它实际上是由math组件的客户端程序实现的。

3、  示例

interface ICallback:IDispatch

[

    [id(1),helpstring("显示求和结果")] HRESULT Show([in] long sum);

]

interface IMath:IDispatch

[

    [id(1),helpstring("求和并显示")] HRESULT Add([in] long num1,[in] long num2,[out,retval] long* ret);

    [id(2),helpstring("添加引出接口") HRESULT Advise([in] ICallback* pCallback);

    [id(3),helpstring("释放接口") HRESULT Unadvise();

]

class CMath:IMath

{

    CComPtr<ICallback> m_pCallback;

    STDMETHODIMP Add(long num1,long num2)

    {

        long ret=num1+num2;

        if(m_pCallback)

            m_pCallback->Show(ret);

        return S_OK;

    }

    STDMETHODIMP Advise(ICallback* pCallback)

    {

        m_pCallback=pCallback;

        pCallback->AddRef();

        return S_OK;

    }

    STDMETHODIMP Unadvise()

    {

        m_pCallback->Release();

        m_pCallback=0;

        return S_OK;

    }

}  

客户端程序首先实现ICallback接口中的函数,并把ICallback的实现类通过Advise传给CMath,这样当进行加法时,就能通知客户端了,这就是COM的通信原理。

二、             ATL通信方法

ATL提供了IDispEventSimpleImplIDispEventImpl两个模板类,这两个模板类可用于在 ATL 类中提供连接点接收器支持,为事件调度接口提供了实现,我们只需要对要接收的事件方法提供实现。这些连接点接收器是用事件接收映射(由类提供)来映射的。

1           若要正确地实现类的连接点接收器,必须完成以下步骤:

1.1         为每个外部对象导入类型库 (如:#import "progid:SendEvent.MyMath" raw_interfaces_only, no_namespace, named_guids),

1.2         继承 IDispEventImpl接口(如public:IDispEventSimpleImpl<1,CSumDlg,&DIID_IMathEvents>),

或 继承IDispEventSimpleImpl 接口(如IDispEventImpl<1,CSumDlg,&DIID_IMathEvents,&LIBID_SendEvent,1,0>)。

1.3         声明事件接收映射 ,在类中添加BEGIN_SINK_MAPclassname)、END_SINK_MAP()宏,

1.4         IDispEventSimpleImpl都必须添加一个宏SINK_ENTRY_INFO去实现事件接收映射。如

BEGIN_SINK_MAP(CSumDlg)

   SINK_ENTRY_INFO(1,DIID_IMathEvents,1,OnShow,&ShowInfo)

END_SINK_MAP()

1.5            IDispEventImpl都必须添加一个宏SINK_ENTRYSINK_ENTRY_EX去实现事件接收映射。如

BEGIN_SINK_MAP(CSumDlg)

   SINK_ENTRY_EX(1,DIID_IMathEvents,1,OnShow)

END_SINK_MAP()

1.6         实现事件处理函数,如实现OnShow函数。

1.7         通知(调用DispEventAdvise与数据源建立连接)。

1.8         和取消通知连接点 (调用DispEventUnadvise断开连接)。

2           详细解析

2.1         IDispEventImpl继承于IDispEventSimpleImpl,他们的大部分功能是相同的,区别仅在于IDispEventImp是从类型库中获取接口信息,而IDispEventSimpleImp是通过一个指向SINK_ENTRY_INFO结构体的指针获得事件信息。

2.2            IDispEventImplIDispEventSimpleImpl的参数分别为

IDispEventImpl<
   UINT nID,
   class T,
   const IID* pdiid = &IID_NULL,
   const GUID* plibid = &GUID_NULL,
   WORD wMajor = 0,
   WORD wMinor = 0,
   class tihclass = CcomTypeInfoHolder
>
IDispEventSimpleImpl<
   UINT nID,
   class T,
   const IID* pdiid
>
其中,
nID:唯一标识数据源对象的标志;
T:从IDispEventImpl/ IDispEventSimpleImpl派生的类;
pdiid:要接收的事件调度接口的DIID指针;
plibid:定义了事件接口的类型库的LIBID指针;
wMajor:类型库的主版本号;
wMinor:类型库的次版本号;
tihclass:管理T类的类型信息的类(一般用默认)

2.3         宏的操作

2.3.1       事件接收映射必须以BEGIN_SINK_MAP(class)开头,以END_SINK_MAP()结尾,其中class是接收事件的类。

2.3.2       SINK_ENTRY_INFOSINK_ENTRY_INFOSINK_ENTRY的关系为

SINK_ENTRY_INFO(id, iid, dispid, fn, info)

#define SINK_ENTRY_EX(id, iid, dispid, fn) SINK_ENTRY_INFO(id, iid, dispid, fn, NULL)

#define SINK_ENTRY(id, dispid, fn) SINK_ENTRY_EX(id, IID_NULL, dispid, fn)

其中,

id唯一标识数据源对象的标志,与模板类的第一个参数对应;

iid::要接收的事件调度接口的DIID指针;

dispid:事件的调度ID,与接口中方法的ID对应;

fn:事件处理函数;

infoSINK_ENTRY_INFO结构体的指针,主要包括事件的参数和返回值信息。

posted on 2011-10-13 23:45  信v枫  阅读(1288)  评论(0编辑  收藏  举报