本文首先論述可連接配接對象和連接配接點機制的原理,然後通過一個示例說明怎樣用MFC程式設計實作可連接配接對象和内嵌于客戶的事件接收器.
1、可連接配接對象和連接配接點機制的基本原理
為了在元件對象和客戶之間提供更大的互動能力,元件對象也需要主動與客戶進行通信。元件對象通過出接口(Outgoing Interface)與客戶進行通信。如果一個元件對象定義了一個或者多個出接口則此元件對象叫做可連接配接點對象。
所謂出接口也是COM接口。每個出接口包含一組成員函數,每個成員函數代表了一個事件、一個通知或者一個請求。但是這些接口是在客戶的事件接收器(sink)中實作的,是以叫出接口。事件接收器也是COM對象。
可連接配接對象必須實作一個IConnectionPointContainer接口用于管理所有的出接口。每個出接口對應一個連接配接點對象,連接配接點對象實作了IConnectionPoint接口。客戶正是通過IConnectionPoint接口與可連接配接對象建立連接配接。每一個連接配接用CONNECTDATA結構描述。
CONNECTDATA包含兩個成員:IUnknown* pUnk和DWORD dwCookie。pUnk對應于客戶中事件接收器的IUnknown接口指針;dwCookie是由連接配接點對象生成的用于唯一辨別此連接配接的32位整數。
通過一個由可連接配接對象實作的枚舉器接口IEnumConnectionPoints,客戶可以通路可連接配接對象的所有連接配接點。但是要獲得IEnumConnectionPoints接口指針,要通過IConnectionPointContainer::EnumConnectionPoints(IEnumConnectionPoints**)函數,此函數傳回枚舉器接口指針。
通過另一個有可連接配接對象實作的枚舉器接口IEnumConnections,無論客戶還是可連接配接對象都可以通路一個連接配接點上的所有連接配接。通過IConnectionPoint::EnumConnections(IEnumConnections**)函數可以獲得IEnumConnections接口指針。
綜上所述,一個可連接配接對象必須實作四個接口:IConnectionPointContainer、IConnectionPoint、IEnumConnectionPoints、IEnumConnections。這四個接口的定義請閱讀MSDN文檔。
現在結合後面的示例簡單描述一下可連接配接對象和客戶通信的過程。在後面的示例中,可連接配接對象ConnObject定義了出接口IEventSink,對應此出接口,實作了一個連接配接點對象SampleConnPoint(此對象實作了對應于出接口的連接配接點接口IConnectionPoint,接口ID為IID_IEventSink)。
1.客戶在擷取了可連接配接對象的IUnknown接口指針m_pIUnknown後,調用m_pIUnknown->QueryInterface(IID_IConnectionPointContainer,(void**)&pConnPtCont);如果調用成功,pConnPtCont中将存放可連接配接對象的IConnectionPointContainer接口指針。如果調用不成功,則表明對象不是可連接配接對象。
2.調用pConnPtCont->FindConnectionPoint(IID_IEventSink,&pConnPt)。如果調用成功,pConnPt将存放對應于出接口IEventSink的連接配接點對象SampleConnPoint所實作的連接配接點接口IConnectionPoint指針;如果調用不成功,說明可連接配接對象不支援出接口IEventSink。
3.調用pConnPt->Advise(pIEventSink,&m_dwCookie)以建立事件接收器(EventSink)與連接配接點的連接配接。其中pIEventSink是客戶事件接收器IUnknown接口的指針,此指針通過此函數傳遞給了可連接配接對象以便可連接配接對象發起對客戶的通信;m_dwCookie是連接配接辨別,此值由可連接配接對象設定由客戶儲存,客戶還要使用此值以斷開連接配接。
4.可連接配接對象可以通過連接配接點調用客戶事件接收器中的方法。在客戶與連接配接點成功建立連接配接後,連接配接點中已經儲存了客戶事件接收器接口的指針并可以調用pConnPt->GetConnections()來擷取。
5.客戶調用pConnPt->Unadvise(m_dwCookie)來取消連接配接,同時調用pConnPt->Release()釋放連接配接點對象。
2、程式設計執行個體
現在用MFC實作一個可連接配接對象,然後寫一個極為簡單的客戶和時間接收器。
需要說明的是,MFC通過CCmdTarget類實作了IConnectionPointContainer和IEnumConnectionPoints接口,此外,通過CConnectionPoint類實作了IConnectionPoint接口
1.可連接配接對象ConnObject
在這個對象中,實作一個一般的COM接口IEventServer,客戶可以使用此接口的方法DoSomething()作一些事情,但主要的是對象将在此處觸發事件。SampleConnPoint實作連接配接點對象。
(1)在GUIDs.h中寫入:
// {EE888B01-EA9C-11d3-97B5-5254AB191930}
static const IID CLSID_ConnObject = //元件ID
{ 0xee888b01, 0xea9c, 0x11d3, { 0x97, 0xb5, 0x52, 0x54, 0xab, 0x19, 0x19, 0x30 } };
// {EE888B02-EA9C-11d3-97B5-5254AB191930}
static const IID IID_IEventServer = //一般的COM接口,客戶使用此接口的方法
//DoSomething()
{ 0xee888b02, 0xea9c, 0x11d3, { 0x97, 0xb5, 0x52, 0x54, 0xab, 0x19, 0x19, 0x30 } };
{EE888B03-EA9C-11d3-97B5-5254AB191930}
static const IID IID_IEventSink = //連接配接點對象所實作的連接配接點接口ID
{ 0xee888b03, 0xea9c, 0x11d3, { 0x97, 0xb5, 0x52, 0x54, 0xab, 0x19, 0x19, 0x30 } };
2. 在IConnObject.h中寫入
#include "GUIDs.h"
//聲明IEventServer接口
DECLARE_INTERFACE_(IEventServer,IUnknown)
{
STDMETHOD(DoSomething)()PURE;
};
//聲明出接口,此出接口将由客戶的事件接收器實作
DECLARE_INTERFACE_(IEventSink,IUnknown)
{
STDMETHOD(EventHandle)()PURE;
};
3.添加基類為CCmdTarget的類CConnObject.在類聲明檔案CConnObject1.h中加上#include “IConnObject.h”,在類聲明中寫入:
protected:
……
//聲明實作IEventServer接口的嵌套類
BEGIN_INTERFACE_PART(EventServer,IEventServer)
STDMETHOD(DoSomething)();
END_INTERFACE_PART(EventServer)
DECLARE_INTERFACE_MAP()
//聲明實作連接配接點的嵌套類
BEGIN_CONNECTION_PART(CConnObject,SampleConnPoint)
CONNECTION_IID(IID_IEventSink)
END_CONNECTION_PART(SampleConnPoint)
DECLARE_CONNECTION_MAP()
DECLARE_OLECREATE(CConnObject)
說明:BEGIN_CONNECTION_PART和END_CONNECTION_PART宏聲明了實作連接配接點的嵌套類SampleConnPoint,并且是基于CConnectionPoint類的,如果需要重載CConnectionPoint類的成員函數或者添加自己的成員函數,可以在這兩個宏中聲明.這裡,CONNECTION_IID宏重載了CConnectionPoint::GetIID()函數.使用DECLARE_CONNECTION-MAP()宏聲明連接配接點映射表.
4.在類CConnObject的實作檔案中寫入
IMPLEMENT_OLECREATE(CConnObject,"ConnObject",
0xee888b01, 0xea9c, 0x11d3, 0x97, 0xb5, 0x52, 0x54, 0xab, 0x19, 0x19, 0x30);
BEGIN_INTERFACE_MAP(CConnObject,CCmdTarget)
INTERFACE_PART(CConnObject,IID_IEventServer,EventServer)
INTERFACE_PART(CConnObject,IID_IConnectionPointContainer,ConnPtContainer)
END_INTERFACE_MAP()
BEGIN_CONNECTION_MAP(CConnObject,CCmdTarget)
CONNECTION_PART(CConnObject,IID_IEventSink,SampleConnPoint)
END_CONNECTION_MAP()
說明:A.必須在接口映射中寫入INTERFACE_PART(CConnObject,IID_IConnectionPointContainer,ConnPtContainer)以實作IConnectionPointContainer接口.注意,CCmdTarget類内嵌有才ConnPtContainer類以實作IConnectionPointContainer接口,并用m_xConnPtContainer加以記錄.
B.用BEGIN_CONNECTION_MAP和END_CONNECTION_MAP宏實作連接配接點映射.CONNECTION_PART定義了實作連接配接點的類.
5.在CConnObject::CConnObject()中寫入:
EnableConnections();
6.實作IEventServer接口
IEventServer接口是基于IUnknown接口的,實作IUnknown接口的方法這裡不在贅述.在實作檔案中寫入:
STDMETHODIMP
CConnObject::XEventServer::DoSomething()
{
//DoSomething
METHOD_PROLOGUE(CConnObject,EventServer)
pThis->FireEvent();
return S_OK;
}
DoSomething()方法可以為客戶提供需要的服務.這裡着重的是可連接配接對象在此處觸發客戶事件接收器的事件,FireEvent()函數是ConnObject類實作的專門觸發事件的的函數,代碼如下:
void CConnObject::FireEvent()
{
//擷取連接配接點上的連接配接指針隊列
const CPtrArray* pConnections = m_xSampleConnPoint.GetConnections();
ASSERT(pConnections!=NULL);
int cConnections = pConnections->GetSize();
IEventSink* pIEventSink;
//對每一個連接配接觸發事件
for(int i = 0; i < cConnections; i++)
{
//擷取客戶事件接收器接口指針
pIEventSink = (IEventSink*)(pConnections->GetAt(i));
ASSERT(pIEventSink!=NULL);
//調用客戶事件接受器事件處理函數
//此函數是出接口定義,由客戶事件接收器實作的
pIEventSink->EventHandle();
}
}
3、客戶事件接收器(Sink)
事件接收器也是COM對象,也可以用嵌套類來實作,但是它隻是客戶的一個内部對象,是以可以沒有CLSID和類廠.下面示例是一個對話框程式,對話框有三個按鈕:”連接配接”(IDC_CONNECT),”斷開”(IDC_DISCONNECT),”事件”(IDC_EVENT).
1.建立一個基于對話框的工程:ConnClient.
2.在CConnClientDlg中首先加入#include “IConnObject.h”,然後在對話框類聲明中聲明事件接收器嵌套類:
BEGIN_INTERFACE_PART(EventSink,IEventSink)
STDMETHOD(EventHandle)();
END_INTERFACE_PART(EventSink)
同時聲明幾個私有變量:
private:
LPCONNECTIONPOINTCONTAINER pConnPtCont;//記錄元件對象
//IConnectionPointContainer接口指針
LPCONNECTIONPOINT pConnPt;//記錄連接配接點接口指針
DWORD m_dwCookie;//記錄連接配接辨別
IUnknown* m_pIUnknown;//用以記錄元件對象IUnknown接口指針
3.實作事件接收器:
STDMETHODIMP_(ULONG)
CConnClientDlg::XEventSink::AddRef()
{
return 1;
}
STDMETHODIMP_(ULONG)
CConnClientDlg::XEventSink::Release()
{
return 0;
}
STDMETHODIMP
CConnClientDlg::XEventSink::QueryInterface(REFIID riid,void** ppvObj)
{
METHOD_PROLOGUE(CConnClientDlg,EventSink)
if(IsEqualIID(riid,IID_IUnknown)||
IsEqualIID(riid,IID_IEventSink))
{
*ppvObj = this;
AddRef();
return S_OK;
}
else
{
return E_NOINTERFACE;
}
}
STDMETHODIMP
CConnClientDlg::XEventSink::EventHandle() //此函數将被可連接配接對象調用
{
::AfxMessageBox("源對象向事件接收器發出了的通知!");
return S_OK;
}
4.初始化COM庫并建立元件對象執行個體
在CConnClientDlg::OninitDialog()中寫入:
HRESULT hResult;
hResult = ::CoInitialize(NULL);
if(FAILED(hResult))
{
::AfxMessageBox("不能初始化COM庫!");
return FALSE;
}
m_pIUnknown = NULL;
hResult = ::CoCreateInstance(CLSID_ConnObject,NULL,
CLSCTX_INPROC_SERVER,IID_IUnknown,(void**)&m_pIUnknown);
if(FAILED(hResult))
{
m_pIUnknown = NULL;
::AfxMessageBox("不能建立ConnObject對象!");
return FALSE;
}
m_dwCookie = 0;//預置連接配接辨別為0
5.在按鈕”連接配接”(IDC_CONNECT)的CLICK事件處理函數void CConnClientDlg::OnConnect()中寫入:
void CConnClientDlg::OnConnect()
{
if(m_dwCookie!=0)
{
return;
}
if(m_pIUnknown!=NULL)
{
HRESULT hResult;
hResult = m_pIUnknown->QueryInterface(IID_IConnectionPointContainer,
(void**)&pConnPtCont);
if(FAILED(hResult))
{
::AfxMessageBox("不能擷取對象的IConnectionPointContainer接口!");
return;
}
ASSERT(pConnPtCont!=NULL);
hResult = pConnPtCont->FindConnectionPoint(IID_IEventSink,&pConnPt);
if(FAILED(hResult))
{
pConnPtCont->Release();
::AfxMessageBox("不能擷取對象的IEventSink連接配接點接口!");
return;
}
ASSERT(pConnPt!=NULL);
//擷取事件接收器指針
IUnknown* pIEventSink;
m_xEventSink.QueryInterface(IID_IUnknown,(void**)&pIEventSink);
//通過連接配接點接口的Advise方法将事件接收器指針傳給可連接配接對象
if(SUCCEEDED(pConnPt->Advise(pIEventSink,&m_dwCookie)))
{
::AfxMessageBox("與可連接配接對象ConnObject建立連接配接成功!");
}
else
{
::AfxMessageBox("不能與ConnObject建立連接配接!");
}
pConnPt->Release();
pConnPtCont->Release();
return;
}
}
上述代碼與可連接配接對象的連接配接點建立連接配接.
6.編寫按鈕”斷開”(IDC_DISCONNECT)的CLICK處理函數如下:
void CConnClientDlg::OnDisconnect()
{
if(m_dwCookie==0)
{
return;
}
pConnPt->Unadvise(m_dwCookie);
pConnPt->Release();
pConnPtCont->Release();
m_dwCookie = 0;
}
7.編寫按鈕”事件”(IDC_EVENT)的CLICK處理函數:
void CConnClientDlg::OnEvent()
{
if(m_pIUnknown!=NULL)
{
IEventServer* pIEventServer;
HRESULT hResult;
hResult = m_pIUnknown->QueryInterface(IID_IEventServer,(void**)&pIEventServer);
if(FAILED(hResult))
{
::AfxMessageBox("不能擷取IEventServer接口!");
return;
}
pIEventServer->DoSomething();
}
}
這裡,客戶調用元件提供的服務DoSomething(),而正如前面所看到的,元件對象将在這個函數中觸發一個由客戶事件接收器處理(CConnClientDlg::XEventSink::EventHandle())的事件.
8.在退出應用時:
void CConnClientDlg::OnCancel()
{
m_pIUnknown->Release();
::CoUninitialize();
CDialog::OnCancel();
}
運作程式後,首先點選”連接配接”,然後點選”事件”按鈕,這時将彈出MessageBox,并提示” 源對象向事件接收器發出了的通知!”.
小結
正是由于有了可連接配接對象這一機制,實作了客戶與元件對象的雙向通信,使元件對象具有了事件機制.這種類似于”伺服器推送(Server push)”的技術在分布式應用系統中十分重要.
本文所舉示例是用基于IUnknown接口實作的,其實,用自動化接口IDispatch作為出接口更為友善.需要說明的是,用ATL來寫可連接配接對象更為簡潔,MSDN文檔中有一個示例.