VC++ ATL 学习总结
生活随笔
收集整理的這篇文章主要介紹了
VC++ ATL 学习总结
小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,幫大家做個(gè)參考.
ATL (一種微軟程序庫(kù))
ATL,Active Template Library活動(dòng)模板庫(kù),是一種微軟程序庫(kù),支持利用C++語(yǔ)言編寫ASP代碼以及其它ActiveX程序。通過活動(dòng)模板庫(kù),可以建立COM組件,然后通過ASP頁(yè)面中的腳本對(duì)COM對(duì)象進(jìn)行調(diào)用。這種COM組件可以包含屬性頁(yè)、對(duì)話框等控件。
中文名 ATL 類 ? ?型 一種微軟程序庫(kù) 支 ? ?持 C++語(yǔ)言 年 ? ?份 1993年
目錄
1 什么是ATL
2 ATL基本技術(shù)
3 ATL基本使用
4 應(yīng)用舉例
什么是ATL
自從1993年Microsoft首次公布了COM技術(shù)以后,Windows平臺(tái)上的開發(fā)模式發(fā)生了巨大的變化,以COM為基礎(chǔ)的一系列軟件組件化
技術(shù)將Windows編程帶入了組件化時(shí)代。廣大的開發(fā)人員在為COM帶來的軟件組件化趨勢(shì)歡欣鼓舞的同時(shí),對(duì)于COM開發(fā)技術(shù)的難度
和煩瑣的細(xì)節(jié)也感到極其的不便。COM編程一度被視為一種高不可攀的技術(shù),令人望而卻步。開發(fā)人員希望能夠有一種方便快捷的
COM開發(fā)工具,提高開發(fā)效率,更好地利用這項(xiàng)技術(shù)。
針對(duì)這種情況,Microsoft公司在推出COM SDK以后,為簡(jiǎn)
化COM編程,提高開發(fā)效率,采取了許多方案,特別是在MFC(Microsoft Foundation Class)中加入了對(duì)COM和OLE的支持。但是
隨著Internet的發(fā)展,分布式的組件技術(shù)要求COM組件能夠在網(wǎng)絡(luò)上傳輸,而又盡量節(jié)約寶貴的網(wǎng)絡(luò)帶寬資源。采用MFC開發(fā)的COM
組件由于種種限制不能很好地滿足這種需求,因此Microsoft在1995年又推出了一種全新的COM開發(fā)工具ATL。
ATL是ActiveX Template Library 的縮寫,它是一套C++模板庫(kù)。使用ATL能夠快速地開發(fā)出高效、簡(jiǎn)潔的代碼(Effective and Slim?
code),同時(shí)對(duì)COM組件的開發(fā)提供最大限度的代碼自動(dòng)生成以及可視化支持。為了方便使用,從MicrosoftVisual C++5.0版本開始
,Microsoft把ATL集成到Visual C++開發(fā)環(huán)境中。1998年9月推出的Visual Studio 6.0 集成了ATL 3.0版本。ATL已經(jīng)成為Microsoft標(biāo)
準(zhǔn)開發(fā)工具中的一個(gè)重要成員,日益受到C++開發(fā)人員的重視。
ATL究竟給開發(fā)人員帶來了什么樣的益處呢?這還要先從ATL產(chǎn)生以前的COM開發(fā)方式說起。
在ATL產(chǎn)生以前,開發(fā)COM組件的方法主要有兩種:一是使用COM SDK直接開發(fā)COM組件,另一種方式是通過MFC提供的COM支持
來實(shí)現(xiàn)。
直接使用COM SDK開發(fā)COM組件是最基本也是最靈活的方式。通過使用Microsoft提供的開發(fā)包,我們可以直接編寫COM程序。但是
,這種開發(fā)方式的難度和工作量都很大,一方面,要求開發(fā)者對(duì)于COM的技術(shù)原理具有比較深入的了解(雖然對(duì)技術(shù)本身的深刻理解
對(duì)使用任何一種工具都是非常有益的,但對(duì)于COM這樣一整套復(fù)雜的技術(shù)而言,在短時(shí)間內(nèi)完全掌握是很難的),另一方面,直接使
用COM SDK要求開發(fā)人員自己去實(shí)現(xiàn)COM應(yīng)用的每一個(gè)細(xì)節(jié),完成大量的重復(fù)性工作。這樣做的結(jié)果是,不僅降低了工作效率,同時(shí)
也使開發(fā)人員不得不把許多精力投入到與應(yīng)用需求本身無關(guān)的技術(shù)細(xì)節(jié)中。雖然這種開發(fā)方式對(duì)于某些特殊的應(yīng)用很有必要,但這種編
程方式并不符合組件化程序設(shè)計(jì)方法所倡導(dǎo)的可重用性,因此,直接采用COM SDK不是一種理想的開發(fā)方式。
使用MFC提供的COM支持開發(fā)COM應(yīng)用可以說在使用COM SDK基礎(chǔ)上提高了自動(dòng)化程度,縮短了開發(fā)時(shí)間。MFC采用面向?qū)ο蟮姆?
式將COM的基本功能封裝在若干MFC的C++類中,開發(fā)者通過繼承這些類得到COM支持功能。為了使派生類方便地獲得COM對(duì)象的
各種特性,MFC中有許多預(yù)定義宏,這些宏的功能主要是實(shí)現(xiàn)COM接口的定義和對(duì)象的注冊(cè)等通常在COM對(duì)象中要用到的功能。開發(fā)
者可以使用這些宏來定制COM對(duì)象的特性。
另外,在MFC中還提供對(duì)Automation和 ActiveX Control的支持,對(duì)于這兩個(gè)方面,Visual C++也提供了相應(yīng)的AppWizard和
ClassWizard支持,這種可視化的工具更加方便了COM應(yīng)用的開發(fā)。
MFC對(duì)COM和OLE 的支持確實(shí)比手工編寫COM程序有了很大的進(jìn)步。但是MFC對(duì)COM的支持是不夠完善和徹底的,例如對(duì)COM接
口定義的IDL語(yǔ)言,MFC并沒有任何支持,此外對(duì)于近些年來COM和ActiveX技術(shù)的新發(fā)展MFC也沒有提供靈活的支持。這是由MFC設(shè)
計(jì)的基本出發(fā)點(diǎn)決定的。MFC被設(shè)計(jì)成對(duì)Windows平臺(tái)編程開發(fā)的面向?qū)ο蟮姆庋b,自然要涉及Windows編程的方方面面,COM作
為Windows平臺(tái)編程開發(fā)的一個(gè)部分也得到MFC的支持,但是MFC對(duì)COM的支持是以其全局目標(biāo)為出發(fā)點(diǎn)的,因此對(duì)COM 的支持必
然要服從其全局目標(biāo)。從這個(gè)方面而言,MFC對(duì)COM的支持不能很好的滿足開發(fā)者的要求。
隨著Internet技術(shù)的發(fā)展,Microsoft將ActiveX技術(shù)作為其網(wǎng)絡(luò)戰(zhàn)略的一個(gè)重要組成部分大力推廣,然而使用MFC開發(fā)的ActiveX?
Control,代碼冗余量大(所謂的“肥代碼 Fat Code”),而且必須要依賴于MFC的運(yùn)行時(shí)刻庫(kù)才能正確地運(yùn)行。雖然MFC的運(yùn)行時(shí)
刻庫(kù)只有部分功能與COM有關(guān),但是由于MFC的繼承實(shí)現(xiàn)的本質(zhì),ActiveX Control必須背負(fù)運(yùn)行時(shí)刻庫(kù)這個(gè)沉重的包袱。如果采用靜
態(tài)連接MFC運(yùn)行時(shí)刻庫(kù)的方式,這將使ActiveX Control代碼過于龐大,在網(wǎng)絡(luò)上傳輸時(shí)將占據(jù)寶貴的網(wǎng)絡(luò)帶寬資源;如果采用動(dòng)態(tài)連
接MFC運(yùn)行時(shí)刻庫(kù)的方式,這將要求瀏覽器一方必須具備MFC的運(yùn)行時(shí)刻庫(kù)支持。總之MFC對(duì)COM技術(shù)的支持在網(wǎng)絡(luò)應(yīng)用的環(huán)境下也
顯得很不靈活。
解決上述COM開發(fā)方法中的問題正是ATL的基本目標(biāo)。
首先ATL的基本目標(biāo)就是使COM應(yīng)用開發(fā)盡可能地自動(dòng)化,這個(gè)基本目標(biāo)就決定了ATL只面向COM開發(fā)提供支持。目標(biāo)的明確使ATL對(duì)
COM技術(shù)的支持達(dá)到淋漓盡致的地步。對(duì)COM開發(fā)的任何一個(gè)環(huán)節(jié)和過程,ATL都提供支持,并將與COM開發(fā)相關(guān)的眾多工具集成到
一個(gè)統(tǒng)一的編程環(huán)境中。對(duì)于COM/ActiveX的各種應(yīng)用,ATL也都提供了完善的Wizard支持。所有這些都極大地方便了開發(fā)者的使用
,使開發(fā)者能夠把注意力集中在與應(yīng)用本身相關(guān)的邏輯上。
其次,ATL因其采用了特定的基本實(shí)現(xiàn)技術(shù),擺脫了大量冗余代碼,使用ATL開發(fā)出來的COM應(yīng)用的代碼簡(jiǎn)練高效,即所謂的“Slim?
Code”。ATL在實(shí)現(xiàn)上盡可能采用優(yōu)化技術(shù),甚至在其內(nèi)部提供了所有C/C++開發(fā)的程序所必須具有的C啟動(dòng)代碼的替代部分。同時(shí)
ATL產(chǎn)生的代碼在運(yùn)行時(shí)不需要依賴于類似MFC程序所需要的龐大的代碼模塊,包含在最終模塊中的功能是用戶認(rèn)為最基本和最必須的
。這些措施使采用ATL開發(fā)的COM組件(包括ActiveX Control)可以在網(wǎng)絡(luò)環(huán)境下實(shí)現(xiàn)應(yīng)用的分布式組件結(jié)構(gòu)。
第三,ATL的各個(gè)版本對(duì)Microsoft的基于COM的各種新的組件技術(shù)如MTS、ASP等都有很好的支持,ATL對(duì)新技術(shù)的反應(yīng)速度大大快
于MFC。ATL已經(jīng)成為Microsoft支持COM應(yīng)用開發(fā)的主要開發(fā)工具,因此COM技術(shù)方面的新進(jìn)展在很短的時(shí)間內(nèi)都會(huì)在ATL中得到反
映。這使開發(fā)者使用ATL進(jìn)行COM編程可以得到直接使用COM SDK編程同樣的靈活性和強(qiáng)大的功能。
本文的目的就是希望在有限的篇幅中能夠使讀者對(duì)ATL的使用和基本原理有一個(gè)初步的了解,為廣大的COM開發(fā)人員更好地使用ATL開
發(fā)起到拋磚引玉的作用。
ATL基本技術(shù)編輯
雖然使用ATL開發(fā)COM 應(yīng)用是一件非常簡(jiǎn)單的事情,但是在ATL簡(jiǎn)單易用的界面后面卻包含著復(fù)雜的技術(shù)。面對(duì)ATL生成的大量代碼,
我們即使不去深入地了解這些代碼的含義也可以開發(fā)出COM應(yīng)用來,但是如果我們要充分地挖掘ATL的潛力,開發(fā)出更靈活、強(qiáng)大的
COM應(yīng)用,則必須對(duì)ATL使用的基本技術(shù)有所了解。研究ATL的實(shí)質(zhì)最好的教材就是由Visual C++提供的ATL源代碼。本文這一部分只
是對(duì)ATL中用到的最基本的技術(shù)進(jìn)行簡(jiǎn)單的介紹。
簡(jiǎn)單地說來,ATL中所使用的基本技術(shù)包括以下幾個(gè)方面:
COM技術(shù)
C++模板類技術(shù)(Template)
C++多繼承技術(shù)(Multi-Inheritance)
COM技術(shù)是理解ATL的基礎(chǔ),使用ATL進(jìn)行開發(fā)要對(duì)COM技術(shù)的基本概念有最低限度的了解。由于COM是一項(xiàng)非常復(fù)雜龐大的技術(shù)體
系,限于本文的篇幅,這里不再贅述。對(duì)于本文中提到的COM基本概念也不做過多的解釋,請(qǐng)讀者參閱有關(guān)的參考書籍。
作為ATL最核心的實(shí)現(xiàn)技術(shù)的模板是對(duì)標(biāo)準(zhǔn)C++語(yǔ)言的擴(kuò)展,但是在大多數(shù)的C++編程環(huán)境中,人們很少使用它,這是因?yàn)槟0宓墓δ?
雖然很強(qiáng),但是它內(nèi)部機(jī)制比較復(fù)雜,需要比較多的C++知識(shí)和經(jīng)驗(yàn)才能靈活地使用它。在MFC中的CObjectArray等功能類就是由模
板來定義的。完全通過模板來定義程序的整體類結(jié)構(gòu),ATL是迄今為止做得最為成功的。
所謂模板類簡(jiǎn)單地說是對(duì)類的抽象。我們知道C++語(yǔ)言用類定義了構(gòu)造對(duì)象(這里指C++對(duì)象而不是COM對(duì)象)的方式,對(duì)象是類的
實(shí)例,而模板類定義的是類的構(gòu)造方式,使用模板類定義實(shí)例化的結(jié)果產(chǎn)生的是不同的類。因此可以說模板類是“類的類”。
在C++語(yǔ)言中模板類的定義格式如下:
注意:<;和>;是左右尖括號(hào),可能無法正常顯示。
template<class T>
classMyTemp
{
MyTemp<T>(){};
~MyTemp<T>(){};
intMyFunc(inta);
}
………….
IntMyTemp<T>::MyFunc(inta)
{
}
首先使用C++的關(guān)鍵字“template”來聲明一個(gè)模板類的定義。在關(guān)鍵字后面是用尖括號(hào)括起來的類型參數(shù)。正是根據(jù)這個(gè)類型參數(shù),
編譯器才能在編譯過程中將模板類的具體定義轉(zhuǎn)化為一個(gè)實(shí)際的類的定義,即生成一個(gè)新的類。接下來的定義方式與普通的類定義十分
相似,只是在類的函數(shù)定義中都要帶有類型參數(shù)的說明。
下面的程序段說明了模板類的用法:
typedefMyTemp<MyClass>myclassfromtemp;
myclassfromtempm;
inta=m.Myfunc⑽;
通常在使用模板類時(shí)為了方便起見,使用一個(gè)關(guān)鍵字“typedef”為新定義出來的類取一個(gè)名字。在上面的程序段中假設(shè)“MyClass”
是一個(gè)由用戶定義的類,通過將這個(gè)類的名字作為類型參數(shù)傳遞給模板類,我們可以創(chuàng)建一個(gè)新的類,這個(gè)類的行為將以模板類的定義
為基礎(chǔ),例如它具有模板類定義的所有成員函數(shù),同時(shí)這個(gè)類又是對(duì)模板類行為的一種修改,這種修改是通過用戶提供的類型參數(shù)來實(shí)
現(xiàn)的。賦予模板類以不同的類型參數(shù),則得到行為框架相似但具體行為不同的一組類的集合。有了新的類的定義以后,我們可以象使用
普通類一樣來創(chuàng)建一個(gè)類的實(shí)例,即一個(gè)新的對(duì)象,并且調(diào)用這個(gè)對(duì)象的成員函數(shù)。
模板類是對(duì)標(biāo)準(zhǔn)C++語(yǔ)言的最新擴(kuò)展,雖然它的功能很強(qiáng)大,但是要想使用好模板類需要相當(dāng)多的關(guān)于語(yǔ)言和編程的經(jīng)驗(yàn)和知識(shí),而且
錯(cuò)誤地使用模板類又會(huì)對(duì)程序的結(jié)構(gòu)和運(yùn)行效率帶來大的副作用,因此一般的編程環(huán)境和編程書籍對(duì)模板類的使用都采取謹(jǐn)慎的態(tài)度。
而ATL的核心就是由幾十個(gè)模板類構(gòu)成的,通過研究ATL的源代碼可以使我們對(duì)模板類的使用有比較深刻全面的認(rèn)識(shí)。
多繼承技術(shù)同模板一樣,是C++語(yǔ)言中極具爭(zhēng)議性的技術(shù)。使用多繼承技術(shù)可以使程序的設(shè)計(jì)和實(shí)現(xiàn)更加靈活,但是,由于多繼承的復(fù)
雜性和自身概念上的一些問題,使多繼承在各種面向?qū)ο蟮恼Z(yǔ)言環(huán)境中得到的支持都非常有限。例如Small Talk根本就不允許多繼承,
同樣MFC也不支持多繼承技術(shù)。
多繼承最大的問題是所謂的“鉆石結(jié)構(gòu)”。例如下面的代碼:
class A
{
.....
};
class B : public A
{
...
};
class C : public A
{
.....
};
class D : public C,B
{
........
}
由于類D同時(shí)從類C和B繼承,因此在下面的語(yǔ)句中就會(huì)發(fā)生歧義:
1
2
D*pD=newD;
(A*)pD->Func(...);
由于類D通過類C和類B 分別繼承了類A,這里的強(qiáng)制轉(zhuǎn)化就會(huì)發(fā)生歧義。
ATL使用了C++最新規(guī)范中加入的兩個(gè)運(yùn)算符號(hào)static_cast、dynamic_cast代替簡(jiǎn)單的強(qiáng)制轉(zhuǎn)化,從而消除多繼承帶來的歧義。使用這
兩個(gè)運(yùn)算符號(hào),我們可以在對(duì)象運(yùn)行過程中獲取對(duì)象的類型信息。上面的代碼可以采用下面的方式修改:
1
2
D*pD=newD;
static_cast<A*>(static_cast<B*>(pD))->Func(...);
為什么模板類和多繼承技術(shù)會(huì)成為ATL主要的工具呢?原因在于,采用模板可以在編譯過程中快速的生成具有用戶定制功能的類,這對(duì)
于COM這樣一個(gè)復(fù)雜的技術(shù)體系在實(shí)現(xiàn)效率上得到了很大的提高。通過使用模板類,用戶可以把精力集中在自己開發(fā)的類的基本邏輯
上,在完成了自己的類的設(shè)計(jì)以后,通過繼承不同的模板類,生成不同的類,就可以快速地實(shí)現(xiàn)COM的功能,同時(shí)又避免了采用單繼
承結(jié)構(gòu)造成的大量功能冗余。
總之,正是由于在設(shè)計(jì)實(shí)現(xiàn)過程中采用了模板類和多繼承技術(shù),才使ATL成為一個(gè)小巧靈活的COM開發(fā)工具,能夠適應(yīng)開發(fā)人員對(duì)
COM應(yīng)用開發(fā)的各種需要。
ATL基本使用
這一部分將重點(diǎn)介紹ATL的基本使用過程。由于ATL已經(jīng)被集成在Microsoft Visulal Studio的Visual C++開發(fā)環(huán)境中,因此要使用ATL
必須先安裝Visual C++。在下面的討論中有關(guān)COM的基本知識(shí)請(qǐng)參閱有關(guān)的文檔,這里不再詳細(xì)說明。
使用ATL開發(fā)一個(gè)COM應(yīng)用基本可以分為以下幾個(gè)步驟:
創(chuàng)建一個(gè)新的ATL工程,并對(duì)工程的選項(xiàng)進(jìn)行適當(dāng)?shù)呐渲谩?
向新創(chuàng)建的工程添加新的ATL類,并對(duì)該類進(jìn)行一些初始配置工作。
根據(jù)COM應(yīng)用的基本要求向新的ATL類加入新的接口定義,并實(shí)現(xiàn)相應(yīng)的接口成員函數(shù)。
編譯連接工程,注冊(cè)COM應(yīng)用。
下面將根據(jù)這些步驟依次介紹ATL的基本使用過程(給出的是Visual Studio 6.0的使用):
1. 創(chuàng)建工程
首先啟動(dòng)Visual C++集成開發(fā)環(huán)境,選擇“File”菜單下的“New...”命令,在“New”對(duì)話框中選擇“Project”頁(yè)。
選擇“ATL COM AppWizard”項(xiàng),這是創(chuàng)建ATL工程的AppWizard向?qū)肟凇H缓笤凇癙roject name”編輯框中輸入工程的名字,單
擊“OK”按鈕,進(jìn)入AppWizard對(duì)話框。
在AppWizard對(duì)話框中主要的設(shè)置選項(xiàng)有:
COM服務(wù)程序的類型:
-動(dòng)態(tài)連接庫(kù)(Dynamic Linking Library) 最終產(chǎn)生一個(gè)動(dòng)態(tài)連接庫(kù)(DLL)形式的COM服務(wù)程序;
-應(yīng)用程序(Executable application)最終產(chǎn)生一個(gè)可執(zhí)行程序類型(EXE)的COM服務(wù)程序;
- NT服務(wù)(NT Service):產(chǎn)生一個(gè)以NT服務(wù)方式運(yùn)行的COM服務(wù)程序。
允許嵌入Proxy/Stub代碼。由Microsoft提供的MIDL編譯IDL文件以后,將產(chǎn)生用于對(duì)象調(diào)度(Marshaling)的Proxy/Stub的代碼。
傳統(tǒng)地,這部分代碼與COM服務(wù)程序的代碼是分離的,但是由于新的COM標(biāo)準(zhǔn)支持多線程環(huán)境下的COM對(duì)象服務(wù),因此在動(dòng)態(tài)連接
庫(kù)的COM服務(wù)程序中也要有Proxy/Stub的支持。為了支持在網(wǎng)絡(luò)上的傳輸,ATL允許用戶選擇將Proxy/Stub的代碼包括在生成的DLL
代碼中。這個(gè)選項(xiàng)在EXE和NT服務(wù)類型的COM應(yīng)用條件下不可選。
允許支持MFC。由于ATL對(duì)除COM以外的基本的Windows編程方面的支持極為有限,同時(shí)許多程序員對(duì)MFC又非常熟悉,因此在ATL
的工程設(shè)置中允許在ATL工程內(nèi)部支持使用MFC,即可以使用MFC定義的類。這在一方面來看是非常方便的,特別是對(duì)于習(xí)慣于使用
MFC的開發(fā)人員來說,能夠使用MFC提供的各種功能強(qiáng)大的類的支持,而不必直接使用Windows SDK。從另一個(gè)方面來看,在ATL工
程中使用MFC同時(shí)就喪失了ATL代碼輕量級(jí)的特點(diǎn)。
支持MTS。MTS是Microsoft Transaction Server的縮寫,它是Microsoft在COM技術(shù)方面的一個(gè)新的分支,這里不作詳細(xì)說明。
完成上面的設(shè)置以后,可以選擇FINISH完成工程的設(shè)置,ATL將創(chuàng)建相應(yīng)的工程。
2. 加入ATL類
完成工程的創(chuàng)建和設(shè)置以后,下一步就是向工程中加入一個(gè)新的ATL類。Visual Studio集成環(huán)境提供了向?qū)Чぞ摺癆TL Object Wizard
”用于加入一個(gè)新的ATL類。操作過程并不復(fù)雜,只是一組對(duì)話框操作而已。
首先通過集成環(huán)境的“Insert”菜單下的“New ATL Object…”命令進(jìn)入“ATL Object Wizard”對(duì)話框。
這個(gè)對(duì)話框即為創(chuàng)建ATL對(duì)象的向?qū)鹗冀缑妗?duì)話框的左邊部分說明了待創(chuàng)建對(duì)象的基本類型,這里主要有以下的幾種類型:
對(duì)象(Object)基本的COM對(duì)象類型;
控制(Control)ActiveX Control類型的ATL對(duì)象;
其他(Miscellaneous)輔助功能,如對(duì)話框的生成等;
數(shù)據(jù)訪問(Data Access)數(shù)據(jù)訪問,支持MTS等。
右邊部分說明了每種類型的詳細(xì)內(nèi)容,對(duì)于一般的COM服務(wù)程序,使用對(duì)象表中的簡(jiǎn)單對(duì)象(Simple Object)就可以了。
選定待創(chuàng)建對(duì)象的基本類型以后,單擊“Next>;”按鈕進(jìn)入下一步,進(jìn)入對(duì)象屬性設(shè)置對(duì)話框,如圖4和圖5所示。
對(duì)象屬性設(shè)置分為兩個(gè)過程:先是對(duì)象名字標(biāo)識(shí)的設(shè)定,然后是對(duì)對(duì)象的基本屬性進(jìn)行設(shè)置。首先是對(duì)象的名字標(biāo)識(shí)設(shè)置。
在對(duì)象標(biāo)識(shí)編輯框中輸入待創(chuàng)建對(duì)象的名字,ATL對(duì)象向?qū)⑼降馗鶕?jù)用戶輸入的對(duì)象標(biāo)識(shí)設(shè)定該對(duì)象的C++標(biāo)識(shí)和COM標(biāo)識(shí)。對(duì)象
的C++標(biāo)識(shí)包括對(duì)象的類名,cpp文件名和頭文件名。COM標(biāo)識(shí)包括對(duì)象在類型庫(kù)中的CoClass段和實(shí)現(xiàn)的主接口的名字,同時(shí)還有在
系統(tǒng)注冊(cè)表中的類型名以及ProgID。
對(duì)象名字標(biāo)識(shí)設(shè)置完成以后,選擇對(duì)象屬性頁(yè)(Attribute)進(jìn)入對(duì)象的屬性設(shè)置頁(yè)面。
對(duì)象的屬性設(shè)置是ATL對(duì)象創(chuàng)建過程中最復(fù)雜的部分,包括以下幾個(gè)主要部分:
對(duì)象的線程模型(Thread Model)
對(duì)象的線程模型是COM對(duì)象在多線程環(huán)境下被訪問時(shí)對(duì)訪問方式的控制,缺省情況下在ATL中采用的是套間模型Apartment,由系統(tǒng)通
過消息隊(duì)列方式提供并發(fā)控制。
對(duì)象的接口模型(Interface)
COM對(duì)象的接口可以是雙接口(Dual Interface)。雙接口不同于普通接口(Custom Interface) 之處在于雙接口是從Automation基
本接口IDispatch繼承的,而普通接口是從IUnknown接口直接繼承來的。缺省的接口模型是雙接口。
對(duì)象的聚合模型(Aggregate)
COM規(guī)范不允許對(duì)象的實(shí)現(xiàn)繼承,但是可以通過聚合方式重用其它的COM對(duì)象。ATL對(duì)象屬性設(shè)置中的聚合模型可以指定待創(chuàng)建的
COM對(duì)象是否支持聚合模型。缺省的選項(xiàng)是支持對(duì)象的聚合。
對(duì)象對(duì)錯(cuò)誤處理的支持(Support ISupportErrorInfo)
選取這個(gè)選項(xiàng)可以在對(duì)象的運(yùn)行過程中支持錯(cuò)誤處理。缺省情況下這個(gè)選項(xiàng)不被選中。
對(duì)象對(duì)連接點(diǎn)的支持(Support Connection Points)
連接點(diǎn)是COM對(duì)象的事件機(jī)制。選中這個(gè)選項(xiàng)可以使待創(chuàng)建的COM對(duì)象具有發(fā)出事件的能力。缺省情況下該選項(xiàng)不被選中。
對(duì)象對(duì)自由線程調(diào)度的支持(Free Thread Marshaller,簡(jiǎn)稱FTM)
對(duì)象的自由線程調(diào)度是對(duì)象在處于自由線程模型狀態(tài)下,為了簡(jiǎn)化對(duì)象的訪問過程而采用的一種優(yōu)化策略。缺省情況下該選項(xiàng)不被選中
。
對(duì)于上述的任何一個(gè)選項(xiàng)的詳細(xì)描述都涉及到COM技術(shù)一些核心的內(nèi)容,并且都已超出本文的范圍,因此本文只對(duì)ATL給出的缺省選項(xiàng)
加以說明,對(duì)這些內(nèi)容感興趣的讀者可以參考Microsoft提供的文檔。
完成了上面的設(shè)置以后,就可以按“OK”按鈕完成對(duì)象的創(chuàng)建過程。下一步就是向所生成的ATL類的接口中加入成員函數(shù)的定義,以及
接口成員函數(shù)的實(shí)現(xiàn)過程。
3. 加入接口定義,實(shí)現(xiàn)接口函數(shù)
加入了ATL類定義之后,我們可以打開Visual C++集成環(huán)境下項(xiàng)目管理器(Workspace)中的Class View來檢查生成的類定義的情況。
我們可以看到一個(gè)新的類已經(jīng)生成,同時(shí),還生成了相應(yīng)的接口定義。ATL Object Wizard為我們生成了類定義的.h 和.cpp文件,此外
還有用于接口定義的IDL文件。有了這些文件以后,我們就可以為接口加入成員函數(shù),完成類的定義。
首先在Class View中選中相應(yīng)的接口,顯示為接口IATLTest,單擊鼠標(biāo)右鍵打開菜單,如圖7。此彈出式菜單定義了為接口加入屬性和
方法的操作。選取其中的“Add Method...”項(xiàng),可以為接口加入方法成員;選取“Add Property...”則可以為接口加入新的屬性成員
。
加入屬性和方法的對(duì)話框可以參看圖8和圖9。如果我們要在接口中加入一個(gè)方法,則選取“Add Method...”菜單命令。假設(shè)方法名為
ABC,方法的返回類型為COM規(guī)定的HRESULT類型。我們也可以定義非HRESULT返回類型的函數(shù),但是這需要手工修改接口定義的
IDL文件。我們定義ABC方法的一個(gè)參數(shù)為a,類型為整數(shù)型。完成了方法的定義以后,單擊“OK”按鈕則把此方法加入到接口中。
屬性的加入過程是類似的。屬性加入對(duì)話框要求指定屬性的類型、名字以及屬性的訪問方式。在屬性和方法的編輯對(duì)話框中都有一個(gè)“
Attributes”按鈕,在給出了一個(gè)屬性或方法的基本定義之后,單擊此按鈕,可以對(duì)屬性和方法的一些高級(jí)特性進(jìn)行設(shè)置。
方法成員加入以后,我們可以通過Class View來檢查ATL為我們所做的工作。首先我們看到ATL在接口的定義中加入了該方法的定義;
同時(shí)在對(duì)應(yīng)的ATL類定義中,也加入了一個(gè)相應(yīng)的方法的定義;在類對(duì)應(yīng)的.cpp文件中,加入了此方法的實(shí)現(xiàn)框架。此后,我們只要在
這個(gè)函數(shù)框架中加入該方法的代碼邏輯,一個(gè)接口函數(shù)的定義和實(shí)現(xiàn)就基本完成了。依照這種方式,我們可以完成整個(gè)COM對(duì)象的定
義和實(shí)現(xiàn)。
完成以上的步驟之后,我們就可以編譯連接應(yīng)用了。
4. 編譯連接應(yīng)用、注冊(cè)COM服務(wù)程序
對(duì)ATL工程的編譯連接過程包括下面的幾個(gè)步驟:
使用MIDL編譯工程的IDL文件,形成接口定義的頭文件和用于調(diào)度(Marshalling)的代碼;
編譯工程的.cpp文件形成目標(biāo)文件;
連接目標(biāo)文件,形成應(yīng)用模塊;
注冊(cè)COM服務(wù)程序。
關(guān)于工程編譯連接的其它部分同Visual C++中MFC工程的編譯連接過程相似,這里只重點(diǎn)介紹一下COM服務(wù)程序的注冊(cè)過程。
在ATL中,COM服務(wù)程序的注冊(cè)是在工程編譯連接的最后階段,由ATL輔助完成的。在手工的COM編程中,服務(wù)程序的注冊(cè)是比較麻
煩的工作。在ATL中,系統(tǒng)通過讀取在建立工程過程中形成的注冊(cè)腳本文件來完成注冊(cè)工作。注冊(cè)腳本(Register Script 簡(jiǎn)稱RGS)是
ATL提供的文本方式的注冊(cè)輔助文件。下面是注冊(cè)腳本文件的一個(gè)實(shí)例。
HKCR - 表示注冊(cè)表中COM對(duì)象的注冊(cè)項(xiàng),是HKEY_CLASS_ROOT的縮寫
{
AuthTest.ActiveXObject.1 = s 'ActiveXObject Class'
{
CLSID = s ''
} - 對(duì)象的ProgID
AuthTest.ActiveXObject = s 'ActiveXObject Class'
{
CLSID = s ''
} -對(duì)象的與版本無關(guān)的ProgID
NoRemove CLSID -對(duì)象CLSID注冊(cè)項(xiàng)
{
ForceRemove = s 'ActiveXObject Class'
{
ProgID = s 'AuthTest.ActiveXObject.1'
VersionIndependentProgID = s 'AuthTest.ActiveXObject'
InprocServer32 = s '%MODULE% -服務(wù)器類型,表示DLL服務(wù)器
{
val ThreadingModel = s 'both' -線程模型,這里是BOTH型
}
}
}
}
RGS文件包含注冊(cè)COM服務(wù)程序的各項(xiàng)內(nèi)容,通常我們不必修改此RGS文件,必要時(shí)我們也可以手工修改RGS文件來定制模塊的注冊(cè)過
程。
應(yīng)用舉例
上面介紹了使用ATL創(chuàng)建一個(gè)COM服務(wù)程序的基本過程。在介紹過程中,我們實(shí)際上已經(jīng)生成了一個(gè)COM服務(wù)程序的基本框架,只是
沒有填寫實(shí)際的內(nèi)容。在下面部分,我們實(shí)際開發(fā)一個(gè)十分簡(jiǎn)單的COM服務(wù)程序,并且為它編寫一段客戶代碼進(jìn)行測(cè)試,使大家對(duì)使
用ATL開發(fā)COM服務(wù)程序的過程有一個(gè)全面整體的了解。
我們要開發(fā)的服務(wù)程序的功能很簡(jiǎn)單,它只實(shí)現(xiàn)一個(gè)接口,這個(gè)接口名字是ISimpleInterface,接口只有一個(gè)成員函數(shù),叫做Welcome
。這個(gè)函數(shù)的功能只是輸出一個(gè)“Hello World!”的字符串。
按照上一部分介紹的創(chuàng)建COM服務(wù)程序的步驟,我們進(jìn)行如下的操作:
1.打開Visual C++集成開發(fā)環(huán)境;
2.創(chuàng)建一個(gè)稱為SimpleTest的ATL工程;
3.在這個(gè)工程中插入新的對(duì)象,對(duì)象的名字是SimpleInterface;
4.設(shè)置接口ISimpleInterface的有關(guān)屬性,使它成為一個(gè)雙接口;
5.在對(duì)象的接口ISimpleInterface中加入方法Welcome;
6.打開ATL加入的Welcome方法的框架,可以看到如下的代碼段:
STDMETHODIMPCActiveXObject::get_TestProp(long*pVal)
{
?
AFX_MANAGE_STATE(AfxGetStaticModuleState())
?
//TODO:Addyourimplementationcodehere
?
returnS_OK;
?
}
7.將程序框架中的注釋部分替換為下面的代碼:
1
::MessageBox(NULL,_T(”HelloWorld!”),_T(”Welcome”),MB_OK);
Welcome方法被調(diào)用時(shí)將彈出一個(gè)消息框。
8.編譯連接工程。
上面的步驟完成以后,我們就有了一個(gè)簡(jiǎn)單的COM服務(wù)程序,而且已經(jīng)被注冊(cè)到當(dāng)前系統(tǒng)中。
下面我們要完成一個(gè)簡(jiǎn)單的COM客戶程序。一個(gè)COM客戶程序簡(jiǎn)單地說是使用COM組件對(duì)象的程序。客戶程序調(diào)用COM對(duì)象的基本
流程是:
創(chuàng)建COM對(duì)象的實(shí)例。這可以通過調(diào)用Windows系統(tǒng)的API函數(shù)CoCreateInstance來完成。
通過接口調(diào)用函數(shù)。
調(diào)用IUnknown::Release釋放COM對(duì)象實(shí)例
我們的客戶程序是使用MFC編寫的一個(gè)基于對(duì)話框的簡(jiǎn)單應(yīng)用程序。具體的過程如下:
1.打開Visual C++集成開發(fā)環(huán)境;
創(chuàng)建一個(gè)稱為SimpleClient的基于對(duì)話框的MFC工程;
在對(duì)話框中加入一個(gè)按鈕,名字為TEST;
在SimpleClientDlg.cpp文件中加入如下的代碼:
⑴ 在cpp文件 #include “simpleclientdlg.h”之后加入下面的代碼:
#include"d:\simpletest\simpletest.h"
#include"d:\simpletest\simpletest_i.c"
加入的頭文件是在編譯COM服務(wù)程序過程中自動(dòng)生成的,其中包含接口本身的定義、接口IID的定義和COM對(duì)象的CLSID的定義。包含
該頭文件可以使客戶程序能夠使用COM服務(wù)程序。
⑵ 在按鈕TEST的消息控制函數(shù)中加入如下的代碼:
CoInitialize(0);
HRESULThr;
ISimpleInterface*pIntf=NULL;
hr=CoCreateInstance(CLSID_SimpleInterface,NULL,CLSCTX_SERVER,
IID_ISimpleInterface,(void**)&pIntf);
if(SUCCEEDED(hr))
{
pIntf->Welcome();
pIntf->Release();
}
CoUninitialize();
上面的代碼首先通過系統(tǒng)API CoCreateInstance創(chuàng)建COM對(duì)象,得到接口的指針,然后調(diào)用接口成員函數(shù)Welcome,最后通過
IUnknown::Release()函數(shù)釋放COM對(duì)象實(shí)例。
編譯連接客戶程序
最后,我們可以測(cè)試客戶程序是否正常運(yùn)行。啟動(dòng)客戶程序,當(dāng)單擊“TEST”按鈕時(shí)我們可以看到彈出一個(gè)消息框,這正是我們的
COM服務(wù)程序提供的功能。
========
ATL與COM之間的關(guān)系、ATL的特點(diǎn)與基本使用方法
http://blog.csdn.net/chenyujing1234/article/details/7753930?
ATL,Active Template Library活動(dòng)模板庫(kù)
是一種微軟程序庫(kù),支持利用C++語(yǔ)言編寫ASP代碼以及其它ActiveX程序。通過活動(dòng)模板庫(kù),可以建立COM組件,然后通過ASP頁(yè)面
中的腳本對(duì)COM對(duì)象進(jìn)行調(diào)用。這種COM組件可以包含屬性頁(yè)、對(duì)話框等等控件。
ATL簡(jiǎn)介
?一. 什么是ATL
自從1993年Microsoft首次公布了COM技術(shù)以后,Windows平臺(tái)上的開發(fā)模式發(fā)生了巨大的變化,以COM為基礎(chǔ)的一系列軟件組件化
技術(shù)將Windows編程帶入了組件化時(shí)代。廣大的開發(fā)人員在為COM帶來的軟件組件化趨勢(shì)歡欣鼓舞的同時(shí),對(duì)于COM開發(fā)技術(shù)的難度
和煩瑣的細(xì)節(jié)也感到極其的不便。
COM編程一度被視為一種高不可攀的技術(shù),令人望而卻步。開發(fā)人員希望能夠有一種方便快捷的COM開發(fā)工具,提高開發(fā)效率,更好
地利用這項(xiàng)技術(shù)。針對(duì)這種情況,Microsoft公司在推出COM SDK以后,為簡(jiǎn)化COM編程,提高開發(fā)效率,采取了許多方案,特別是
在MFC(Microsoft Foundation Class)中加入了對(duì)COM和OLE的支持。但是隨著Internet的發(fā)展,分布式的組件技術(shù)要求COM組件
能夠在網(wǎng)絡(luò)上傳輸,而又盡量節(jié)約寶貴的網(wǎng)絡(luò)帶寬資源。采用MFC開發(fā)的COM組件由于種種限制不能很好地滿足這種需求,因此
Microsoft在1995年又推出了一種全新的COM開發(fā)工具ATL。
ATL是ActiveX Template Library 的縮寫,它是一套C++模板庫(kù)。使用ATL能夠快速地開發(fā)出高效、簡(jiǎn)潔的代碼(Effective and Slim?
code),同時(shí)對(duì)COM組件的開發(fā)提供最大限度的代碼自動(dòng)生成以及可視化支持。為了方便使用,從Microsoft Visual C++ 5.0版本開
始,Microsoft把ATL集成到Visual C++開發(fā)環(huán)境中。1998年9月推出的Visual Studio 6.0 集成了ATL 3.0版本。目前,ATL已經(jīng)成為
Microsoft標(biāo)準(zhǔn)開發(fā)工具中的一個(gè)重要成員,日益受到C++開發(fā)人員的重視。
1、 ATL究竟給開發(fā)人員帶來了什么樣的益處呢?這還要先從ATL產(chǎn)生以前的COM開發(fā)方式說起。
1、1 ?在ATL產(chǎn)生以前,開發(fā)COM組件的方法主要有兩種:
(1)一是使用COM SDK直接開發(fā)COM組件;
直接使用COM SDK開發(fā)COM組件是最基本也是最靈活的方式。通過使用Microsoft提供的開發(fā)包,我們可以直接編寫COM程序。但是
,這種開發(fā)方式的難度和工作量都很大,一方面,要求開發(fā)者對(duì)于COM的技術(shù)原理具有比較深入的了解(雖然對(duì)技術(shù)本身的深刻理解
對(duì)使用任何一種工具都是非常有益的,但對(duì)于COM這樣一整套復(fù)雜的技術(shù)而言,在短時(shí)間內(nèi)完全掌握是很難的);
另一方面,直接使用COM SDK要求開發(fā)人員自己去實(shí)現(xiàn)COM應(yīng)用的每一個(gè)細(xì)節(jié),完成大量的重復(fù)性工作。這樣做的結(jié)果是,不僅降低
了工作效率,同時(shí)也使開發(fā)人員不得不把許多精力投入到與應(yīng)用需求本身無關(guān)的技術(shù)細(xì)節(jié)中。雖然這種開發(fā)方式對(duì)于某些特殊的應(yīng)用很
有必要,但這種編程方式并不符合組件化程序設(shè)計(jì)方法所倡導(dǎo)的可重用性,因此,直接采用COM SDK不是一種理想的開發(fā)方式。
(2)另一種方式是通過MFC提供的COM支持來實(shí)現(xiàn)。
使用MFC提供的COM支持開發(fā)COM應(yīng)用可以說在使用COM SDK基礎(chǔ)上提高了自動(dòng)化程度,縮短了開發(fā)時(shí)間。MFC采用面向?qū)ο蟮姆?
式將COM的基本功能封裝在若干MFC的C++類中,開發(fā)者通過繼承這些類得到COM支持功能。為了使派生類方便地獲得COM對(duì)象的
各種特性,MFC中有許多預(yù)定義宏,這些宏的功能主要是實(shí)現(xiàn)COM接口的定義和對(duì)象的注冊(cè)等通常在COM對(duì)象中要用到的功能。開發(fā)
者可以使用這些宏來定制COM對(duì)象的特性。
另外,在MFC中還提供對(duì)Automation 和 ActiveX Control的支持,對(duì)于這兩個(gè)方面,Visual C++也提供了相應(yīng)的AppWizard和
ClassWizard支持,這種可視化的工具更加方便了COM應(yīng)用的開發(fā)。
MFC對(duì)COM和OLE 的支持確實(shí)比手工編寫COM程序有了很大的進(jìn)步。但是MFC對(duì)COM的支持是不夠完善和徹底的,例如對(duì)COM接
口定義的IDL語(yǔ)言,MFC并沒有任何支持,此外對(duì)于近些年來COM和ActiveX技術(shù)的新發(fā)展MFC也沒有提供靈活的支持。這是由MFC設(shè)
計(jì)的基本出發(fā)點(diǎn)決定的。MFC被設(shè)計(jì)成對(duì)Windows平臺(tái)編程開發(fā)的面向?qū)ο蟮姆庋b,自然要涉及Windows編程的方方面面,COM作
為Windows平臺(tái)編程開發(fā)的一個(gè)部分也得到MFC的支持,但是MFC對(duì)COM的支持是以其全局目標(biāo)為出發(fā)點(diǎn)的,因此對(duì)COM 的支持必
然要服從其全局目標(biāo)。從這個(gè)方面而言,MFC對(duì)COM的支持不能很好的滿足開發(fā)者的要求。
1、2 ?隨著Internet技術(shù)的發(fā)展,Microsoft將ActiveX技術(shù)作為其網(wǎng)絡(luò)戰(zhàn)略的一個(gè)重要組成部分大力推廣
然而使用MFC開發(fā)的ActiveX Control,代碼冗余量大(所謂的“肥代碼 Fat Code”),而且必須要依賴于MFC的運(yùn)行時(shí)刻庫(kù)才能正
確地運(yùn)行。雖然MFC的運(yùn)行時(shí)刻庫(kù)只有部分功能與COM有關(guān),但是由于MFC的繼承實(shí)現(xiàn)的本質(zhì),ActiveX Control必須背負(fù)運(yùn)行時(shí)刻庫(kù)
這個(gè)沉重的包袱。
(1)如果采用靜態(tài)連接MFC運(yùn)行時(shí)刻庫(kù)的方式,這將使ActiveX Control代碼過于龐大,在網(wǎng)絡(luò)上傳輸時(shí)將占據(jù)寶貴的網(wǎng)絡(luò)帶寬資源;
(2)如果采用動(dòng)態(tài)連接MFC運(yùn)行時(shí)刻庫(kù)的方式,這將要求瀏覽器一方必須具備MFC的運(yùn)行時(shí)刻庫(kù)支持。總之MFC對(duì)COM技術(shù)的支持
在網(wǎng)絡(luò)應(yīng)用的環(huán)境下也顯得很不靈活。
2、解決上述COM開發(fā)方法中的問題正是ATL的基本目標(biāo)。
(1)首先ATL的基本目標(biāo)就是使COM應(yīng)用開發(fā)盡可能地自動(dòng)化,這個(gè)基本目標(biāo)就決定了ATL只面向COM開發(fā)提供支持。目標(biāo)的明確使
ATL對(duì)COM技術(shù)的支持達(dá)到淋漓盡致的地步。對(duì)COM開發(fā)的任何一個(gè)環(huán)節(jié)和過程,ATL都提供支持,并將與COM開發(fā)相關(guān)的眾多工具
集成到一個(gè)統(tǒng)一的編程環(huán)境中。對(duì)于COM/ActiveX的各種應(yīng)用,ATL也都提供了完善的Wizard支持。所有這些都極大地方便了開發(fā)者
的使用,使開發(fā)者能夠把注意力集中在與應(yīng)用本身相關(guān)的邏輯上。
(2)其次,ATL因其采用了特定的基本實(shí)現(xiàn)技術(shù),擺脫了大量冗余代碼,使用ATL開發(fā)出來的COM應(yīng)用的代碼簡(jiǎn)練高效,即所謂
的“Slim Code”。ATL在實(shí)現(xiàn)上盡可能采用優(yōu)化技術(shù),甚至在其內(nèi)部提供了所有C/C++開發(fā)的程序所必須具有的C啟動(dòng)代碼的替代部
分。
同時(shí)ATL產(chǎn)生的代碼在運(yùn)行時(shí)不需要依賴于類似MFC程序所需要的龐大的代碼模塊,包含在最終模塊中的功能是用戶認(rèn)為最基本和最必
須的。這些措施使采用ATL開發(fā)的COM組件(包括ActiveX Control)可以在網(wǎng)絡(luò)環(huán)境下實(shí)現(xiàn)應(yīng)用的分布式組件結(jié)構(gòu)。
(3)第三,ATL的各個(gè)版本對(duì)Microsoft的基于COM的各種新的組件技術(shù)如MTS、ASP等都有很好的支持,ATL對(duì)新技術(shù)的反應(yīng)速度大
大快于MFC。ATL已經(jīng)成為Microsoft支持COM應(yīng)用開發(fā)的主要開發(fā)工具,因此COM技術(shù)方面的新進(jìn)展在很短的時(shí)間內(nèi)都會(huì)在ATL中得
到反映。這使開發(fā)者使用ATL進(jìn)行COM編程可以得到直接使用COM SDK編程同樣的靈活性和強(qiáng)大的功能。
本文的目的就是希望在有限的篇幅中能夠使讀者對(duì)ATL的使用和基本原理有一個(gè)初步的了解,為廣大的COM開發(fā)人員更好地使用ATL開
發(fā)起到拋磚引玉的作用。
二. ATL基本技術(shù)
雖然使用ATL開發(fā)COM 應(yīng)用是一件非常簡(jiǎn)單的事情,但是在ATL簡(jiǎn)單易用的界面后面卻包含著復(fù)雜的技術(shù)。面對(duì)ATL生成的大量代碼,
我們即使不去深入地了解這些代碼的含義也可以開發(fā)出COM應(yīng)用來,但是如果我們要充分地挖掘ATL的潛力,開發(fā)出更靈活、強(qiáng)大的
COM應(yīng)用,則必須對(duì)ATL使用的基本技術(shù)有所了解。研究ATL的實(shí)質(zhì)最好的教材就是由Visual C++提供的ATL源代碼。
本文這一部分只是對(duì)ATL中用到的最基本的技術(shù)進(jìn)行簡(jiǎn)單的介紹。
簡(jiǎn)單地說來,ATL中所使用的基本技術(shù)包括以下幾個(gè)方面:
COM技術(shù) C++模板類技術(shù)(Template) C++多繼承技術(shù)(Multi-Inheritance)
1、COM技術(shù)是理解ATL的基礎(chǔ)
使用ATL進(jìn)行開發(fā)要對(duì)COM技術(shù)的基本概念有最低限度的了解。由于COM是一項(xiàng)非常復(fù)雜龐大的技術(shù)體系,限于本文的篇幅,這里不
再贅述。對(duì)于本文中提到的COM基本概念也不做過多的解釋,請(qǐng)讀者參閱有關(guān)的參考書籍。 eg: <<COM技術(shù)內(nèi)幕.pdf>>
2、作為ATL最核心的實(shí)現(xiàn)技術(shù)的模板是對(duì)標(biāo)準(zhǔn)C++語(yǔ)言的擴(kuò)展
但是在大多數(shù)的C++編程環(huán)境中,人們很少使用它,這是因?yàn)槟0宓墓δ茈m然很強(qiáng),但是它內(nèi)部機(jī)制比較復(fù)雜,需要比較多的C++知識(shí)
和經(jīng)驗(yàn)才能靈活地使用它。在MFC中的CObjectArray等功能類就是由模板來定義的。完全通過模板來定義程序的整體類結(jié)構(gòu),ATL是迄
今為止做得最為成功的。
所謂模板類簡(jiǎn)單地說是對(duì)類的抽象。我們知道C++語(yǔ)言用類定義了構(gòu)造對(duì)象(這里指C++對(duì)象而不是COM對(duì)象)的方式,對(duì)象是類的實(shí)
例,而模板類定義的是類的構(gòu)造方式,使用模板類定義實(shí)例化的結(jié)果產(chǎn)生的是不同的類。因此可以說模板類是“類的類”。
在C++語(yǔ)言中模板類的定義格式如下:
注意:<和>是左右尖括號(hào),可能無法正常顯示。
template < class T> class MyTemp
?{
MyTemp( ){ };
?~MyTemp( ) { };
?int MyFunc( int a) ;
}
………….
?Int MyTemp::MyFunc( int a) { }
?
首先使用C++的關(guān)鍵字“template”來聲明一個(gè)模板類的定義。在關(guān)鍵字后面是用尖括號(hào)括起來的類型參數(shù)。正是根據(jù)這個(gè)類型參數(shù),
編譯器才能在編譯過程中將模板類的具體定義轉(zhuǎn)化為一個(gè)實(shí)際的類的定義,即生成一個(gè)新的類。接下來的定義方式與普通的類定義十分
相似,只是在類的函數(shù)定義中都要帶有類型參數(shù)的說明。
下面的程序段說明了模板類的用法:
typedef MyTemp myclassfromtemp;
?myclassfromtemp m;
int a = m.Myfunc(10);
通常在使用模板類時(shí)為了方便起見,使用一個(gè)關(guān)鍵字“typedef”為新定義出來的類取一個(gè)名字。
在上面的程序段中假設(shè)“MyClass”是一個(gè)由用戶定義的類,通過將這個(gè)類的名字作為類型參數(shù)傳遞給模板類,我們可以創(chuàng)建一個(gè)新的
類,這個(gè)類的行為將以模板類的定義為基礎(chǔ),例如它具有模板類定義的所有成員函數(shù),同時(shí)這個(gè)類又是對(duì)模板類行為的一種修改,這種
修改是通過用戶提供的類型參數(shù)來實(shí)現(xiàn)的。
賦予模板類以不同的類型參數(shù),則得到行為框架相似但具體行為不同的一組類的集合。有了新的類的定義以后,我們可以象使用普通類
一樣來創(chuàng)建一個(gè)類的實(shí)例,即一個(gè)新的對(duì)象,并且調(diào)用這個(gè)對(duì)象的成員函數(shù)。
模板類是對(duì)標(biāo)準(zhǔn)C++語(yǔ)言的最新擴(kuò)展,雖然它的功能很強(qiáng)大,但是要想使用好模板類需要相當(dāng)多的關(guān)于語(yǔ)言和編程的經(jīng)驗(yàn)和知識(shí),而且
錯(cuò)誤地使用模板類又會(huì)對(duì)程序的結(jié)構(gòu)和運(yùn)行效率帶來大的副作用,因此一般的編程環(huán)境和編程書籍對(duì)模板類的使用都采取謹(jǐn)慎的態(tài)度。
而ATL的核心就是由幾十個(gè)模板類構(gòu)成的,通過研究ATL的源代碼可以使我們對(duì)模板類的使用有比較深刻全面的認(rèn)識(shí)。
3、多繼承技術(shù)同模板一樣,是C++語(yǔ)言中極具爭(zhēng)議性的技術(shù)。
使用多繼承技術(shù)可以使程序的設(shè)計(jì)和實(shí)現(xiàn)更加靈活,但是,由于多繼承的復(fù)雜性和自身概念上的一些問題,使多繼承在各種面向?qū)ο蟮?
語(yǔ)言環(huán)境中得到的支持都非常有限。例如Small Talk根本就不允許多繼承,同樣MFC也不支持多繼承技術(shù)。
多繼承最大的問題是所謂的“鉆石結(jié)構(gòu)”。
例如下面的代碼:
[cpp] view plain copy
class A { ..... }; ??
class B : public A { .. . }; ?
class C : public A { ..... }; ??
class D : public C,B { ........ } ??
?
由于類D同時(shí)從類C和B繼承,因此在下面的語(yǔ)句中就會(huì)發(fā)生歧義:?
[cpp] view plain copy
D* pD = new D; ??
A*)pD->Func(...); ??
?
由于類D通過類C和類B 分別繼承了類A,這里的強(qiáng)制轉(zhuǎn)化就會(huì)發(fā)生歧義。
ATL使用了C++最新規(guī)范中加入的兩個(gè)運(yùn)算符號(hào) static_cast、dynamic_cast代替簡(jiǎn)單的強(qiáng)制轉(zhuǎn)化,從而消除多繼承帶來的歧義。使用這
兩個(gè)運(yùn)算符號(hào),我們可以在對(duì)象運(yùn)行過程中獲取對(duì)象的類型信息。上面的代碼可以采用下面的方式修改:
[cpp] view plain copy
D* pD = new D; ??
static_cast(static_cast(pD))->Func(...); ?
?
為什么模板類和多繼承技術(shù)會(huì)成為ATL主要的工具呢?原因在于,采用模板可以在編譯過程中快速的生成具有用戶定制功能的類,這對(duì)
于COM這樣一個(gè)復(fù)雜的技術(shù)體系在實(shí)現(xiàn)效率上得到了很大的提高。通過使用模板類,用戶可以把精力集中在自己開發(fā)的類的基本邏輯
上,在完成了自己的類的設(shè)計(jì)以后,通過繼承不同的類,生成不同的模板類,就可以快速地實(shí)現(xiàn)COM的功能,同時(shí)又避免了采用單繼
承結(jié)構(gòu)造成的大量功能冗余。
總之,正是由于在設(shè)計(jì)實(shí)現(xiàn)過程中采用了模板類和多繼承技術(shù),才使ATL成為一個(gè)小巧靈活的COM開發(fā)工具,能夠適應(yīng)開發(fā)人員對(duì)
COM應(yīng)用開發(fā)的各種需要。
三. ATL基本使用
這一部分將重點(diǎn)介紹ATL的基本使用過程。由于ATL已經(jīng)被集成在Microsoft Visulal Studio的Visual C++開發(fā)環(huán)境中,因此要使用ATL
必須先安裝Visual C++。在下面的討論中有關(guān)COM的基本知識(shí)請(qǐng)參閱有關(guān)的文檔,這里不再詳細(xì)說明。給出的圖是在Microsoft?
Windows 98平臺(tái)下Visual Studio 6.0的使用示意圖。
使用ATL開發(fā)一個(gè)COM應(yīng)用基本可以分為以下幾個(gè)步驟:
(1)創(chuàng)建一個(gè)新的ATL工程,并對(duì)工程的選項(xiàng)進(jìn)行適當(dāng)?shù)呐渲谩?
(2)向新創(chuàng)建的工程添加新的ATL類,并對(duì)該類進(jìn)行一些初始配置工作。
(3)根據(jù)COM應(yīng)用的基本要求向新的ATL類加入新的接口定義,并實(shí)現(xiàn)相應(yīng)的接口成員函數(shù)。
(4)編譯連接工程,注冊(cè)COM應(yīng)用。
下面將根據(jù)這些步驟依次介紹ATL的基本使用過程。
1、創(chuàng)建工程
首先啟動(dòng)Visual C++集成開發(fā)環(huán)境,選擇“File”菜單下的“New...”命令,在“New”對(duì)話框中選擇“Project”頁(yè)。
選擇“ATL COM AppWizard”項(xiàng),這是創(chuàng)建ATL工程的AppWizard向?qū)肟凇H缓笤凇癙roject name”編輯框中輸入工程的名字,單
擊“OK”按鈕,進(jìn)入AppWizard對(duì)話框。在AppWizard對(duì)話框中主要的設(shè)置選項(xiàng)有:
(1、1)COM服務(wù)程序的類型:
- 動(dòng)態(tài)連接庫(kù)(Dynamic Linking Library) 最終產(chǎn)生一個(gè)動(dòng)態(tài)連接庫(kù)(DLL)形式的COM服務(wù)程序;
- 應(yīng)用程序(Executable application)最終產(chǎn)生一個(gè)可執(zhí)行程序類型(EXE)的COM服務(wù)程序;
- NT服務(wù)(NT Service):產(chǎn)生一個(gè)以NT服務(wù)方式運(yùn)行的COM服務(wù)程序。
(1、2)允許嵌入Proxy/Stub代碼。由Microsoft提供的MIDL編譯IDL文件以后,將產(chǎn)生用于對(duì)象調(diào)度(Marshaling)的Proxy/Stub
的代碼。傳統(tǒng)地,這部分代碼與COM服務(wù)程序的代碼是分離的,但是由于新的COM標(biāo)準(zhǔn)支持多線程環(huán)境下的COM對(duì)象服務(wù),因此在
動(dòng)態(tài)連接庫(kù)的COM服務(wù)程序中也要有Proxy/Stub的支持。為了支持在網(wǎng)絡(luò)上的傳輸,ATL允許用戶選擇將Proxy/Stub的代碼包括在生
成的DLL代碼中。這個(gè)選項(xiàng)在EXE和NT服務(wù)類型的COM應(yīng)用條件下不可選。
(1、3)允許支持MFC。由于ATL對(duì)除COM以外的基本的Windows編程方面的支持極為有限,同時(shí)許多程序員對(duì)MFC又非常熟悉,因
此在ATL的工程設(shè)置中允許在ATL工程內(nèi)部支持使用MFC,即可以使用MFC定義的類。這在一方面來看是非常方便的,特別是對(duì)于習(xí)慣
于使用MFC的開發(fā)人員來說,能夠使用MFC提供的各種功能強(qiáng)大的類的支持,而不必直接使用Windows SDK。從另一個(gè)方面來看,在
ATL工程中使用MFC同時(shí)就喪失了ATL代碼輕量級(jí)的特點(diǎn)。
(4)支持MTS。MTS是Microsoft Transaction Server的縮寫,它是Microsoft在COM技術(shù)方面的一個(gè)新的分支,這里不作詳細(xì)說明
。
完成上面的設(shè)置以后,可以選擇FINISH完成工程的設(shè)置,ATL將創(chuàng)建相應(yīng)的工程。
2、加入ATL類
完成工程的創(chuàng)建和設(shè)置以后,下一步就是向工程中加入一個(gè)新的ATL類。
Visual Studio集成環(huán)境提供了向?qū)Чぞ摺癆TL Object Wizard”用于加入一個(gè)新的ATL類。操作過程并不復(fù)雜,只是一組對(duì)話框操作而
已。
首先通過集成環(huán)境的“Insert”菜單下的“New ATL Object…”命令進(jìn)入“ATL Object Wizard”對(duì)話框。
這個(gè)對(duì)話框即為創(chuàng)建ATL對(duì)象的向?qū)鹗冀缑妗?duì)話框的左邊部分說明了待創(chuàng)建對(duì)象的基本類型,這里主要有以下的幾種類型:
對(duì)象(Object)基本的COM對(duì)象類型;
控制(Control)ActiveX Control類型的ATL對(duì)象;
其他(Miscellaneous)輔助功能,如對(duì)話框的生成等;
數(shù)據(jù)訪問(Data Access)數(shù)據(jù)訪問,支持MTS等。
右邊部分說明了每種類型的詳細(xì)內(nèi)容,對(duì)于一般的COM服務(wù)程序,使用對(duì)象表中的簡(jiǎn)單對(duì)象(Simple Object)就可以了。
選定待創(chuàng)建對(duì)象的基本類型以后,單擊“Next>”按鈕進(jìn)入下一步,進(jìn)入對(duì)象屬性設(shè)置對(duì)話框,如圖4和圖5所示。 對(duì)象屬性設(shè)置分
為兩個(gè)過程:先是對(duì)象名字標(biāo)識(shí)的設(shè)定,然后是對(duì)對(duì)象的基本屬性進(jìn)行設(shè)置。首先是對(duì)象的名字標(biāo)識(shí)設(shè)置。 在對(duì)象標(biāo)識(shí)編輯框中輸
入待創(chuàng)建對(duì)象的名字,ATL對(duì)象向?qū)⑼降馗鶕?jù)用戶輸入的對(duì)象標(biāo)識(shí)設(shè)定該對(duì)象的C++標(biāo)識(shí)和COM標(biāo)識(shí)。對(duì)象的C++標(biāo)識(shí)包括對(duì)象
的類名,cpp文件名和頭文件名。COM標(biāo)識(shí)包括對(duì)象在類型庫(kù)中的CoClass段和實(shí)現(xiàn)的主接口的名字,同時(shí)還有在系統(tǒng)注冊(cè)表中的類型
名以及ProgID。 對(duì)象名字標(biāo)識(shí)設(shè)置完成以后,選擇對(duì)象屬性頁(yè)(Attribute)進(jìn)入對(duì)象的屬性設(shè)置頁(yè)面。 對(duì)象的屬性設(shè)置是ATL
對(duì)象創(chuàng)建過程中最復(fù)雜的部分,包括以下幾個(gè)主要部分: 對(duì)象的線程模型(Thread Model) 對(duì)象的線程模型是COM對(duì)象在多
線程環(huán)境下被訪問時(shí)對(duì)訪問方式的控制,缺省情況下在ATL中采用的是套間模型Apartment,由系統(tǒng)通過消息隊(duì)列方式提供并發(fā)控制。?
對(duì)象的接口模型(Interface) COM對(duì)象的接口可以是雙接口(Dual Interface)。雙接口不同于普通接口(Custom Interface) 之
處在于雙接口是從Automation基本接口IDispatch繼承的,而普通接口是從IUnknown接口直接繼承來的。缺省的接口模型是雙接口。?
對(duì)象的聚合模型(Aggregate) COM規(guī)范不允許對(duì)象的實(shí)現(xiàn)繼承,但是可以通過聚合方式重用其它的COM對(duì)象。ATL對(duì)象屬
性設(shè)置中的聚合模型可以指定待創(chuàng)建的COM對(duì)象是否支持聚合模型。缺省的選項(xiàng)是支持對(duì)象的聚合。 對(duì)象對(duì)錯(cuò)誤處理的支持
(Support ISupportErrorInfo) 選取這個(gè)選項(xiàng)可以在對(duì)象的運(yùn)行過程中支持錯(cuò)誤處理。缺省情況下這個(gè)選項(xiàng)不被選中。 對(duì)象對(duì)
連接點(diǎn)的支持(Support Connection Points) 連接點(diǎn)是COM對(duì)象的事件機(jī)制。選中這個(gè)選項(xiàng)可以使待創(chuàng)建的COM對(duì)象具有發(fā)出事
件的能力。缺省情況下該選項(xiàng)不被選中。 對(duì)象對(duì)自由線程調(diào)度的支持(Free Thread Marshaller, 簡(jiǎn)稱FTM) 對(duì)象的自由線程調(diào)
度是對(duì)象在處于自由線程模型狀態(tài)下,為了簡(jiǎn)化對(duì)象的訪問過程而采用的一種優(yōu)化策略。缺省情況下該選項(xiàng)不被選中。 對(duì)于上述的
任何一個(gè)選項(xiàng)的詳細(xì)描述都涉及到COM技術(shù)一些核心的內(nèi)容,并且都已超出本文的范圍,因此本文只對(duì)ATL給出的缺省選項(xiàng)加以說明,
對(duì)這些內(nèi)容感興趣的讀者可以參考Microsoft提供的文檔。 完成了上面的設(shè)置以后,就可以按“OK”按鈕完成對(duì)象的創(chuàng)建過程。下
一步就是向所生成的ATL類的接口中加入成員函數(shù)的定義,以及接口成員函數(shù)的實(shí)現(xiàn)過程。
3.、加入接口定義,實(shí)現(xiàn)接口函數(shù)
加入了ATL類定義之后,我們可以打開Visual C++集成環(huán)境下項(xiàng)目管理器(Workspace)中的Class View來檢查生成的類定義的情況。
我們可以看到一個(gè)新的類已經(jīng)生成,同時(shí),還生成了相應(yīng)的接口定義。ATL Object Wizard為我們生成了類定義的.h 和.cpp文件,此外
還有用于接口定義的IDL文件。有了這些文件以后,我們就可以為接口加入成員函數(shù),完成類的定義。 首先在Class View中選中相
應(yīng)的接口,顯示為接口IATLTest,單擊鼠標(biāo)右鍵打開菜單,如圖7。此彈出式菜單定義了為接口加入屬性和方法的操作。選取其中
的“Add Method...”項(xiàng),可以為接口加入方法成員;選取“Add Property...”則可以為接口加入新的屬性成員。 加入屬性和方法
的對(duì)話框可以參看圖8和圖9。如果我們要在接口中加入一個(gè)方法,則選取“Add Method...”菜單命令。假設(shè)方法名為ABC,方法的返
回類型為COM規(guī)定的HRESULT類型。我們也可以定義非HRESULT返回類型的函數(shù),但是這需要手工修改接口定義的IDL文件。我們定
義ABC方法的一個(gè)參數(shù)為a,類型為整數(shù)型。完成了方法的定義以后,單擊“OK”按鈕則把此方法加入到接口中。 屬性的加入過程
是類似的。屬性加入對(duì)話框要求指定屬性的類型、名字以及屬性的訪問方式。在屬性和方法的編輯對(duì)話框中都有一個(gè)“Attributes”按
鈕,在給出了一個(gè)屬性或方法的基本定義之后,單擊此按鈕,可以對(duì)屬性和方法的一些高級(jí)特性進(jìn)行設(shè)置。 方法成員加入以后,我
們可以通過Class View來檢查ATL為我們所做的工作。首先我們看到ATL在接口的定義中加入了該方法的定義;同時(shí)在對(duì)應(yīng)的ATL類定義
中,也加入了一個(gè)相應(yīng)的方法的定義;在類對(duì)應(yīng)的.cpp文件中,加入了此方法的實(shí)現(xiàn)框架。此后,我們只要在這個(gè)函數(shù)框架中加入該方
法的代碼邏輯,一個(gè)接口函數(shù)的定義和實(shí)現(xiàn)就基本完成了。依照這種方式,我們可以完成整個(gè)COM對(duì)象的定義和實(shí)現(xiàn)。 完成以上
的步驟之后,我們就可以編譯連接應(yīng)用了。
4、 編譯連接應(yīng)用、注冊(cè)COM服務(wù)程序
對(duì)ATL工程的編譯連接過程包括下面的幾個(gè)步驟: 使用MIDL編譯工程的IDL文件,形成接口定義的頭文件和用于調(diào)度(Marshalling)
的代碼; 編譯工程的.cpp文件形成目標(biāo)文件; 連接目標(biāo)文件,形成應(yīng)用模塊; 注冊(cè)COM服務(wù)程序。 關(guān)于工程編譯
連接的其它部分同Visual C++中MFC工程的編譯連接過程相似,這里只重點(diǎn)介紹一下COM服務(wù)程序的注冊(cè)過程。 在ATL中,COM
服務(wù)程序的注冊(cè)是在工程編譯連接的最后階段,由ATL輔助完成的。在手工的COM編程中,服務(wù)程序的注冊(cè)是比較麻煩的工作。在ATL
中,系統(tǒng)通過讀取在建立工程過程中形成的注冊(cè)腳本文件來完成注冊(cè)工作。注冊(cè)腳本(Register Script 簡(jiǎn)稱RGS)是ATL提供的文本方式的
注冊(cè)輔助文件。下面是注冊(cè)腳本文件的一個(gè)實(shí)例。 HKCR - 表示注冊(cè)表中COM對(duì)象的注冊(cè)項(xiàng),是HKEY_CLASS_ROOT的縮寫 {?
AuthTest.ActiveXObject.1 = s 'ActiveXObject Class' { CLSID = s '' } - 對(duì)象的ProgID AuthTest.ActiveXObject = s 'ActiveXObject?
Class' { CLSID = s '' } -對(duì)象的與版本無關(guān)的ProgID NoRemove CLSID -對(duì)象CLSID注冊(cè)項(xiàng) { ForceRemove = s 'ActiveXObject?
Class' { ProgID = s 'AuthTest.ActiveXObject.1' VersionIndependentProgID = s 'AuthTest.ActiveXObject' InprocServer32 = s?
'%MODULE% -服務(wù)器類型,表示DLL服務(wù)器 { val ThreadingModel = s 'both' -線程模型,這里是BOTH型 } } } } RGS文件包
含注冊(cè)COM服務(wù)程序的各項(xiàng)內(nèi)容,通常我們不必修改此RGS文件,必要時(shí)我們也可以手工修改RGS文件來定制模塊的注冊(cè)過程。
四. 應(yīng)用ATL的一個(gè)例子
上面介紹了使用ATL創(chuàng)建一個(gè)COM服務(wù)程序的基本過程。在介紹過程中,我們實(shí)際上已經(jīng)生成了一個(gè)COM服務(wù)程序的基本框架,只是
沒有填寫實(shí)際的內(nèi)容。在下面部分,我們實(shí)際開發(fā)一個(gè)十分簡(jiǎn)單的COM服務(wù)程序,并且為它編寫一段客戶代碼進(jìn)行測(cè)試,使大家對(duì)使
用ATL開發(fā)COM服務(wù)程序的過程有一個(gè)全面整體的了解。
我們要開發(fā)的服務(wù)程序的功能很簡(jiǎn)單,它只實(shí)現(xiàn)一個(gè)接口,這個(gè)接口名字是ISimpleInterface,接口只有一個(gè)成員函數(shù),叫做Welcome
。這個(gè)函數(shù)的功能只是輸出一個(gè)“Hello World!”的字符串。
按照上一部分介紹的創(chuàng)建COM服務(wù)程序的步驟,我們進(jìn)行如下的操作:
1 打開Visual C++集成開發(fā)環(huán)境;
2 創(chuàng)建一個(gè)稱為SimpleTest的ATL工程;
3 在這個(gè)工程中插入新的對(duì)象,對(duì)象的名字是SimpleInterface;
4 設(shè)置接口ISimpleInterface的有關(guān)屬性,使它成為一個(gè)雙接口;
5 在對(duì)象的接口ISimpleInterface中加入方法Welcome;
6 打開ATL加入的Welcome方法的框架,可以看到如下的代碼段: STDMETHODIMP CActiveXObject::get_TestProp(long *pVal) {?
AFX_MANAGE_STATE(AfxGetStaticModuleState()) // TODO: Add your implementation code here return S_OK; }
7 將程序框架中的注釋部分替換為下面的代碼: ::MessageBox(NULL,_T(”Hello World!”),_T(”Welcome”), MB_OK); Welcome方
法被調(diào)用時(shí)將彈出一個(gè)消息框。
8 編譯連接工程。 上面的步驟完成以后,我們就有了一個(gè)簡(jiǎn)單的COM服務(wù)程序,而且已經(jīng)被注冊(cè)到當(dāng)前系統(tǒng)中。 下面我們要完
成一個(gè)簡(jiǎn)單的COM客戶程序。一個(gè)COM客戶程序簡(jiǎn)單地說是使用COM組件對(duì)象的程序。
客戶程序調(diào)用COM對(duì)象的基本流程是:
創(chuàng)建COM對(duì)象的實(shí)例。這可以通過調(diào)用Windows系統(tǒng)的API函數(shù)CoCreateInstance來完成。 通過接口調(diào)用函數(shù)。 調(diào)用
IUnknown::Release釋放COM對(duì)象實(shí)例 我們的客戶程序是使用MFC編寫的一個(gè)基于對(duì)話框的簡(jiǎn)單應(yīng)用程序。具體的過程如下:
1 打開Visual C++集成開發(fā)環(huán)境; 創(chuàng)建一個(gè)稱為SimpleClient的基于對(duì)話框的MFC工程; 在對(duì)話框中加入一個(gè)按鈕,名字為
TEST; 在SimpleClient.cpp文件中加入如下的代碼:
(1) 在cpp文件 #include “simpleclientdlg.h”之后加入下面的代碼: #include “d:/simpletest/simpletest_i.h” // 根據(jù)需要修
改頭文件的路徑 加入的頭文件是在編譯COM服務(wù)程序過程中自動(dòng)生成的,其中包含接口本身的定義、接口IID的定義和COM對(duì)象的
CLSID的定義。包含該頭文件可以使客戶程序能夠使用COM服務(wù)程序。
(2) 在按鈕TEST的消息控制函數(shù)中加入如下的代碼: HRESULT hr; ISimpleInterface* pIntf = NULL; hr = CoCreateInstance
(CLSID_SimpleInterface, NULL, CLSCTX_SERVER , IID_ISimpleInterface, (void **)& pIntf); if(SUCCEEDED(hr)) { pIntf-
>Welcome(); pIntf->Release(); } 上面的代碼首先通過系統(tǒng)API CoCreateInstance創(chuàng)建COM對(duì)象,得到接口的指針,然后調(diào)用接
口成員函數(shù)Welcome,最后通過IUnknown::Release()函數(shù)釋放COM對(duì)象實(shí)例。 編譯連接客戶程序 最后,我們可以測(cè)試客戶
程序是否正常運(yùn)行。啟動(dòng)客戶程序,當(dāng)單擊“TEST”按鈕時(shí)我們可以看到彈出一個(gè)消息框,這正是我們的COM服務(wù)程序提供的功能。
?========
ATL編程總結(jié)
http://blog.csdn.net/lee353086/article/details/7097440內(nèi)容概要
?[1] 在Visual Studio2008下使用Visual C++ ATL項(xiàng)目向?qū)?#xff0c;完成一個(gè)COM服務(wù)( DLL),可在HTML中調(diào)用。
?[2]用Visual Studio打包成安裝文件, 在客戶端自動(dòng)注冊(cè)。
?假設(shè)讀者有在Visual Studio 2008下的C++開發(fā)經(jīng)驗(yàn),主要是給自己看的,很多地方省略了。
正文
建立COM控件
第一步:選擇[Visual C++]->[ATL Project],輸入項(xiàng)目名稱后,點(diǎn)擊[OK]繼續(xù)
第二步:項(xiàng)目向?qū)е小癝erver type”選擇“Dynamic-link library(DLL)”,“Additional options”選擇“Allowmerging of?
proxy/stub code”
第三步:為你的ATL項(xiàng)目(容器)添加供外部使用的Class (ATL Simple Object)。選項(xiàng)頁(yè) “ C++”的“Short name”輸入欄中輸入你
的Class名稱,其它輸入框會(huì)自動(dòng)更新。
第四步:“Threading?
model”選“Apartment”;“Interface”選“Dual”;“Aggregation”選“No”;“Support”選“Connection points”和“I?
Object With Site(IE objects support)”。
第五步:在“Class View”中,右鍵單擊要添加方法的Interface的名稱,在彈出菜單中選擇“Add Method”,添加方法。為參數(shù)列表
添加參數(shù)要注意,“retval”屬性的參數(shù)只能放在參數(shù)列表的最后一個(gè),并且只能有一個(gè),要返回字符串,參數(shù)類型可以選擇“BSTR*”
,要返回Long類型,參數(shù)類型可以選擇“LONG *”。完成后,在函數(shù)體內(nèi)添加代碼。
第六步:添加IE支持
在你新的類名的H文件的“ ? ? ? ? publicIObjectWithSiteImpl<你的類名>,”代碼段后面添加下面這個(gè)代碼段“
? ? ? ? ?publicIObjectSafetyImpl<你的類名,INTERFACESAFE_FOR_UNTRUSTED_CALLER|
INTERFACESAFE_FOR_UNTRUSTED_DATA>,”。
在“COM_INTERFACE_ENTRY(IObjectWithSite)”后面插入“COM_INTERFACE_ENTRY(IObjectSafety)”代碼段。
第七步(最后一步):右鍵單擊資源文件選擇“View Code”找到“CompanyName”等信息做修改。修改資源文件的語(yǔ)言為“中文
(簡(jiǎn)體)”,否則,用戶查看文件信息(你寫的中文注釋)會(huì)是亂碼。
第八步:按F7編譯Solution,如何沒有錯(cuò)誤,IDE會(huì)自動(dòng)為你注冊(cè)COM服務(wù)。你也可以使用regsvr32命令手動(dòng)注冊(cè)或反注冊(cè)生成的DLL
文件。
測(cè)試COM控件
我們新建的這個(gè)COM服務(wù)用“ActiveXControl test Container”這個(gè)容器做測(cè)試,會(huì)找不到這個(gè)COM,我們的ATL項(xiàng)目生成的DLL可
能不是嚴(yán)格意義上的Active X控件的緣故。
用VB程序做測(cè)試
通過在VB項(xiàng)目里Add reference添加COM組件
示例代碼如下
[vb] view plain copy
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e AsSystem.EventArgs) Handles Button1.Click ??
??
? ? Dim objTestATL As Simple_ATLLib.First_ATL ?
? ? Dim lngReturnValue As Long ?
? ? objTestATL = New Simple_ATLLib.First_ATL ?
? ? lngReturnValue = objTestATL.AddNumbers(5, 7) ?
? ? MsgBox("The value of 5 + 7 is: " & lngReturnValue) ?
??
End Sub ?
其中“Simple_ATLLib”是項(xiàng)目名稱加lib,“First_ATL”是你剛才新建的Classs名稱,“AddNumbers”是你為這個(gè)Class新建的方法
名。
用HTML頁(yè)面做測(cè)試
下面是示例代碼,其中classid可以從First_ATL.rgs中查找,其中“First_ATL”是你要在HTML中實(shí)例化的Class的名稱。
[html] view plain copy
<object ?classid="clsid:F0FF2E0D-A56B-40A4-A4D1-F84032606F20" ?id="Dean" name = "Dean" ></object> ?
??
<form id="form1" ?name="form1" method="post" action=""> ?
??
? <a href="#" οnclick="return CallUSB();">js調(diào)用ActiveX測(cè)試</a> ??
??
? <input id="Write" name="Write"type="button" value="vb調(diào)用ActiveX測(cè)試"/> ?
??
</form> ?
??
<SCRIPT LANGUAGE="JavaScript"> ?
??
//JavaScript調(diào)用Demo ?
??
function CallUSB() ? ?
{ ?
??
? ? ? ? ?try{ ? ??
? ? ? ? ? ? ? ? ? ?varUSBContent = Dean.AddNumbers(5, 7); ? ?
? ? ? ? ? ? ? ? ? ?alert(USBContent); ? ?
? ? ? ? ?}catch (e) { ? ?
? ? ? ? ? ? ? ? ? ?alert("錯(cuò)誤號(hào): " +e ); ? ?
? ? ? ? ?} ? ? ??
?return false; ? ?
} ??
</SCRIPT> ?
?
配置安裝包
第一步:在當(dāng)前Solution中添加New Project,選擇project類型為“[Other project Types]->[Setup and Deployment]->[Setup?
Wizard]”。在向?qū)У倪x項(xiàng)卡中選擇“Primaryoutput from 你的ATL項(xiàng)目名稱”,其它可以取默認(rèn)值。
第二步:修改公司名稱、語(yǔ)言類型、安裝位置等信息。
第三步:“Detected Dependencies”中有些DLL你不需要打包進(jìn)來,可以排除它們。
第四步(最后一步):點(diǎn)擊你的“Primary output”的那一項(xiàng),在屬性窗口中找到“register”屬性,它的默認(rèn)值
為“vsdrpDoNotRegister”,改為“vsdrpCOMSelfReg”。這樣你的程序在用戶機(jī)器中安裝好后,你的DLL也在用戶機(jī)器中注冊(cè)好了
。
?其它
[1]在添加的ATL Simple Object類型的Class,public域里,可以修改原FinalRelease的聲明為STDMETHOD(FinalRelease)();
然后在CPP文件里實(shí)現(xiàn)這個(gè)聲明,可以實(shí)現(xiàn)當(dāng)IE窗口關(guān)閉時(shí),做一些對(duì)象清理工作。
遺留問題
[1]本文不包含數(shù)字簽名的相關(guān)信息
[2]ActiveX在IE中正常,但是不能在Firefox中正常運(yùn)行
========
ATL編程初級(jí)教程
http://www.cnblogs.com/weiqubo/archive/2011/01/29/1947540.html介紹
本教程的目的是告訴你如何使用ATL創(chuàng)建一個(gè)COM服務(wù)器,并使用Visual C++和Visual Basic程序來分別調(diào)用這個(gè)服務(wù)器。我并不
想深入探討COM的細(xì)節(jié),也不想讓你深陷于IDL之中。這一教程只是為VC++的新手程序員設(shè)計(jì)的,告訴他們利用ATL來創(chuàng)建一個(gè)COM
對(duì)象有多么簡(jiǎn)單,并讓他們能對(duì)ATL產(chǎn)生更多的興趣。
第1步:啟動(dòng)ATL COM Wizard
你所需要做的第一件事情就是啟動(dòng)Visual C++并創(chuàng)建一個(gè)新的工程,選擇“ATL COM Wizard”,工程名為“Simple_ATL”。設(shè)
置好工程的路徑之后,單擊OK按鈕。你會(huì)看到,屏幕上給了你若干選項(xiàng)。第一個(gè)選項(xiàng)為“Server Type”。我們將要?jiǎng)?chuàng)建一個(gè)服務(wù)器
DLL,所以請(qǐng)確認(rèn)服務(wù)器的類型選為“Dynamic Link Library”。我們并不需要關(guān)心下面的其它三個(gè)復(fù)選框,所以我們可以將它們忽略
掉。按下Finish按鈕,這樣向?qū)Ь蜁?huì)為你產(chǎn)生適當(dāng)?shù)奈募恕V?#xff0c;一個(gè)“New Project Information”窗口就會(huì)出現(xiàn),你可以從上面
得知向?qū)Ф紩?huì)創(chuàng)建什么文件,按下“OK”接受這一切。
第2步:創(chuàng)建一個(gè)新的ATL對(duì)象
請(qǐng)確認(rèn)你能在VC++的IDE中看到Workspace View,如果不能的話則請(qǐng)單擊“View”菜單,然后選擇“Workspace”。在這個(gè)視
圖中你會(huì)看到三個(gè)選項(xiàng)卡,請(qǐng)單擊“ClassView”欄,你應(yīng)該會(huì)看到“Simple_ATL Classes”。請(qǐng)?jiān)诖擞覔羰髽?biāo)鍵,并在彈出菜單中選
擇“New ATL Object”,你將會(huì)看到下面這樣的窗口:
默認(rèn)的選擇項(xiàng)“Simple Object”就是我們所要的了,請(qǐng)單擊next按鈕,你會(huì)來到“ATL Object Wizard Properties”窗口中。在
“Short Name”文本框中輸入“First_ATL”。請(qǐng)注意,這時(shí)候向?qū)Ь蜁?huì)自動(dòng)地填寫其它的文本框。然后,單擊頂部的“Attributes”
標(biāo)簽,在這里你需要做一些選擇。第一項(xiàng)線程模型(Threading Model)的選擇,我們選擇默認(rèn)的單元(Apartment)模型。對(duì)于接口
(Interface),我們選擇雙重(Dual)。最后,因?yàn)槲覀兊某绦蚺c聚合(Aggregation)無關(guān),所以我們選擇“No”的單選按鈕。你
不必關(guān)心底部的三個(gè)復(fù)選框,直接單擊OK就可以了,這時(shí)候向?qū)Ь蜁?huì)為我們創(chuàng)建一個(gè)新的ATL簡(jiǎn)單對(duì)象。
第3步:添加一個(gè)方法
如果你現(xiàn)在在工作區(qū)中單擊了“ClassView”標(biāo)簽,那么你會(huì)注意到向?qū)г谄渲刑砑恿艘淮畺|西。我們想添加的第一個(gè)東西是一個(gè)
方法,可以在“IFirst_ATL”上右擊鼠標(biāo)鍵,并選擇“Add Method”。
一旦你單擊了“Add Method”之后,你就會(huì)看到“Add Method to Interface”窗口。在返回值類型(Return Type)處你會(huì)看
到,這個(gè)方法會(huì)默認(rèn)返回HRESULT,在大多數(shù)情況下你不需要改變它。下一個(gè)文本框允許我們輸入方法的名稱,我們可以輸
入“AddNumbers”。最后一個(gè)文本框是讓我們輸入?yún)?shù)的,由于我們想做兩個(gè)數(shù)的相加并獲得一個(gè)返回的結(jié)果,所以我們需要三個(gè)參
數(shù),并且最后一個(gè)參數(shù)是一個(gè)指針。現(xiàn)在,我們不必看那關(guān)于IDL的300頁(yè)教程了,可以直接在參數(shù)文本框中輸入:
[in] long Num1, [in] long Num2, [out] long *ReturnVal
簡(jiǎn)單地說來,我們聲明了兩個(gè)long類型的參數(shù),這兩個(gè)值是傳入的([in]),還有一個(gè)最后傳出的返回值結(jié)果([out])。(你第一
次看到這樣的東西可能會(huì)有些奇怪,但是如果你讀了一兩本關(guān)于COM的書的話,就會(huì)覺得親切多了。)現(xiàn)在就可以單擊OK按鈕了。然
后,單擊“ClassView”標(biāo)簽,并展開所有的“+”標(biāo)志,使得樹型視圖完全展開。你會(huì)在接口(IFirst_ATL)的頂部看到我們
的“AddNumbers”方法以及我們給予它的參數(shù)。在這個(gè)方法上雙擊鼠標(biāo)鍵,并插入以下的代碼:
STDMETHODIMP CFirst_ATL::AddNumbers(long Num1,?
? ? ? ? ? ? ? ? ?long Num2, long *ReturnVal)
{
? ? ?// TODO: Add your implementation code here
? ? ?*ReturnVal = Num1 + Num2;
? ? ?return S_OK;
}
第4步:編譯DLL
無論你相信與否,你已經(jīng)擁有一個(gè)用ATL編寫的COM服務(wù)器了!當(dāng)然,我們還需要編譯它。請(qǐng)按下F7鍵,這樣VC++就可以編譯了
。編譯器工作片刻后就會(huì)在注冊(cè)表中注冊(cè)你的新DLL了,這樣一來其它的程序就可以使用它了。讓我們來測(cè)試一下。
第5步:在Visual Basic中測(cè)試COM服務(wù)器
那么,先讓我們用VB來測(cè)試這個(gè)COM服務(wù)器吧。(如果你沒有VB的話,你可以跳過這一節(jié),直接在VC++中測(cè)試。)啟動(dòng)VB,并
選擇“標(biāo)準(zhǔn)EXE(Standard EXE)”建立工程,并在對(duì)話框上放置一個(gè)命令按鈕。現(xiàn)在,我們需要添加COM服務(wù)器的引用,請(qǐng)單擊“
工程(Project)”菜單并選擇“引用(References)”,找到“Simple ATL 1.0 Type Library”并選擇它。
單擊確定(OK)按鈕之后,你可以雙擊先前放置的命令按鈕,VB會(huì)切換到這個(gè)按鈕的代碼窗口。添加以下的代碼:
Private Sub Command1_Click()
? ? ?Dim objTestATL As SIMPLE_ATLLib.First_ATL
? ? ?Set objTestATL = New First_ATL
? ? ?Dim lngReturnValue As Long
? ? ?objTestATL.AddNumbers 5, 7, lngReturnValue
? ? ?MsgBox "The value of 5 + 7 is: " & lngReturnValue
? ? ?Set objTestATL = Nothing
End Sub
如果你是個(gè)VB的程序員,那么這些代碼對(duì)于你是很直觀的:我們聲明了一個(gè)對(duì)象,并從COM服務(wù)器調(diào)用“AddNumbers”的方法
,然后顯示結(jié)果。現(xiàn)在按下F5來運(yùn)行這個(gè)VB工程,單擊命令按鈕,你就會(huì)看到期望的結(jié)果了:
并不是很難吧?那么我們?cè)賮硪淮?#xff0c;這一次用VC++。
第6步:在Visual C++中測(cè)試COM服務(wù)器
如果你的Simple_ATL工程仍然開著,那么就關(guān)了它并創(chuàng)建一個(gè)新工程。選擇“Win32 Console Application”,起名為“Test_ATL
”,在下一個(gè)窗口中單擊OK按鈕接受所有默認(rèn)值,最后單擊Finish按鈕。現(xiàn)在,你應(yīng)該有了一個(gè)空工程。那么,按下Ctrl+N為工程加入
一個(gè)新文件,選擇“C++ Source File”并命名為“Test_ATL.cpp”,單擊OK接受。你現(xiàn)在應(yīng)該有了一個(gè)打開的空白文件,我們需要在
其中添加一些代碼來測(cè)試COM服務(wù)器。代碼如下:
// 你需要指明Simple_ATL工程的路徑來引用這個(gè)頭文件
#include "..\Simple_ATL\Simple_ATL.h"
#include <iostream.h>
// 把以下的內(nèi)容從Simple_ATL工程目錄的Simple_ATL_i.c文件中復(fù)制過來
// 注意:你也可以直接包含Simple_ATL_i.c文件,我在此只想清楚地表明這些const常量來自何處以及它們的樣子
const IID IID_IFirst_ATL =
? ? ?{0xC8F6E230,0x2672,0x11D3,
? ? ?{0xA8,0xA8,0x00,0x10,0x5A,0xA9,0x43,0xDF}};
const CLSID CLSID_First_ATL =
? ? ?{0x970599E0,0x2673,0x11D3,
? ? ?{0xA8,0xA8,0x00,0x10,0x5A,0xA9,0x43,0xDF}};
void main(void)
{
? ? ?// 聲明一個(gè)HRESULT變量以及一個(gè)Simple_ATL接口的指針
? ? ?HRESULT ? ? ? ? ?hr;
? ? ?IFirst_ATL ? ? ? *IFirstATL = NULL;
? ? ?// 現(xiàn)在初始化COM
? ? ?hr = CoInitialize(0);
? ? ?// 使用SUCCEEDED宏來看看我們是否能夠獲得接口的指針
? ? ?if(SUCCEEDED(hr))
? ? ?{
? ? ? ? ?hr = CoCreateInstance( CLSID_First_ATL, NULL,?
? ? ? ? ? ? ?CLSCTX_INPROC_SERVER,
? ? ? ? ? ? ?IID_IFirst_ATL, (void**) &IFirstATL);
? ? ? ? ?// 如果成功了,那么調(diào)用AddNumbers方法
? ? ? ? ?// 否則給用戶顯示一條適當(dāng)?shù)男畔?
? ? ? ? ?if(SUCCEEDED(hr))
? ? ? ? ?{
? ? ? ? ? ? ?long ReturnValue;
? ? ? ? ? ? ?IFirstATL->AddNumbers(5, 7, &ReturnValue);
? ? ? ? ? ? ?cout << "The answer for 5 + 7 is: "?
? ? ? ? ? ? ? ? ?<< ReturnValue << endl;
? ? ? ? ? ? ?IFirstATL->Release();?
? ? ? ? ?}
? ? ? ? ?else
? ? ? ? ?{
? ? ? ? ? ? ?cout << "CoCreateInstance Failed." << endl;
? ? ? ? ?}
? ? ?}
? ? ?// 卸載COM
? ? ?CoUninitialize();
}
第7步:編譯并運(yùn)行程序
現(xiàn)在你可以按下F5鍵來編譯程序,然后按下Ctrl+F5來運(yùn)行之。你應(yīng)該可以看到一個(gè)DOS窗口,給出了你所期望的結(jié)果。
分類: ATL
========
總結(jié)
以上是生活随笔為你收集整理的VC++ ATL 学习总结的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Spring.net 类库目录
- 下一篇: VC++ 字符串操作学习总结