分享
 
 
 

COM 组件设计与应用5 - 用 ATL 写第一个组件

王朝other·作者佚名  2006-03-16
窄屏简体版  字體: |||超大  

下载源代码

一、前言

1、如果你在使用 vc5.0 及以前的版本,请你升级为 vc6.0 或 vc.net 2003;

2、如果你在使用 vc6.0 (ATL 3.0)请阅读本回内容;

3、如果你在使用 vc.net(ATL 7.0)请阅读下回内容;(当然读读本文内容也不错)

4、这第一个组件,除了所有 COM 组件必须的 IUnknown 接口外,我们再实现一个自己定义的接口 IFun,它有两个函数: Add()完成两个数值的加法,Cat()完成两个字符串的连接。

5、下面......好好听讲! 开始了:-)

二、建立 ATL 工程

步骤2.1:建立一个工作区(WorkSpace)。

步骤2.2:在工作区中,建立一个 ATL 工程(Project)。示例程序叫 Simple1,并选择DLL方式,见图一。

图一、建立 ATL DLL 工程

Dynamic Link Library(DLL) 表示建立一个 DLL 的组件程序。

Executable(EXE) 表示建立一个 EXE 的组件程序。

Service(EXE) 表示建立一个服务程序,系统启动后就会加载并执行的程序。

Allow merging of proxy/stub code 选择该项表示把“代理/存根”代码合并到组件程序中,否则需要单独编译,单独注册代理存根程序。代理/存根,这个是什么概念?还记得我们在上回书中介绍的吗?当调用者调用进程外或远程组件功能的时候,其实是代理/存根负责数据交换的。关于代理/存根的具体变成和操作,以后再说啦......

Support MFC 除非有特殊的原因,我们写 ATL 程序,最好不要选择该项。你可能会说,如果没有MFC的支持,那CString怎么办呀?告诉你个秘密吧,一般人我都不告诉他,我后半辈子就靠着这个秘密活着了:

1、你会STL吗?可以用 STL 中的 string 代替;

2、自己写个 MyString 类,嘿嘿;

3、悄悄地、秘密地、不要告诉别人(特别是别告诉微软),把 MFC 中的 CString 源码拿过来用;

4、使用 CComBSTR 类,至少也能简化我们字符串操作;

5、直接用 API 操作字符串,反正我们大家学习 C 语言的时候,都是从这里干起的。(等于没说,呵呵)

Support MTS 支持事务处理,也就是是否支持 COM+ 功能。COM+ 也许在第 99 回介绍吧。

三、增加 ATL 对象类

步骤3.1:菜单 Insert\New ATL Object...(或者用鼠标右键在 ClassView 卡片中弹出菜单)并选择Object 分类,选中 Simple Object 项目。见图二。

图二、选择建立简单COM对象

Category Object 普通组件。其中可以选择的组件对象类型很多,但本质上,就是让向导帮我们默认加上一些接口。比如我们选 "Simple Object",则向导给我们的组件加上 IUnknown 接口;我们选 "Internet Explorer Object",则向导除了加上 IUnknown 接口外,再增加一个给 IE 所使用的 IObjectWithSite 接口。当然了,我们完全可以手工增加任何接口。

Category Controls ActiveX 控件。其中可以选择的 ActiveX 类型也很多。我们在后续的专门介绍 ActiveX 编程中再讨论。

Category Miscellaneous 辅助杂类组件。

Categroy Data Access 数据库类组件(我最讨厌数据库编程了,所以我也不会)。

步骤3.2:增加自定义类 CFun(接口 IFun) ,见图三。

图三、输入类中的各项名称

其实,我们只需要输入短名(Short Name),其它的项目会自动填写。没什么多说的,只请大家注意一下 ProgID 项,默认的 ProgID 构造方式为“工程名.短名”。

步骤3.3:填写接口属性,见图四。

图四、接口属性

Threading Model 选择组件支持的线程模型。COM 中的线程,我认为是最讨厌,最复杂的部分。COM 线程和公寓的概念,留待后续介绍。现在吗......大家都选 Apartment,它代表什么那?简单地说:当在线程中调用组件函数的时候,这些调用会排队进行。因此,这种模式下,我们可以暂时不用考虑同步的问题。(注1)

Interface 接口基本类型。Dual 表示支持双接口(注2),这个非常 非常重要,非常非常常用,但我们今天不讲。Custom 表示自定义借口。切记!切记!我们的这第一个 COM 程序中,一定要选择它!!!!(如果你选错了,请删除全部内容,重新来过。)

Aggregation 我们写的组件,将来是否允许被别人聚合(注3)使用。Only 表示必须被聚合才能使用,有点类似 C++ 中的纯虚类,你要是总工程师,只负责设计但不亲自写代码的话,才选择它。

Support ISupportErrorInfo 是否支持丰富信息的错误处理接口。以后就讲。

Support Connection Points 是否支持连接点接口(事件、回调)。以后就讲。

Free Threaded Marshaler 以后也不讲,就算打死你,我也不说!(注4)

四、添加接口函数

图五、调出增加接口方法的菜单

图六、增加接口函数 Add

图七、增加接口函数 Cat

