亚洲一日国产日韩欧美_ COM組件設計與應用（八）

COM組件設計與應用（八）
實(shí)現多接口

作者：楊老師

一、前言
    從第五回開(kāi)始到第七回，咱們用 ATL 寫(xiě)了一個(gè)簡(jiǎn)單的 COM 組件，之所以說(shuō)簡(jiǎn)單，是因為在組件中，只實(shí)現了一個(gè)自定義(custom)的接口 IFun。當然如果想偷懶的話(huà)，我們可以把 200 個(gè)函數都加到這一個(gè)接口中，果真如此的話(huà)，恐怕就沒(méi)有人喜歡使用我們這個(gè)組件了。一個(gè)組件既然可以提供多個(gè)接口，那么我們在設計的時(shí)候，就應該按照函數的功能進(jìn)行分類(lèi)，把不同功能分類(lèi)的函數用多個(gè)接口表現出來(lái)。這樣可以有如下的一些好處：
    1、一個(gè)接口中的函數個(gè)數有限、功能集中，使用者容易學(xué)習、記憶和調用。一個(gè)接口到底提供多少個(gè)函數合適那？答案是：如果你是黑猩猩，那么一個(gè)接口最多3個(gè)函數，如果你是人，那么一個(gè)接口最好不要超過(guò)7個(gè)函數。(注1)
    2、容易維護。至少你肉眼搜索的時(shí)候也方便一些呀。
    3、容易升級。當我們給組件增加函數的時(shí)候，不要修改已經(jīng)發(fā)表的接口，而是提供一個(gè)新的接口來(lái)完成功能擴展。(注2)
    本回書(shū)著(zhù)落在------如何實(shí)現一個(gè)組件，多個(gè)接口。

二、接口結構

圖一、組件A有2個(gè)自定義接口，組件B是A的升級

    某日，我們設計了組件A，它有2個(gè)自定義(custom)接口。IMathe 有函數Add()完成整數加法，IStr 有函數Cat()完成字符串連接。忽一日，我們升級組件A到B，欲增加一個(gè)函數 Mul() 完成整數的乘法。注意，由于我們已經(jīng)發(fā)表了組件A，因此我們不能把這個(gè)函數安排到老接口 IMathe 中了。解決方法是再定義一個(gè)新接口 IMathe2，在新接口中增加 Mul() 函數并依舊保留 Add() 函數。這樣，老用戶(hù)不知道新接口 IMathe2 的存在，他仍然使用舊接口 IMathe；而新用戶(hù)則可以?huà)仐?IMathe，直接使用 IMathe2 的新接口功能?？?，多平順的升級方式呀！

三、實(shí)現
    3-1、首先用 ATL 實(shí)現一個(gè)自定義(custom)接口 IMathe 的COM組件，在接口中完成 Add()整數加法函數。注意?。?！一定是自定義(custom)的接口（dual 雙接口以后再介紹）。如果你不了解這個(gè)操作，請重新閱讀“第五回”或“第六回”。
    3-2、查看 IDL 文件。完成上一個(gè)步驟后，打開(kāi)IDL文件，內容如下：(名稱(chēng)及 UUID 會(huì )和你程序中的IDL有所不同)

1 import "oaidl.idl";2 import "ocidl.idl";3	[4		object,5		uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),6		helpstring("IMathe Interface"),7		pointer_default(unique)8	]9	interface IMathe : IUnknown10	{11		[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);12	};13 [14	uuid(CD7672F7-C0B4-4090-A2F8-234C0062F42C),15	version(1.0),16	helpstring("Simple3 1.0 Type Library")17 ]18 library SIMPLE3Lib19 {20	importlib("stdole32.tlb");21	importlib("stdole2.tlb");22	[23		uuid(C6F241E2-43F6-4449-A024-B7340553221E),24		helpstring("Mathe Class")25	]26	coclass Mathe27	{28		[default] interface IMathe;29	};30 };

