一、前言

　　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、下面......好好聽講! 開始了:-)
　

二、建立 ATL 工程

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


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


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

　　屬性化 屬性化編程，是未來的方向，但我們現(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 href="http://www./document/viewdoc/?id=1493">上回書中介紹的嗎？當(dāng)調(diào)用者調(diào)用進(jìn)程外或遠(yuǎn)程組件功能的時(shí)候，其實(shí)是代理/存根負(fù)責(zé)數(shù)據(jù)交換的。關(guān)于代理/存根的具體變成和操作，以后再說啦......
　　支持 MFC 除非有特殊的原因，我們寫 ATL 程序，最好不要選擇該項(xiàng)。你可能會(huì)說，如果沒有MFC的支持，那CString怎么辦呀？告訴你個(gè)秘密吧，一般人我都不告訴他，我后半輩子就靠著這個(gè)秘密活著了：
　　1、你會(huì)STL嗎？可以用 STL 中的 string 代替；
　　2、自己寫個(gè) MyString 類，嘿嘿；
　　3、悄悄地、秘密地、不要告訴別人（特別是別告訴微軟），把 MFC 中的 CString 源碼拿過來用；
　　4、使用 CComBSTR 類，至少也能簡(jiǎn)化我們字符串操作；
　　5、直接用 API 操作字符串，反正我們大家學(xué)習(xí) C 語(yǔ)言的時(shí)候，都是從這里干起的。（等于沒說，呵呵）
　　支持 COM+ 1.0 支持事務(wù)處理的 COM+ 功能。COM+ 也許在第 99 回介紹吧。


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

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


圖三、選擇建立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) ,見圖四。

 
圖四、填寫名稱

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

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


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

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


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

　　鼠標(biāo)雙點(diǎn)圖八中CFun\基項(xiàng)和接口\Add(...)就可以開始輸入函數(shù)實(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 的字符長(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;
}

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

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

	return S_OK;
}