Robertxiao

      許多COM庫(kù)都是一組對(duì)象的形式暴露給外界使用，這組對(duì)象通常被稱作對(duì)象模型。這組對(duì)象模型中通常有父對(duì)象或者說(shuō)是根對(duì)象，這個(gè)對(duì)象是允許被創(chuàng)建的，這個(gè)根對(duì)象有子對(duì)象或子對(duì)象的集合，這些個(gè)子對(duì)象不能自主創(chuàng)建他必須被他的根對(duì)象創(chuàng)建或者是被他的父對(duì)象創(chuàng)建。舉個(gè)例子來(lái)說(shuō)可能會(huì)更加清晰：比如microsoft outlook對(duì)象模型。這個(gè)對(duì)象模型有個(gè)一個(gè)根對(duì)象是Application，這個(gè)對(duì)象允許我們用CoCreateInstance來(lái)創(chuàng)建，這個(gè)COM對(duì)象下有一個(gè)稱作Namespace的對(duì)象，Namespace對(duì)象下又有Store這樣的對(duì)象，store對(duì)象下又有文件夾的集合，這些文件夾中又含有郵件或者是聯(lián)系人等資料的集合，這個(gè)集合中的元素下又含有附件集合，如此便構(gòu)成一個(gè)象金字塔式的分層體系。這些子對(duì)象常是在父對(duì)象中創(chuàng)建，不能象根對(duì)象一樣呼叫CoCreateInstance等來(lái)創(chuàng)建。還有一個(gè)更加普通的例子便是MSXML的DOM模型，這個(gè)更為大家所熟知。在這些個(gè)模型中集合和枚舉器在其中起到了粘合劑的作用。

        下面我就對(duì)工作中寫的枚舉器過(guò)程進(jìn)行一個(gè)簡(jiǎn)單回顧，我要實(shí)現(xiàn)一個(gè)指定范圍內(nèi)的偶數(shù)枚舉器。這個(gè)簡(jiǎn)單的邏輯能讓我很快地完成回顧，我可以花很少時(shí)間關(guān)注別的問(wèn)題，花更多時(shí)間來(lái)關(guān)注實(shí)現(xiàn)過(guò)程。

         用向?qū)葾TL項(xiàng)目就叫MyCollection。在這個(gè)項(xiàng)目中加入一個(gè)Simple Atl Object類，名稱就叫EvenNumbers。這樣就在我們項(xiàng)目中MyCollection.idl文件中產(chǎn)生了相應(yīng)的接口聲明。為接口添加如下的方法或者屬性

         現(xiàn)在我們完成了大部分的工作，就留下較難的get__NewEnum實(shí)現(xiàn)。在理解實(shí)現(xiàn)機(jī)理后這部分也不算難，這里只是回顧一個(gè)寫作過(guò)程，并不會(huì)太多地說(shuō)原理，跟著做就可以實(shí)現(xiàn)一般應(yīng)用要求的集合枚舉器。不說(shuō)原理的原因是ATL很復(fù)雜，自己水平又有限。有人說(shuō)MFC庫(kù)是個(gè)魔鬼，我認(rèn)為ATL庫(kù)的復(fù)雜度也不會(huì)比MFC庫(kù)容易。ATL庫(kù)對(duì)C++中的模板應(yīng)用可以說(shuō)發(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這兩個(gè)屬性我們可以不必自己再去實(shí)現(xiàn)。我們只要實(shí)現(xiàn)Calc方法 及_NewEnum屬性了。這里使用ATL開發(fā)小組提供的文件VCUE_Collection。所以只需一行代碼就解決這個(gè)問(wèn)題。如下：

STDMETHODIMP CEvenNumbers::Calc(LONG lMin, LONG lMax)
{
    // TODO: 在此添加實(shí)現(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: 在此添加實(shí)現(xiàn)代碼
 return VCUE::CreateSTLEnumerator<LongColl::EnumeratorType>(pVal, this, m_vec);
}

      到此就做好一個(gè)集合枚舉器的例子。可以在C#中使用。如下。
                  foreach(object obj in evenNumbers)
                  {    Console.WriteLine(obj.ToString()); }
      Sample:       http://m.shnenglu.com/Files/Robertxiao/MyCollection.rar