許多COM庫都是一組對象的形式暴露給外界使用，這組對象通常被稱作對象模型。這組對象模型中通常有父對象或者說是根對象，這個對象是允許被創建的，這個根對象有子對象或子對象的集合，這些個子對象不能自主創建他必須被他的根對象創建或者是被他的父對象創建。舉個例子來說可能會更加清晰：比如microsoft outlook對象模型。這個對象模型有個一個根對象是Application，這個對象允許我們用CoCreateInstance來創建，這個COM對象下有一個稱作Namespace的對象，Namespace對象下又有Store這樣的對象，store對象下又有文件夾的集合，這些文件夾中又含有郵件或者是聯系人等資料的集合，這個集合中的元素下又含有附件集合，如此便構成一個象金字塔式的分層體系。這些子對象常是在父對象中創建，不能象根對象一樣呼叫CoCreateInstance等來創建。還有一個更加普通的例子便是MSXML的DOM模型，這個更為大家所熟知。在這些個模型中集合和枚舉器在其中起到了粘合劑的作用。
下面我就對工作中寫的枚舉器過程進行一個簡單回顧，我要實現一個指定范圍內的偶數枚舉器。這個簡單的邏輯能讓我很快地完成回顧，我可以花很少時間關注別的問題，花更多時間來關注實現過程。
用向導生成ATL項目就叫MyCollection。在這個項目中加入一個Simple Atl Object類，名稱就叫EvenNumbers。這樣就在我們項目中MyCollection.idl文件中產生了相應的接口聲明。為接口添加如下的方法或者屬性
1
// MyCollection.idl : MyCollection 的 IDL 源
2//
3
4// 此文件將由 MIDL 工具處理以
5// 產生類型庫(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
現在我們完成了大部分的工作，就留下較難的get__NewEnum實現。在理解實現機理后這部分也不算難，這里只是回顧一個寫作過程，并不會太多地說原理，跟著做就可以實現一般應用要求的集合枚舉器。不說原理的原因是ATL很復雜，自己水平又有限。有人說MFC庫是個魔鬼，我認為ATL庫的復雜度也不會比MFC庫容易。ATL庫對C++中的模板應用可以說發揮到了極致。
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這兩個屬性我們可以不必自己再去實現。我們只要實現Calc方法 及_NewEnum屬性了。這里使用ATL開發小組提供的文件VCUE_Collection。所以只需一行代碼就解決這個問題。如下：
STDMETHODIMP CEvenNumbers::Calc(LONG lMin, LONG lMax)
{
// TODO: 在此添加實現代碼
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: 在此添加實現代碼
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