1-2	引入 IUnknown 和ATL已經(jīng)定義的其它接口描述文件。import 類(lèi)似與 C 語(yǔ)言中的 #include
3-12	一個(gè)接口的完整描述
4	object 表示本塊描述的是一個(gè)接口。IDL文件是借用了PRC遠程數據交換格式的說(shuō)明方法
5	uuid(......) 接口的 IID，這個(gè)值是 ATL 自動(dòng)生成的，可以手工修改或用 guidgen.exe 產(chǎn)生(注3)
6	在某些軟件或工具中，能看到這個(gè)提示
7	定義接口函數中參數所使用指針的默認屬性(注4)
9	接口叫 IMathe 派生自 IUnknown，于是 IMathe 接口的頭三個(gè)函數一定就是QueryInterface,AddRef和Release
10-12	接口函數列表
13-30	類(lèi)型庫的完整描述(類(lèi)型庫的概念以后再說(shuō))，下面所說(shuō)明的行，是需要先了解的
18	#import 時(shí)候的默認命名空間
23	組件的 CLSID，CoCreateInstance()的第一個(gè)參數就是它
27-29	接口列表
28	[default]表示誰(shuí)提供了IUnknown接口

3-3、手工修改IDL文件，黑體字部分是手工輸入的。完成后保存。

