COM技术初探(三）-- 一个真正的COM

最新推荐文章于 2023-02-24 16:36:31 发布

liu5320102

最新推荐文章于 2023-02-24 16:36:31 发布

阅读量844

点赞数

分类专栏： MFC/COM/ATL 文章标签： COM

MFC/COM/ATL 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

一、实现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/