許多COM庫都是一組對象的形式暴露給外界使用，這組對象通常被稱作對象模型。這組對象模型中通常有父對象或者說是根對象，這個對象是允許被創(chuàng)建的，這個根對象有子對象或子對象的集合，這些個子對象不能自主創(chuàng)建他必須被他的根對象創(chuàng)建或者是被他的父對象創(chuàng)建。舉個例子來說可能會更加清晰：比如microsoft outlook對象模型。這個對象模型有個一個根對象是Application，這個對象允許我們用CoCreateInstance來創(chuàng)建，這個COM對象下有一個稱作Namespace的對象，Namespace對象下又有Store這樣的對象，store對象下又有文件夾的集合，這些文件夾中又含有郵件或者是聯(lián)系人等資料的集合，這個集合中的元素下又含有附件集合，如此便構(gòu)成一個象金字塔式的分層體系。這些子對象常是在父對象中創(chuàng)建，不能象根對象一樣呼叫CoCreateInstance等來創(chuàng)建。還有一個更加普通的例子便是MSXML的DOM模型，這個更為大家所熟知。在這些個模型中集合和枚舉器在其中起到了粘合劑的作用。
下面我就對工作中寫的枚舉器過程進行一個簡單回顧，我要實現(xiàn)一個指定范圍內(nèi)的偶數(shù)枚舉器。這個簡單的邏輯能讓我很快地完成回顧，我可以花很少時間關(guān)注別的問題，花更多時間來關(guān)注實現(xiàn)過程。
用向?qū)葾TL項目就叫MyCollection。在這個項目中加入一個Simple Atl Object類，名稱就叫EvenNumbers。這樣就在我們項目中MyCollection.idl文件中產(chǎn)生了相應(yīng)的接口聲明。為接口添加如下的方法或者屬性
1
// MyCollection.idl : MyCollection 的 IDL 源
2//
3
4// 此文件將由 MIDL 工具處理以
5// 產(chǎn)生類型庫(MyCollection.tlb)和封送處理代碼。
6
7import "oaidl.idl";
8import "ocidl.idl";
9
10[
11 object,
12 uuid(D4C7CD02-CD9F-48A6-BD6C-F1B02E66DA1C),
13 dual,
14 nonextensible,
15 helpstring("IEvenNumbers 接口"),
16 pointer_default(unique)
17]
18interface IEvenNumbers : IDispatch
19
{
20
[id(1)] HRESULT Calc([in] LONG lMin, [in] LONG lMax);
21 [propget, id(2)] HRESULT Count([out, retval] LONG* pVal);
22 [propget, id(DISPID_VALUE)] HRESULT Item(LONG nIndex, [out, retval] LONG* pVal);
23 [propget, id(DISPID_NEWENUM)] HRESULT _NewEnum([out, retval] IUnknown** pVal);
24
};
25[
26 uuid(FFFC1807-CFBA-47A0-9036-04AC92E02F8D),
27 version(1.0),
28 helpstring("MyCollection 1.0 類型庫")
29]
30library MyCollectionLib
31{
32 importlib("stdole2.tlb");
33 [
34 uuid(503BB40F-86C8-4D1A-8E5C-5C81460C3EA5),
35 helpstring("EvenNumbers Class")
36 ]
37 coclass EvenNumbers
38
{
39 [default] interface IEvenNumbers;
40
};
41};
42
現(xiàn)在我們完成了大部分的工作，就留下較難的get__NewEnum實現(xiàn)。在理解實現(xiàn)機理后這部分也不算難，這里只是回顧一個寫作過程，并不會太多地說原理，跟著做就可以實現(xiàn)一般應(yīng)用要求的集合枚舉器。不說原理的原因是ATL很復(fù)雜，自己水平又有限。有人說MFC庫是個魔鬼，我認(rèn)為ATL庫的復(fù)雜度也不會比MFC庫容易。ATL庫對C++中的模板應(yīng)用可以說發(fā)揮到了極致。
EvenNumbers.h文件。
#include <vector>
#include "Reuse/VCUE_CopyLong.h"
#include "MyCollection_i.h"
namespace LongColl
{
typedef std::vector<LONG> ContainerType;
typedef VARIANT EnumeratorExposedType;
typedef IEnumVARIANT EnumeratorInterface;
typedef LONG CollectionExposedType;
typedef IEvenNumbers CollectionInterface;
typedef VCUE::GenericCopy<EnumeratorExposedType, ContainerType::value_type> EnumeratorCopyType;
typedef _Copy<CollectionExposedType> CollectionCopyType;
typedef CComEnumOnSTL<EnumeratorInterface,&__uuidof(EnumeratorInterface), EnumeratorExposedType, EnumeratorCopyType, ContainerType> EnumeratorType;
typedef ICollectionOnSTLImpl<CollectionInterface, ContainerType, CollectionExposedType, CollectionCopyType, EnumeratorType> CollectionType;
}
// CEvenNumbers
class ATL_NO_VTABLE CEvenNumbers :
public CComObjectRootEx<CComSingleThreadModel>,
public CComCoClass<CEvenNumbers, &CLSID_EvenNumbers>,
public IDispatchImpl<LongColl::CollectionType, &IID_IEvenNumbers, &LIBID_MyCollectionLib, /**//*wMajor =*/ 1, /**//*wMinor =*/ 0>
{
由于我們的類繼承了ICollectionImpl，所以Item, Count這兩個屬性我們可以不必自己再去實現(xiàn)。我們只要實現(xiàn)Calc方法 及_NewEnum屬性了。這里使用ATL開發(fā)小組提供的文件VCUE_Collection。所以只需一行代碼就解決這個問題。如下：
STDMETHODIMP CEvenNumbers::Calc(LONG lMin, LONG lMax)
{
// TODO: 在此添加實現(xiàn)代碼
if ((lMin % 2) == 1)
{
++lMin;
}
for (LONG i = lMin; i < lMax; i += 2)
{
m_vec.push_back(i);
}
return S_OK;
}
STDMETHODIMP CEvenNumbers::get__NewEnum(IUnknown** pVal)
{
// TODO: 在此添加實現(xiàn)代碼
return VCUE::CreateSTLEnumerator<LongColl::EnumeratorType>(pVal, this, m_vec);
}
到此就做好一個集合枚舉器的例子。可以在C#中使用。如下。
foreach(object obj in evenNumbers)
{ Console.WriteLine(obj.ToString()); }
Sample: http://www.shnenglu.com/Files/Robertxiao/MyCollection.rar