请严格按照图六的方式,增加Add()函数;由于图七中增加Cat()函数的参数比较长,我没有适当的输入空格,请大家自己输入的时候注意一下。[in]表示参数方向是输入;[out]表示参数方向是输出;[out,retval]表示参数方向是输出,同时可以作为函数运算结果的返回值。一个函数中,可以有多个[in]、[out],但[retval]只能有一个,并且要和[out]组合后在最后一个位置。(注5)

图八、接口函数定义完成后的图示

我们都知道,要想改变 C++ 中的类函数,需要修改两个地方:一是头文件(.h)中类的函数声明,二是函数体(.cpp)文件的实现处。而我们现在用 ATL 写组件程序,则还要修改一个地方,就是接口定义(IDL)文件。别着急 IDL 下次就要讨论啦。

由于 vc6.0 的BUG,导致大家在增加完接口和接口函数后,可能不会向上图(图八)所表现的样式。解决方法:

1

关闭工程,然后重新打开

该方法常常有效

2

关闭 IDE,然后重新运行

3

打开 IDL 文件,检查接口函数是否正确,如不正确请修改

4

打开 IDL 文件,随便修改一下(加一个空格,再删除这个空格),然后保存

该方法常常有效

5

打开 h/cpp 文件,检查函数是否存在或是否正确,有则改之

无则嘉勉,不说完这个成语心理别扭

6

删除 IDL/H/CPP 中的接口函数,然后

再来一遍

7

重新建立工程、重新安装vc、重新安装windows、砸计算机

砸!

五、实现接口函数

鼠标双点图八中CFun\IFun\Add(...)就可以开始输入函数实现了:

STDMETHODIMP CFun::Add(long n1, long n2, long *pVal)

{

*pVal = n1 + n2;

return S_OK;

}

这个太简单了,不再浪费“口条”。下面我们实现字符串连接的Cat()函数:

STDMETHODIMP CFun::Cat(BSTR s1, BSTR s2, BSTR *pVal)

{

int nLen1 = ::SysStringLen( s1 );// s1 的字符长度

int nLen2 = ::SysStringLen( s2 );// s2 的字符长度

*pVal = ::SysAllocStringLen( s1, nLen1 + nLen2 );// 构造新的 BSTR 同时把 s1 先保存进去

if( nLen2 )

{

::memcpy( *pVal + nLen1, s2, nLen2 * sizeof(WCHAR) );// 然后把 s2 再连接进去

//wcscat( *pVal, s2 );

}

return S_OK;

}

学生:上面的函数实现,完全是调用基本的 API 方式完成的。

老师:是的,说实话,的确比较烦琐。

学生:我们是用memcpy()完成连接第二个字符串功能的,那么为什么不用函数 wcscat()那?

老师:多数情况下可以,但你需要知道:由于BSTR包含有字符串长度,因此实际的BSTR字符串内容中是可以存储L''\0''的,而函数 wcscat() 是以L''\0''作为复制结束标志,因此可能会丢失数据。明白了吗?

学生:明白,明白。我看过《COM 组件设计与应用(三)之数据类型》后就明白了。那么老师,有没有简单一些的方法那?

老师:有呀,你看......

STDMETHODIMP CFun::Cat(BSTR s1, BSTR s2, BSTR *pVal)

{

CComBSTR sResult( s1 );

sResult.AppendBSTR( s2 );

*pVal = sResult.Copy();

//*pVal = sResult.Detach();

return S_OK;

}

学生:哈哈,好!使用了 CComBSTR,这个就简单多了。CComBSTR::Copy()和CComBSTR::Detach()有什么区别?

老师:CComBSTR::Copy() 会制造一个 BSTR 的副本,另外CComBSTR::CopyTo()也有类似功能。而CComBSTR::Detach()是使对象与内部的 BSTR 指针剥离,这个函数由于没有复制过程,因此速度稍微快一点点。但要注意,一但剥离后,就不能再使用该对象啦。

学生:老师,您讲的太牛啦,我对您的敬仰如巍巍泰山,直入云霄......

老师:STOP,STOP!留作业啦......

1、自己先按照今天讲的内容写出这个组件;

2、不管你懂不懂,一定要去观察 IDL 文件,CPP 文件;

3、编译后,看都产生了些什么文件?如果是文本的文件,就打开看看;

4、下载本文的示例程序(vc6.0版本)编译运行,看看效果。然后预习一下示例程序中的调用方法;

学生:知道啦,快下课吧,我要上厕所,我都憋的不行了......

老师:下课!别忘了顶我的帖子呀......

六、小结

本回介绍第一个ATL组件程序的建立步骤,而如何使用该组件,敬请关注《COM 组件设计与应用(七)》。

注1:Apartment,系统通过隐藏的窗口消息来排队组件调用,因此我们可以暂时不考虑同步问题。注意,是暂时哈。

注2:双接口表示在一个接口中,同时支持自定义接口和 IDispatch 接口。以后,以后,以后就讲。因为双接口非常重要,我们以后会天天讲、夜夜讲、常常讲------简称“三讲”:)

注3:组件的重用方法有2个,聚合和包容。

注4:名称的功能很好听,但微软根本就没有实现。

注5:这些都是 IDL 文件中的概念,以后用到什么,就介绍什么。

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有