一、前言

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

二、建立 ATL 工程

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


圖一、新建 ATL 項(xiàng)目


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

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


三、添加 ATL 對(duì)象類

　　步驟3.1：菜單"項(xiàng)目\添加類..."（或者用鼠標(biāo)右鍵在 項(xiàng)目中彈出菜單"添加\添加類..."）并選擇 ATL 簡(jiǎn)單對(duì)象。見(jiàn)圖三。


圖三、選擇建立ATL簡(jiǎn)單對(duì)象

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

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

?
圖四、填寫(xiě)名稱

　　其實(shí)，我們只需要輸入簡(jiǎn)稱，其它的項(xiàng)目會(huì)自動(dòng)填寫(xiě)。沒(méi)什么多說(shuō)的，只請(qǐng)大家注意一下 ProgID 項(xiàng)，默認(rèn)的 ProgID 構(gòu)造方式為“項(xiàng)目名.簡(jiǎn)稱名”。

　　步驟3.3：填寫(xiě)接口屬性選項(xiàng)，見(jiàn)圖 五。


圖五、接口選項(xiàng)

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


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


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


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

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


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

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


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

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

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

	return S_OK;
}

這個(gè)太簡(jiǎn)單了，不再浪費(fèi)“口條”。下面我們實(shí)現(xiàn)字符串連接的Cat()函數(shù)：

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

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

	return S_OK;
}

學(xué)生：上面的函數(shù)實(shí)現(xiàn)，完全是調(diào)用基本的 API 方式完成的。
老師：是的，說(shuō)實(shí)話，的確比較煩瑣。
學(xué)生：我們是用memcpy()完成連接第二個(gè)字符串功能的，那么為什么不用函數(shù) wcscat()那？
老師：多數(shù)情況下可以，但你需要知道：由于BSTR包含有字符串長(zhǎng)度，因此實(shí)際的BSTR字符串內(nèi)容中是可以存儲(chǔ)L''\0''的，而函數(shù) wcscat() 是以L''\0''作為復(fù)制結(jié)束標(biāo)志，因此可能會(huì)丟失數(shù)據(jù)。明白了嗎？
學(xué)生：明白，明白。我看過(guò)《COM 組件設(shè)計(jì)與應(yīng)用(三)之?dāng)?shù)據(jù)類型》后就明白了。那么老師，有沒(méi)有簡(jiǎn)單一些的方法那？
老師：有呀，你看......

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

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

	return S_OK;
}

學(xué)生：哈哈，好！使用了 CComBSTR，這個(gè)就簡(jiǎn)單多了。CComBSTR::Copy()和CComBSTR::Detach()有什么區(qū)別？
老師：CComBSTR::Copy() 會(huì)制造一個(gè) BSTR 的副本，另外CComBSTR::CopyTo()也有類似功能。而CComBSTR::Detach()是使對(duì)象與內(nèi)部的 BSTR 指針剝離，這個(gè)函數(shù)由于沒(méi)有復(fù)制過(guò)程，因此速度稍微快一點(diǎn)點(diǎn)。但要注意，一但剝離后，就不能再使用該對(duì)象啦。
學(xué)生：老師，您講的太牛啦，我對(duì)您的敬仰如巍巍泰山，直入云霄......
老師：STOP，STOP！留作業(yè)啦......
　　1、自己先按照今天講的內(nèi)容寫(xiě)出這個(gè)組件；
　　2、不管你懂不懂，一定要去觀察 IDL 文件，CPP 文件；
　　3、編譯后，看都產(chǎn)生了些什么文件？如果是文本的文件，就打開(kāi)看看；
　　4、下載本文的示例程序(vc.net 2003版本)編譯運(yùn)行，看看效果。然后預(yù)習(xí)一下示例程序中的調(diào)用方法；
學(xué)生：知道啦，快下課吧，我要上廁所，我都憋的不行了......
老師：下課！別忘了頂我的帖子呀......


六、小結(jié)

　　本回介紹第一個(gè)ATL組件程序的建立步驟，而如何使用該組件，敬請(qǐng)關(guān)注《COM 組件設(shè)計(jì)與應(yīng)用(七)》。

---

注1：Apartment，系統(tǒng)通過(guò)隱藏的窗口消息來(lái)排隊(duì)組件調(diào)用，因此我們可以暫時(shí)不考慮同步問(wèn)題。注意，是暫時(shí)哈。
注2：雙接口表示在一個(gè)接口中，同時(shí)支持自定義接口和 IDispatch 接口。以后，以后，以后就講。因?yàn)殡p接口非常重要，我們以后會(huì)天天講、夜夜講、常常講------簡(jiǎn)稱“三講”:)
注3：組件的重用方法有2個(gè)，聚合和包容。
注4：這些都是 IDL 文件中的概念，以后用到什么，就介紹什么。