一、前言

　　1、與 《COM 組件設(shè)計與應(yīng)用(五)》的內(nèi)容基本一致。但本回講解的是在 vc.net 2003 下的使用方法，即使你不再使用vc6.0，也請和上一回的內(nèi)容，參照比對。
　　2、這第一個組件，除了所有 COM 組件必須的 IUnknown 接口外，我們再實現(xiàn)一個自己定義的接口 IFun，它有兩個函數(shù)： Add()完成兩個數(shù)值的加法，Cat()完成兩個字符串的連接。
　　3、下面......好好聽講! 開始了:-)
　

二、建立 ATL 工程

　　步驟2.1：建立一個解決方案。
　　步驟2.2：在 該解決方案中，新建一個 vc++ 的 ATL 項目。示例程序叫 Simple2，并選擇DLL方式，見圖一、圖二。


圖一、新建 ATL 項目


圖二、選擇非屬性化的DLL組件類型

　　屬性化 屬性化編程，是未來的方向，但我們現(xiàn)在先不要選它。
　　動態(tài)鏈接庫(DLL) 選擇它。
　　可執(zhí)行文件(EXE) 以后再講。
　　服務(wù)(EXE) 表示建立一個系統(tǒng)服務(wù)組件程序，系統(tǒng)啟動后就會加載并執(zhí)行的程序。
　　允許合并代理/存根(stub)代碼 選擇該項表示把“代理/存根”代碼合并到組件程序中，否則需要單獨編譯，單獨注冊代理存根程序。代理/存根，這個是什么概念？還記得我們在上回書中介紹的嗎？當調(diào)用者調(diào)用進程外或遠程組件功能的時候，其實是代理/存根負責數(shù)據(jù)交換的。關(guān)于代理/存根的具體變成和操作，以后再說啦......
　　支持 MFC 除非有特殊的原因，我們寫 ATL 程序，最好不要選擇該項。你可能會說，如果沒有MFC的支持，那CString怎么辦呀？告訴你個秘密吧，一般人我都不告訴他，我后半輩子就靠著這個秘密活著了：
　　1、你會STL嗎？可以用 STL 中的 string 代替；
　　2、自己寫個 MyString 類，嘿嘿；
　　3、悄悄地、秘密地、不要告訴別人（特別是別告訴微軟），把 MFC 中的 CString 源碼拿過來用；
　　4、使用 CComBSTR 類，至少也能簡化我們字符串操作；
　　5、直接用 API 操作字符串，反正我們大家學習 C 語言的時候，都是從這里干起的。（等于沒說，呵呵）
　　支持 COM+ 1.0 支持事務(wù)處理的 COM+ 功能。COM+ 也許在第 99 回介紹吧。


三、添加 ATL 對象類

　　步驟3.1：菜單"項目\添加類..."（或者用鼠標右鍵在 項目中彈出菜單"添加\添加類..."）并選擇 ATL 簡單對象。見圖三。


圖三、選擇建立ATL簡單對象

　　除了簡單對象(只實現(xiàn)了 IUnknown 接口)，還可以選擇“ATL控件”(ActiveX，實現(xiàn)了10多個接口)......可以選擇的組件對象類型很多，但本質(zhì)上，就是讓向?qū)臀覀兡J加上一些接口。在以后的文章中，陸續(xù)介紹吧。

　　步驟3.2：增加自定義類 CFun(接口 IFun) ,見圖四。

 
圖四、填寫名稱

　　其實，我們只需要輸入簡稱，其它的項目會自動填寫。沒什么多說的，只請大家注意一下 ProgID 項，默認的 ProgID 構(gòu)造方式為“項目名.簡稱名”。

　　步驟3.3：填寫接口屬性選項，見圖 五。


圖五、接口選項

　　線程模型 COM 中的線程，我認為是最討厭，最復雜的部分。COM 線程和公寓的概念，留待后續(xù)介紹?，F(xiàn)在嗎......大家都選"單元"(Apartment)，它代表什么那？簡單地說：當在線程中調(diào)用組件函數(shù)的時候，這些調(diào)用會排隊進行。因此，這種模式下，我們可以暫時不用考慮同步的問題。(注1)
　　接口。雙重(Dual)，這個非常 非常重要，非常非常常用，但我們今天不講(注2)。切記！切記！我們的這第一個 COM 程序中，一定要選擇“自定義”?。。。?/b>（如果你選錯了，請刪除全部內(nèi)容，重新來過。）
　　聚合 我們寫的組件，將來是否允許被別人聚合(注3)使用?！爸荒軇?chuàng)建為聚合”，有點類似 C++ 中的純虛類，你要是總工程師，只負責設(shè)計但不親自寫代碼的話，才選擇它。
　　ISupportErrorInfo 是否支持豐富信息的錯誤處理接口。以后就講。
　　連接點 是否支持連接點接口（事件、回調(diào)）。以后就講。
　　IObjectWithSite 是否支持IE的調(diào)用


四、添加接口函數(shù)


圖六、調(diào)出增加接口方法的菜單


圖七、增加接口函數(shù) Add

　　請按照圖示的方法，增加Add()函數(shù)，增加Cat()函數(shù) 。[in]表示參數(shù)方向是輸入；[out]表示參數(shù)方向是輸出；[out,retval]表示參數(shù)方向是輸出，同時可以作為函數(shù)運算結(jié)果的返回值。一個函數(shù)中，可以有多個[in]、[out]，但[retval]只能有一個，并且要和[out]組合后在最后一個位置。(注4)


圖八、接口函數(shù)定義完成后的圖示

　　我們都知道，要想改變 C++ 中的類函數(shù)，需要修改兩個地方：一是頭文件(.h)中類的函數(shù)聲明，二是函數(shù)體(.cpp)文件的實現(xiàn)處。而我們現(xiàn)在用 ATL 寫組件程序，則還要修改一個地方，就是接口定義(IDL)文件。別著急 IDL 下次就要討論啦。


五、實現(xiàn)接口函數(shù)

　　鼠標雙點圖八中CFun\基項和接口\Add(...)就可以開始輸入函數(shù)實現(xiàn)了：

STDMETHODIMP CFun::Add(long n1, long n2, long *pVal)
{
	*pVal = n1 + n2;

	return S_OK;
}

STDMETHODIMP CFun::Cat(BSTR s1, BSTR s2, BSTR *pVal)
{
	int nLen1 = ::SysStringLen( s1 );	// s1 的字符長度
	int nLen2 = ::SysStringLen( s2 );	// s2 的字符長度

	*pVal = ::SysAllocStringLen( s1, nLen1 + nLen2 );// 構(gòu)造新的 BSTR 同時把 s1 先保存進去
	if( nLen2 )
	{
		::memcpy( *pVal + nLen1, s2, nLen2 * sizeof(WCHAR) );	// 然后把 s2 再連接進去
//		wcscat( *pVal, s2 );
	}

	return S_OK;
}

STDMETHODIMP CFun::Cat(BSTR s1, BSTR s2, BSTR *pVal)
{
	CComBSTR sResult( s1 );
	sResult.AppendBSTR( s2 );

	*pVal = sResult.Copy();
//	*pVal = sResult.Detach();

	return S_OK;
}