一、实现ISmipleMath,IAdvancedMath接口和DllGetClassObject()
1.1 实现ISmipleMath和IAdvancedMath接口
让我们将原来的CMath 类(CMath其实就是"COM技术初探(二)COM基础知识"里的那个CMath类)修改来实现ISmipleMath接口和IAdvancedMath接口。
修改的地方如下:
1) Math.h文件
01.
/*@**#---2003-10-29 21:33:44 (tulip)---#**@
02.
03.
#include "interface.h"*/
04.
05.
#include "MathCOM.h"//新增加的,以替换上面的东东
06.
07.
class
CMath :
public
ISimpleMath,
08.
public
IAdvancedMath
09.
{
10.
private
:
11.
ULONG
m_cRef;
12.
13.
private
:
14.
int
calcFactorial(
int
nOp);
15.
int
calcFabonacci(
int
nOp);
16.
17.
public
:
18.
CMath();
19.
//IUnknown Method
20.
STDMETHOD(QueryInterface)(REFIID riid,
void
**ppv);
21.
STDMETHOD_(
ULONG
, AddRef)();
22.
STDMETHOD_(
ULONG
, Release)();
23.
24.
// ISimpleMath Method
25.
STDMETHOD (Add)(
int
nOp1,
int
nOp2,
int
* pret);
26.
STDMETHOD (Subtract)(
int
nOp1,
int
nOp2,
int
*pret);
27.
STDMETHOD (Multiply)(
int
nOp1,
int
nOp2,
int
*pret);
28.
STDMETHOD (Divide)(
int
nOp1,
int
nOp2,
int
* pret);
29.
30.
// IAdvancedMath Method
31.
STDMETHOD (Factorial)(
int
nOp,
int
*pret);
32.
STDMETHOD (Fabonacci)(
int
nOp,
int
*pret);
33.
};
2) Math.cpp文件
01.
/*@**#---2003-10-29 21:32:35 (tulip)---#**@
02.
#include "math.h"
03.
04.
STDMETHODIMP CMath::QueryInterface(REFIID riid,
void
**ppv)
05.
{
// 这里这是实现dynamic_cast的功能,但由于dynamic_cast与编译器相关。
06.
if
(riid == IID_ISimpleMath)
07.
*ppv =
static_cast
<ISimpleMath *>(
this
);
08.
else
if
(riid == IID_IAdvancedMath)
09.
*ppv =
static_cast
<IAdvancedMath *>(
this
);
10.
else
if
(riid == IID_IUnknown)
11.
*ppv =
static_cast
<ISimpleMath *>(
this
);
12.
else
{
13.
*ppv = 0;
14.
return
E_NOINTERFACE;
15.
}
16.
17.
//这里要这样是因为引用计数是针对组件的
18.
reinterpret_cast
<IUnknown *>(*ppv)->AddRef();
19.
return
S_OK;
20.
}
21.
22.
STDMETHODIMP_(
ULONG
) CMath::AddRef()
23.
{
24.
return
++m_cRef;
25.
}
26.
27.
STDMETHODIMP_(
ULONG
) CMath::Release()
28.
{
29.
// 使用临时变量把修改后的引用计数值缓存起来
30.
ULONG
res = --m_cRef;
31.
32.
// 因为在对象已经销毁后再引用这个对象的数据将是非法的
33.
if
(res == 0)
34.
delete
this
;
35.
return
res;
36.
}
37.
38.
STDMETHODIMP CMath::Add(
int
nOp1,
int
nOp2,
int
* pret)
39.
{
40.
*pret=nOp1+nOp2;
41.
return
S_OK;
42.
}
43.
44.
STDMETHODIMP CMath::Subtract(
int
nOp1,
int
nOp2,
int
* pret)
45.
{
46.
*pret= nOp1 - nOp2;
47.
return
S_OK;
48.
}
49.
50.
STDMETHODIMP CMath::Multiply(
int
nOp1,
int
nOp2,
int
* pret)
51.
{
52.
*pret=nOp1 * nOp2;
53.
return
S_OK;
54.
}
55.
56.
STDMETHODIMP CMath::Divide(
int
nOp1,
int
nOp2,
int
* pret)
57.
{
58.
*pret= nOp1 / nOp2;
59.
return
S_OK;
60.
}
61.
62.
int
CMath::calcFactorial(
int
nOp)
63.
{
64.
if
(nOp <= 1)
65.
return
1;
66.
67.
return
nOp * calcFactorial(nOp - 1);
68.
}
69.
70.
STDMETHODIMP CMath::Factorial(
int
nOp,
int
* pret)
71.
{
72.
*pret=calcFactorial(nOp);
73.
return
S_OK;
74.
}
75.
76.
int
CMath::calcFabonacci(
int
nOp)
77.
{
78.
if
(nOp <= 1)
79.
return
1;
80.
81.
return
calcFabonacci(nOp - 1) + calcFabonacci(nOp - 2);
82.
}
83.
84.
STDMETHODIMP CMath::Fabonacci(
int
nOp,
int
* pret)
85.
{
86.
*pret=calcFabonacci(nOp);
87.
return
S_OK;
88.
}
89.
90.
CMath::CMath()
91.
{
92.
m_cRef=0;
93.
}
1.2 COM组件调入大致过程
创建过程示意图如下:
1) COM库初始化 使用CoInitialize COM API函数(客户端)使组件加入套间,关于套间的概念我们以后再讲。(客户端)
2)激活COM(客户端)
3) 通过注册表项将对应的DLL调入COM库中(COM运行环境)
4) 调用COM组件内的DllGetClassObject()导出函数(COM组件)
5)通过类厂返回类厂的接口指针(如果客户端是使用CoCreateInstance创建组件时不需要缓存类厂接口指针,则此步在COM运行环境中完成不返回给客户端,同时马上进入第6步。与此相反,客户端会缓存组件类厂接口指针。此方法当客户需要创建多个实例时很有用。)(COM库)
6)通过类厂接口指针调用CreateInstance创建组件实例。
1.3 DllGetClassObject()实现
在MathCOM.cpp里加入下列语句
01.
#include "math.h"
02.
#include "MathCOM_i.c"
03.
并将MathCOM.cpp里的DllGetClassObject()修改成如下:
04.
/*********************************************************************
05.
* Function Declare : DllGetClassObject
06.
* Explain :
07.
* Parameters :
08.
* REFCLSID rclsid --
09.
* REFIID riid --
10.
* void **ppv --
11.
* Return :
12.
* STDAPI --
13.
* Author : tulip
14.
* Time : 2003-10-29 22:03:53
15.
*********************************************************************/
16.
STDAPI DllGetClassObject(REFCLSID rclsid ,REFIID riid,
void
**ppv)
17.
{
18.
if
(rclsid == CLSID_MathCom)
19.
{
20.
21.
return
pm_math->QueryInterface(riid,ppv);
22.
}
23.
return
CLASS_E_CLASSNOTAVAILABLE;
24.
}
1.4 客户端
接下来我们写个客户端程序对此COM进行测试。
新建空的名为TestMathCOM一个win32 Console工程加入到MathCOM workspace中。
在TestMathCOM工程里添加一个名为main.cpp的文件,此文件的内容如下:
01.
//main.cpp文件
02.
#include <windows.h>
03.
#include "../MathCOM.h"//这里请注意路径
04.
#include "../MathCOM_i.c"//这里请注意路径
05.
#include <iostream>
06.
using
namespace
std;
07.
08.
void
main(
void
)
09.
{
10.
//初始化COM库
11.
HRESULT
hr=::CoInitialize(0);
12.
ISimpleMath * pSimpleMath=NULL;
13.
IAdvancedMath * pAdvancedMath=NULL;
14.
15.
int
nReturnValue=0;
16.
17.
hr=::CoGetClassObject(CLSID_MATHCOM,
18.
CLSCTX_INPROC,
19.
NULL,
20.
IID_ISimpleMath,
21.
(
void
**)&pSimpleMath);
22.
23.
if
(SUCCEEDED(hr))
24.
{
25.
hr=pSimpleMath->Add(10,4,&nReturnValue);
26.
if
(SUCCEEDED(hr))
27.
cout <<
"10 + 4 = "
<<nReturnValue<< endl;
28.
nReturnValue=0;
29.
}
30.
// 查询对象实现的接口IAdvancedMath
31.
hr=pSimpleMath->QueryInterface(IID_IAdvancedMath, (
void
**)&pAdvancedMath);
32.
if
(SUCCEEDED(hr))
33.
{
34.
hr=pAdvancedMath->Fabonacci(10,&nReturnValue);
35.
if
(SUCCEEDED(hr))
36.
cout <<
"10 Fabonacci is "
<< nReturnValue << endl;
37.
}
38.
pAdvancedMath->Release();
39.
pSimpleMath->Release();
40.
::CoUninitialize();
41.
::
system
(
"pause"
);
42.
return
;
43.
}
关于如何调试dll请参阅附录A
1.5 小结
到现在我们应该有2个工程和8个文件,具体如下
工程 | 文件 | 作用 |
MathCOM | Stdafx.h和stdafx.cpp | 预编译文件 |
MathCOM.cpp | Dll入口函数及其他重要函数定义的地方 | |
MathCOM.def | 模块定义文件 | |
MathCOM.idl | 接口定义文件(在1.2后如果编译的话应该还有四个文件) | |
math.h和math.cpp | ISmipleMath,IadvancedMath接口的实现类 | |
TestMathCOM | Main.cpp | MathCOM的客户端,用于测试MathCOM组件 |
在此部分中我们已经完成一个可以实用的接近于完整COM组件( 没有完整的地方是还没有实现DllCanUnloadNow() )。我们完成了此COM组件的客户端。
如果你已经创建COM实例的话,你可能会发现在此部分的客户端并不是用CoCreateInstance()来创建COM实例,那是因为我们还没有在此COM组件里实现IClassFactory接口(此接口在下一部分实现)。
通过这个例子,我希望大家明白以下几点:
1) DllGetClassObject()的作用(此函数的详细说明请参阅<<COM本质论>>p86) ,请参看COM组件调入大致过程这一节,同时也请将断点打在DllGetClassObject()函数上,仔细看看他的实现(在没有实现IClassFactory接口的情况下)和他的传入参数。
2) 为什么在这个客户端程序里不使用CoCreateInstance()来创建COM实例而使用CoGetClassObject()来创建COM实例。你可以试着用CoCreateInstance()来创建Cmath,看看DllGetClassObject()的第一参数是什么?
3) 实现IClassFactory接口不是必需的,但应该说是必要的(如何实现请看下一章)
4) 应掌握DllRegisterServer()和DllUnregisterServer()的实现。
5) 客户端在调用COM组件时需要那几个文件(只要由idl文件产生的两个文件)
二、类厂
2.1 回顾
在上节里,我们创建组件实例及得到接口指针的过程如下:首先在客户端的用户调用COM API CoCreateInstance,这个函数调用另一个COM API CoGetClassObject获得组件的类厂接口指针,此时COM库会加载组件DLL(EXE的处理方式稍有不同,我们会在以后的章节中讲解)中的导出函数DllGetClassObject(),获得类厂接口指针后马上调用类厂的方法CreateInstance创建对象实例并通过组件对象的QueryInterface()得到用需的接口指针。
此前我们所实现的并不是真正完整的COM组件,现在我们来实现一个真正的COM组件,实现组件创建机制的核心:类厂 - 创建组件对象的对象。COM为通用化以及在管理上统一和方便,COM规范要求所有标准COM组件都应实现IClassFactory接口(有关IClassFactory的功能各个方法的作用请参阅MSND/Welcome to the msnd library/msnd resource/selected online columns/Dr.GUI online/Dr. GUI on Components, COM, and ATL/part 5)
2.2 增加IClassFactory的实现
此次我们将修改的文件如下
工程名 | 文件名 | 修改属性 |
MathCOM | MathCOM.cpp | 修改 |
MathFactory.h和MathFactory.cpp | 新增 | |
TestMathCOM | Main.cpp | 修改 |
2.2.1 MathCOM.cpp
01.
#include "math.h"
02.
#include "MathCOM_i.c"
03.
#include "MathFactory.h"
04.
05.
//
06.
// 服务器锁, 如果标志为S_OK,就可以卸载当前组件的服务器,
07.
// 关于引用计数及服务器跟COM对象的关系,后绪章节再讲解
08.
LONG
g_cObjectAndLocks=0;
09.
10.
//standard self-registration table
11.
const
char
* g_RegTable[][3]={………………….
12.
…………………………
13.
STDAPI DllGetClassObject(REFCLSID rclsid ,REFIID riid,
void
**ppv)
14.
{
15.
if
(rclsid==CLSID_MATHCOM)
16.
{
17.
CMathFactory *pFactory =
new
CMathFactory;
// 创建类厂对象
18.
if
(pFactory == NULL)
19.
return
E_OUTOFMEMORY;
20.
21.
///
22.
// 一般情况下COM希望用户只查询IClassFactory,
23.
// IClassFactory2及IUnknow
24.
HRESULT
hr = pFactory->QueryInterface(iid, ppv);
25.
26.
return
hr;
27.
}
28.
return
CLASS_E_CLASSNOTAVAILABLE;
29.
}
30.
STDAPI DllCanUnloadNow(
void
)
31.
{
32.
return
(g_cObjectAndLocks==0)?S_OK:E_FAIL;
33.
}
2.2.2 MathFactory.h
01.
// MathFactory.h: interface for the CMathFactory class.
02.
//
03.
//
04.
05.
#ifndef MATHFACTORY_H
06.
#define MATHFACTORY_H
07.
#include <unknwn.h>
08.
09.
class
CMathFactory :
public
IClassFactory
10.
{
11.
public
:
12.
CMathFactory():m_cRef(0){}
13.
14.
//IUnknow Method
15.
STDMETHODIMP QueryInterface(REFIID,
void
**);
16.
STDMETHODIMP_(
ULONG
) AddRef();
17.
STDMETHODIMP_(
ULONG
) Release();
18.
19.
//IClassFactory Method
20.
STDMETHODIMP CreateInstance(IUnknown * ,REFIID ,
void
**);
21.
STDMETHODIMP LockServer(
BOOL
fLock);
22.
23.
protected
:
24.
LONG
m_cRef;
25.
26.
};
27.
#endif
2.2.3 MathFactory.cpp
01.
// MathFactory.cpp: implementation of the CMathFactory class.
02.
//
03.
/
04.
#include "math.h"
05.
#include "MathFactory.h"
06.
07.
extern
LONG
g_cObjectAndLocks;
08.
/
09.
// Construction/Destruction
10.
/
11.
12.
13.
STDMETHODIMP_(
ULONG
) CMathFactory::AddRef(
void
)
14.
{
15.
return
InterlockedIncrement(&m_cRef);
16.
}
17.
18.
STDMETHODIMP_(
ULONG
) CMathFactory::Release(
void
)
19.
{
20.
return
::InterlockedDecrement(&m_cRef);
21.
}
22.
23.
STDMETHODIMP CMathFactory::QueryInterface(REFIID riid,
void
** ppv)
24.
{
25.
*ppv=NULL;
26.
if
(riid==IID_IUnknown||riid==IID_IClassFactory)
27.
{
28.
*ppv=
static_cast
<IClassFactory *>(
this
);
29.
reinterpret_cast
<IUnknown*>(*ppv)->AddRef();
30.
return
S_OK;
31.
}
32.
else
33.
return
(*ppv=0),E_NOINTERFACE;
34.
}
35.
36.
STDMETHODIMP CMathFactory::CreateInstance(IUnknown * pUnkOuter,REFIID riid,
void
** ppv)
37.
{
38.
*ppv=NULL;
39.
// 现在不支持聚合
40.
if
(pUnkOuter!=NULL)
41.
return
CLASS_E_NOAGGREGATION;
42.
CMath * pMath=
new
CMath;
43.
if
(pMath==NULL)
44.
return
E_OUTOFMEMORY;
45.
HRESULT
hr=pMath->QueryInterface(riid,ppv);
46.
47.
if
(FAILED(hr))
48.
delete
pMath;
49.
return
hr;
50.
}
51.
52.
STDMETHODIMP CMathFactory::LockServer(
BOOL
fLock)
53.
{
54.
if
(fLock)
55.
::InterlockedIncrement(&g_cObjectAndLocks);
56.
else
57.
::InterlockedDecrement(&g_cObjectAndLocks);
58.
return
NOERROR;
59.
60.
}
2.2.4 main.cpp
01.
#include <windows.h>
02.
#include "../MathCOM.h"
03.
#include "../MathCOM_i.c"
04.
#include <iostream>
05.
using
namespace
std;
06.
07.
void
main(
void
)
08.
{
09.
//初始化COM库
10.
HRESULT
hr=::CoInitialize(0);
11.
ISimpleMath * pSimpleMath=NULL;
12.
IAdvancedMath * pAdvancedMath=NULL;
13.
14.
int
nReturnValue=0;
15.
16.
//如果还想用CoCreateInstance()得到接口指针,请如下使用先传一个IClassFactory接口
17.
18.
/*************** 这里请注意 *****************/
19.
// 方法一
20.
hr = ::CoCreateInstance(CLSID_MATHCOM,
21.
CLSCTX_INPROC,
22.
NULL,
23.
IID_ISimpleMath,
24.
(
void
*)&pSimpleMath);
25.
26.
///
27.
// 这个方法的好处是不需要太多的代码, 让COM来处理真正的类厂创建对象的过程.
28.
// 同时这个函数的改进版CoCreateInstanceEx在分布式对象应用中可以一次取回多
29.
// 个接口指针. 避免过多的在网络上浪费时间关于这个函数的用法我也会在以后的
30.
// 章节中讲解. 您也可以参考MSDN或相关书藉
31.
32.
// 方法二
33.
IClassFactory * pClassFactory=NULL;
// 类厂接口指针
34.
// 获取对象的类厂接口指针
35.
hr=::CoGetClassObject(CLSID_MATHCOM,
36.
CLSCTX_INPROC,
37.
NULL,
38.
IID_IClassFactory,
39.
(
void
**)&pClassFactory);
40.
41.
// 真正创建对象
42.
hr = pClassFactory->CreateInstance(NULL,IID_ISimpleMath,(
void
**)&pSimpleMath);
43.
// 此方法的好处在于可以一次创建多个对象, 不需要
44.
45.
// 下面测试 IDispatch 接口
46.
if
(SUCCEEDED(hr))
47.
{
48.
hr=pSimpleMath->Add(10,4,&nReturnValue);
49.
if
(SUCCEEDED(hr))
50.
cout <<
"10 + 4 = "
<<nReturnValue<< endl;
51.
nReturnValue=0;
52.
}
53.
54.
//查询对象实现的接口IAdvancedMath
55.
hr=pSimpleMath->QueryInterface(IID_IAdvancedMath, (
void
**)&pAdvancedMath);
56.
57.
if
(SUCCEEDED(hr))
58.
{
59.
hr=pAdvancedMath->Fabonacci(10,&nReturnValue);
60.
if
(SUCCEEDED(hr))
61.
cout <<
"10 Fabonacci is "
<< nReturnValue << endl;
62.
}
63.
pAdvancedMath->Release();
64.
pSimpleMath->Release();
65.
66.
::CoUninitialize();
67.
return
;
68.
}
2.3 小结
在此部分我们实现了IClassFactory接口,可以说实现了一个真正的COM对象了,我们可以在C++中使用一般的COM客户端方法创建对象,执行方法等。但是不知道用户有没有发现,COM的目标是语言无关,像VB中不支持指针,脚本是解释执行(但是COM需要在编译期间绑定接口调用)。怎么办呢?有没有办法实现呢?方法当然是有的。接下来的一节我不为大家讲解为不支持指针的语言而提供支持的特殊接口IDispatch - 派发接口(也称调度接口)。为上述语言提供一个效率上稍差但灵活性更高的解决方法。接下来这一章让我们实现IDispatch接口,以便在脚本环境中使用我们的COM组件。
三、实现派发接口
为了在脚本语言环境中使用COM组件,COM规范规定要在脚本语言环境使用的COM必须实现IDispatch接口,此时的COM接口被称为派发接口。还记得我们在讲IDL的时个描述接口的内容吗?当时我们并没有设置这个关于接口的说明:custom和dual。前者是自定义接口,也就是从IUnknown派生的接口。后者是从IDispatch派生的接口,当然IDispatch也必须从IUnknown派生。只有当此接口从IDispatch派生时,此COM组件可在不支持指针及脚本语言环境下使用。现在让我们的组件也支持双接口。
3.1 IDispatch接口
IDispatch接口共有四个方法,其中只有比较重要(Invoke)。其它方法我们暂时用不到,就没有实现。如果读者有兴趣自己可以参考相关资料来实现一下。并不是很难。像GetIDsOfName等可以交给ITypeInfo等接口处理。讲到这里可能就复杂了。我们以后再为读者讲解。我们的MathCOM组件也只实现了Invoke方法,其他方法都返回E_NOTIMPL表示没有实现。
关于IDispatch接口请参阅MSND文档或<<COM本质论>>p295页
3.2 支持派发接口的MathCOM组件
要让我们的MathCOM组件支持双接口,需要修改如下文件
工程名 | 文件名 |
MathCOM | MathCOM.idl |
Math.h和Math.cpp | |
TestMathCOM | Main.cpp |
3.2.1修改MathCOM.idl
MathCOM.idl文件需要修改三个地方。
1) 增加daul属性,以便表明我们的接口是双接口。
2) 将接口的基类由IUnknow接口变成IDispatch接口
3) 在接口的每个方法加上序号属性
修改后的MathCOM.idl如下(请自己找出修改的地方)
01.
// MathCOM.idl : IDL source for MathCOM.dll
02.
//
03.
04.
// This file will be processed by the MIDL tool to
05.
// produce the type library (MathCOM.tlb) and marshalling code.
06.
07.
import
"oaidl.idl"
;
08.
import
"ocidl.idl"
;
09.
[
10.
uuid
(FAEAE6B7-67BE-42a4-A318-3256781E945A),
11.
helpstring(
"ISimpleMath Interface"
),
12.
object,
13.
dual,
// 这个标识我们前面没遇到过。
14.
pointer_default(unique)
15.
]
16.
interface ISimpleMath : IDispatch
17.
{
18.
[id(1)]
HRESULT
Add([in]
int
nOp1,[in]
int
nOp2,[out,retval]
int
* pret);
19.
[id(2)]
HRESULT
Subtract([in]
int
nOp1,[in]
int
nOp2,[out,retval]
int
* pret);
20.
[id(3)]
HRESULT
Multiply([in]
int
nOp1,[in]
int
nOp2,[out,retval]
int
* pret);
21.
[id(4)]
HRESULT
Divide([in]
int
nOp1,[in]
int
nOp2,[out,retval]
int
* pret);
22.
};
23.
24.
[
25.
uuid
(01147C39-9DA0-4f7f-B525-D129745AAD1E),
26.
helpstring(
"IAdvancedMath Interface"
),
27.
object,
28.
dual,
29.
pointer_default(unique)
30.
]
31.
interface IAdvancedMath : IDispatch
32.
{
33.
[id(1)]
HRESULT
Factorial([in]
int
nOp1,[out,retval]
int
* pret);
34.
[id(2)]
HRESULT
Fabonacci([in]
int
nOp1,[out,retval]
int
* pret);
35.
};
36.
[
37.
uuid
(CA3B37EA-E44A-49b8-9729-6E9222CAE844),
38.
version(1.0),
39.
helpstring(
"MATHCOM 1.0 Type Library"
)
40.
]
41.
library MATHCOMLib
42.
{
43.
importlib(
"stdole32.tlb"
);
44.
importlib(
"stdole2.tlb"
);
45.
46.
47.
[
48.
uuid
(3BCFE27E-C88D-453C-8C94-F5F7B97E7841),
49.
helpstring(
"MATHCOM Class"
)
50.
]
51.
coclass MATHCOM
52.
{
53.
[
default
] interface ISimpleMath;
54.
interface IAdvancedMath;
55.
};
56.
};
3.2.2 修改math.h文件
在math.h增加IDispatch接口的四个方法声明,并对三个进行简单的实现。修改后的math.h见下
01.
//前面相同
02.
CMath();
03.
//IUnknown Method
04.
STDMETHOD(QueryInterface)(REFIID riid,
void
**ppv);
05.
STDMETHOD_(
ULONG
, AddRef)();
06.
STDMETHOD_(
ULONG
, Release)();
07.
08.
//IDispatch Method
09.
STDMETHOD(GetTypeInfoCount)(
UINT
* pit){
return
E_NOTIMPL;}
10.
STDMETHOD(GetTypeInfo)(
UINT
it,
LCID
lcid,ITypeInfo **ppti){
return
E_NOTIMPL; }
11.
STDMETHOD(GetIDsOfNames)(REFIID riid,
12.
OLECHAR ** pNames,
13.
UINT
nNames,
14.
LCID
lcid,
15.
DISPID * pdispids){
return
E_NOTIMPL; }
16.
STDMETHOD(Invoke)(DISPID id,
17.
REFIID riid,
18.
LCID
lcid,
19.
WORD
wFlags,
20.
DISPPARAMS *pd,
21.
VARIANT * pVarResult,
22.
EXCEPINFO * pe,
23.
UINT
*pu);
24.
25.
// ISimpleMath Method
26.
STDMETHOD (Add)(
int
nOp1,
int
nOp2,
int
* pret);
27.
STDMETHOD (Subtract)(
int
nOp1,
int
nOp2,
int
*pret);
28.
STDMETHOD (Multiply)(
int
nOp1,
int
nOp2,
int
*pret);
29.
STDMETHOD (Divide)(
int
nOp1,
int
nOp2,
int
* pret);
30.
//后面相同
3.2.3 修改math.cpp文件
增加IDispatch接口中的Invoke方法的实现。修改后的math.cpp文件见下
01.
//前面相同
02.
CMath::CMath()
03.
{
04.
m_cRef=0;
05.
}
06.
07.
/*********************************************************************
08.
* Function Declare : CMath::Invoke
09.
* Explain : IDispatch接口的Invoke方法
10.
* Parameters :
11.
* DISPID id -- 方法的调度ID(请与idl中序号相比较)
12.
* REFIID riid -- 接口IID
13.
* LCID lcid -- 语言ID
14.
* WORD wFlags --
15.
* DISPPARAMS * pd -- 传入参数结构(具体结构请参阅MSDN或本质论p294)
16.
* VARIANT * pVarResult -- 出参(VARIANT请参阅MSDN文档或<<深入解析ATL>>p56
17.
* EXCEPINFO * pe -- 异常(一般为NULL)
18.
* UINT * pu --
19.
* Return :
20.
* STDMETHODIMP --
21.
* Author : tulip
22.
* Time : 2003-10-30 15:56:37
23.
*********************************************************************/
24.
STDMETHODIMP CMath::Invoke(DISPID id,
25.
REFIID riid,
26.
LCID
lcid,
WORD
wFlags,
27.
DISPPARAMS * pd,
28.
VARIANT * pVarResult,
29.
EXCEPINFO * pe,
30.
UINT
* pu)
31.
{
32.
if
(riid==IID_ISimpleMath)
33.
{
34.
if
(1==id)
35.
return
Add(pd->rgvarg[0].intVal,pd->rgvarg[1].intVal,&pVarResult->intVal);
36.
else
if
(2==id)
37.
return
Subtract(pd->rgvarg[0].intVal,pd->rgvarg[1].intVal,&pVarResult->intVal);
38.
else
if
(3==id)
39.
return
Multiply(pd->rgvarg[0].intVal,pd->rgvarg[1].intVal,&pVarResult->intVal);
40.
else
if
(4==id)
41.
return
Divide(pd->rgvarg[0].intVal,pd->rgvarg[1].intVal,&pVarResult->intVal);
42.
else
43.
return
E_FAIL;
44.
}
45.
else
if
(riid==IID_IAdvancedMath)
46.
{
47.
if
(1 == id)
48.
return
Factorial(pd->rgvarg[0].intVal,&pVarResult->intVal);
49.
else
if
(2 == id)
50.
return
Fabonacci(pd->rgvarg[0].intVal,&pVarResult->intVal);
51.
else
52.
return
E_FAIL;
53.
}
54.
else
55.
return
E_NOINTERFACE;
56.
}
在修改后上述三个文件,请重新编译,(如果你在上次注册前已经移动过过工程,请重新注册
3.2.4 修改main.cpp文件
修改main.cpp文件的目的是通过IDispatch接口中的Invoke方法来测试我们的组件。
修改后的main.cpp文件见下
01.
#include <windows.h>
02.
#include "../MathCOM.h"
03.
#include "../MathCOM_i.c"
04.
#include <iostream>
05.
using
namespace
std;
06.
#include <atlbase.h>
07.
08.
void
main(
void
)
09.
{
10.
/
11.
// 初始化COM库,这里的真正含义是把COM加入适当的套间,
12.
// 关于套间的概念及其它相关概念会在后绪文章中讲解。
13.
HRESULT
hr = ::CoInitialize(NULL);
14.
15.
ISimpleMath * pSimpleMath=NULL;
16.
IAdvancedMath * pAdvancedMath=NULL;
17.
IDispatch * pDispatch=NULL;
// 派发接口指针
18.
int
nReturnValue=0;
19.
20.
hr = ::CoCreateInstance(CLSID_MATHCOM,
21.
CLSCTX_INPROC,
22.
NULL,
23.
IID_ISimpleMath,
24.
(
void
*)&pSimpleMath);
25.
/
26.
// 下面测试IDispatch接口
27.
//
28.
pSimpleMath->QueryInterface(IID_IDispatch,(
void
**)&pDispatch);
29.
if
(SUCCEEDED(hr))
30.
{
31.
cout<<
"下面进行IDispatch接口"
<<endl;
32.
CComVariant varResult;
33.
CComVariant varResult2;
34.
CComVariant *pvars=
new
CComVariant[2];
35.
CComVariant *pvars2=
new
CComVariant[1];
36.
varResult.Clear();
37.
pvars[1]=4;
38.
pvars[0]=10;
39.
DISPPARAMS disp = { pvars, NULL, 2, 0 };
40.
hr=pDispatch->Invoke(0x1,
41.
IID_ISimpleMath,
42.
LOCALE_USER_DEFAULT,
43.
DISPATCH_METHOD,
44.
&disp,
45.
&varResult,
46.
NULL,
47.
NULL);
48.
if
(SUCCEEDED(hr))
49.
cout <<
"10 + 4 = "
<<varResult.intVal<< endl;
50.
varResult2.Clear();
51.
pvars2[0]=10;
52.
DISPPARAMS disp2={pvars2,NULL,1,0};
53.
hr=pDispatch->Invoke(0x2,
54.
IID_IAdvancedMath,
55.
LOCALE_USER_DEFAULT,
56.
DISPATCH_METHOD,
57.
&disp,
58.
&varResult2,
59.
NULL,
60.
NULL);
61.
if
(SUCCEEDED(hr))
62.
cout <<
"10 Fabonacci is "
<<varResult2.intVal << endl;
63.
cout<<
"IDispatch接口测试完毕"
<<endl;
64.
::
system
(
"pause"
);
65.
}
66.
/*
67.
*IDispatch接口测试完毕
68.
*/
69.
if
(SUCCEEDED(hr))
70.
{
71.
hr=pSimpleMath->Add(10,4,&nReturnValue);
72.
if
(SUCCEEDED(hr))
73.
cout <<
"10 + 4 = "
<<nReturnValue<< endl;
74.
nReturnValue=0;
75.
}
76.
// 查询对象实现的接口IAdvancedMath
77.
hr=pSimpleMath->QueryInterface(IID_IAdvancedMath, (
void
**)&pAdvancedMath);
78.
if
(SUCCEEDED(hr))
79.
{
80.
hr=pAdvancedMath->Fabonacci(10,&nReturnValue);
81.
if
(SUCCEEDED(hr))
82.
cout <<
"10 Fabonacci is "
<< nReturnValue << endl;
83.
}
84.
85.
pAdvancedMath->Release();
86.
pSimpleMath->Release();
87.
pDispatch->Release();
88.
::CoUninitialize();
89.
return
;
90.
}
四 总结
真的好高兴啊,终于要写总结了。
我们再回顾一下,我们到底干了些什么,我们实现了类厂,实现了一个真正的COM对象,同时为了在不支持指针及脚本环境中使用COM我们又实现了IDispatch派发接口。至于,为什么要实现IDispach,IDispatch是怎么实现的,也就是早期捆绑和晚期捆绑的概念。我们将在下一章中讲解。希望大家看到这里不至于没方向了。不过里面尚有不少你们看到但不知道什么意义,不急。慢慢来,我会在以后各章详细讲述这些概念。现在我想让你们知道一个COM组件大致的创建过程,对COM有一定宏观上的认识。毕竟我的水平有限,没有大师级讲解透彻。我只是将我对COM的一点认识与大家共享一下。希望大家一起进步。
在第一部分,我想大家了解COM的好处。接下来第二部分,我们看到COM核心结构图(接下来所有的例子都是以图1.3为中心的)。在第三部分,我step by step 讲如何实现一个完整的COM组件。
COM原理比较简单,但在实现时比较灵活,这就造成了大多数人感到难以掌握,其实只要抓住COM的本质,其他的东西都比较简单。如果你了解了”**”这个东东,那你懂大部分了。如果你完全搞明白了什么是接口类,实现类,类对象以及他们之间的关系,那你又前进了一大步。
最后希望大家在学习COM的道路能够感受到快乐。以后有空我们一起交流,哈哈!!
“COM IS LOVE”。
五 参考资料
COM方面 (在COM方面除潘爱明的作著可以看看外,国内其他作者的东西都是垃圾。)
<<COM本质论>> Don Box (如果没有看过这本书那你的COM就那个样了^_^)
<<COM技术内幕>> (比较浅,适合入门)
<<COM原理实现与应用>> (潘爱明,本书比较详细讲解了COM的几大核心应用)
ATL方面
<<深入解析ATL>> (相当于COM界里的<<COM本质论>>)
MSDN
MSJ 杂志的<<House of COM>>由Don Box主持 (现在MSDN杂志已经没有此专栏,但你还是可以在MSDN许多相当文章)
MSDN Dr.GUI online 具体位置在MSND/Welcome to the msnd library/
msnd resource/selected online columns/Dr.GUI online/
MSDN SDK 文档 具体位置 MSDN/Platform SDK Documentation/Component Servies
MSDN 的技术文章 位置 MSDN/Technical Articles/Component Object Model
MSDN BackGrounders 有一些相当于白皮书之类的东西。