import "oaidl.idl";import "ocidl.idl";[object,uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),helpstring("IMathe Interface"),pointer_default(unique)]interface IMathe : IUnknown{[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);};	[	// 所謂手工輸入，其實(shí)也是有技巧的：把上面的接口描述（IMathe）復制、粘貼下來(lái)，然后再改更方便哈		object,uuid(072EA6CB-7D08-4E7E-B2B7-B2FB0B875595), // 手工或用工具產(chǎn)生的 IIDhelpstring("IStr Interface"),pointer_default(unique)]interface IStr : IUnknown{// 目前還沒(méi)有任何接口函數	};[uuid(CD7672F7-C0B4-4090-A2F8-234C0062F42C),version(1.0),helpstring("Simple3 1.0 Type Library")]library SIMPLE3Lib{importlib("stdole32.tlb");importlib("stdole2.tlb");[uuid(C6F241E2-43F6-4449-A024-B7340553221E),helpstring("Mathe Class")]coclass Mathe{[default] interface IMathe;		interface IStr;	// 別忘了呦，這里還有一個(gè)那};};

3-4、打開(kāi)頭文件(Mathe.h)，手工增加類(lèi)的派生關(guān)系和接口入口表，然后保存。

class ATL_NO_VTABLE CMathe :public CComObjectRootEx <CComSingleThreadModel>,public CComCoClass <CMathe, &CLSID_Mathe>,public IMathe,	// 別忘了，這里加一個(gè)逗號public IStr	// 增加一個(gè)基類(lèi){public:CMathe(){}DECLARE_REGISTRY_RESOURCEID(IDR_MATHE)DECLARE_PROTECT_FINAL_CONSTRUCT()BEGIN_COM_MAP(CMathe)	// 接口入口表。這里填寫(xiě)的接口，才能被QueryInterface()找到COM_INTERFACE_ENTRY(IMathe)COM_INTERFACE_ENTRY(IStr)END_COM_MAP()

    3-5、好了，一切就緒。接下來(lái)，就可以在 IStr 接口中增加函數了。示例程序中增加一個(gè)字符串連接功能的函數：
HRESULT Cat([in] BSTR s1, [in] BSTR s2, [out,retval] BSTR *psVal); 如果你不知道如何做，請重新閱讀前三回的內容。

四、接口升級
    我們這個(gè)組件已經(jīng)發(fā)行了，但忽然一天我們需要在 IMathe 接口上再增加一個(gè)函數......不行！絕對不能在 IMathe 上直接修改！怎么辦？解決方法是------再增加一個(gè)接口，我們就叫 IMathe2 吧，如果以后還要增加函數，那么我們再增加一個(gè)接口叫 IMathe3......子子孫孫，無(wú)窮盡也。
    4-1、修改 IDL 文件，其實(shí)如果你理解了上面一小節的內容，再增加一個(gè)接口是很簡(jiǎn)單的事情了。

import "oaidl.idl";import "ocidl.idl";[object,uuid(072EA6CA-7D08-4E7E-B2B7-B2FB0B875595),helpstring("IMathe Interface"),pointer_default(unique)]interface IMathe : IUnknown{[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);};[object,uuid(072EA6CB-7D08-4E7E-B2B7-B2FB0B875595),helpstring("IStr Interface"),pointer_default(unique)]interface IStr : IUnknown{[helpstring("method Cat")] HRESULT Cat([in] BSTR s1, [in] BSTR s2, [out,retval] BSTR *psVal);};	[object,uuid(072EA6CC-7D08-4E7E-B2B7-B2FB0B875595),helpstring("IMathe2 Interface"),pointer_default(unique)]interface IMathe2 : IUnknown{	// 下面這個(gè)Add（）函數，只有IDL中的聲明，而不用增加任何程序代碼，因為這個(gè)函數早在 IMathe 中就已經(jīng)實(shí)現了		[helpstring("method Add")] HRESULT Add([in] long n1, [in] long n2, [out,retval] long *pnVal);};[uuid(CD7672F7-C0B4-4090-A2F8-234C0062F42C),version(1.0),helpstring("Simple3 1.0 Type Library")]library SIMPLE3Lib{importlib("stdole32.tlb");importlib("stdole2.tlb");[uuid(C6F241E2-43F6-4449-A024-B7340553221E),helpstring("Mathe Class")]coclass Mathe{[default] interface IMathe;interface IStr;interface IMathe2;	// 別忘了，這里還有一行呢！};};

4-2、打開(kāi)頭文件，增加派生關(guān)系和接口入口表

class ATL_NO_VTABLE CMathe :public CComObjectRootEx <CComSingleThreadModel>,public CComCoClass <CMathe, &CLSID_Mathe>,public IMathe,public IStr,	// 這里增加一個(gè)逗號public IMathe2{public:CMathe(){}DECLARE_REGISTRY_RESOURCEID(IDR_MATHE)DECLARE_PROTECT_FINAL_CONSTRUCT()BEGIN_COM_MAP(CMathe)COM_INTERFACE_ENTRY(IMathe)COM_INTERFACE_ENTRY(IStr)COM_INTERFACE_ENTRY(IMathe2)END_COM_MAP()

    4-3、示例程序中，增加了一個(gè)整數乘法函數：
HRESULT Mul([in] long n1, [in] long n2, [out,retval] long *pnVal); 如果你不知道如何做，那就別學(xué)了:-( 都講好幾遍了，怎么還不掌握呢？知道狗熊是怎么死的嗎？(注5)
    4-4、因為我們的組件升級了，于是也應該修改版本號了（這不是必須的，但最好修改一下）。打開(kāi)注冊表文件(.rgs) 把有關(guān)ProgID的版本 "Mathe.1" 修改為"Mathe.2"。另外如果你愿意，把IDL文件中的 version 和提示文字一并修改一下。這里就不再粘貼文件內容了，因為很簡(jiǎn)單，大家下載示例程序(注6)后，自己看吧。

五、小結
    為祖國的軟件事業(yè)而奮斗！
    下回書(shū)介紹“自動(dòng)化”--- IDispatch 接口，好玩的很！謝謝關(guān)注:-)

注1：黑猩猩的瞬時(shí)記憶量是3，人類(lèi)的瞬時(shí)記憶量是7?？茖W(xué)家做過(guò)實(shí)驗，當著(zhù)面，把一塊糖扣在3個(gè)碗的其中之一，黑猩猩能立刻準確找到，但如果超過(guò)3個(gè)碗，猩猩就暈了......如果給你看一串數字，然后立刻讓你說(shuō)出來(lái)，一般的人只會(huì )記得其中的7個(gè)。
注2：組件一經(jīng)發(fā)表，就不要修改已有接口。這樣軟件的升級才能做到“魯棒”性。
注3：guidgen.exe 工具，在《COM 組件設計與應用(二)》中已經(jīng)介紹。
注4：組件函數對內存指針的處理，以后有專(zhuān)門(mén)的章回討論。
注5：笨死的！
注6：示例程序有兩部分，分別是vc6.0版本和vc.net 2003 版本。

本站僅提供存儲服務(wù)，所有內容均由用戶(hù)發(fā)布，如發(fā)現有害或侵權內容，請點(diǎn)擊舉報。

欧美性猛交XXXX免费看蜜桃,成人网18免费韩国,亚洲国产成人精品区综合,欧美日韩一区二区三区高清不卡,亚洲综合一区二区精品久久