一个简单的com组件的实现

1.什么是com

 

com是微软公司为了计算机工业的软件生产更加符合人类的行为方式开发的一种新的软件开发技术。在COM构架下，人们可以开发出各种各样的功能专一的组件，然后将它们按照需要组合起来，构成复杂的应用系统。由此带来的好处是多方面的：可以将系统中的组件用新的替换掉，以便随时进行系统的升级和定制；可以在多个应用系统中重复利用同一个组件；可以方便的将应用系统扩展到网络环境下；COM与语言，平台无关的特性使所有的程序员均可充分发挥自己的才智与专长编写组件模块；等等。

　COM组件由以Win 32动态连接库（DLL）或可执行文件（EXE）形式发布的可执行代码所组成。遵循COM规范编写出来的组件将能够满足对组件架构的所有要求。COM组件可以给应用程序、操作系统以及其他组件提供服务；自定义的COM组件可以在运行时刻同其他组件连接起来构成某个应用程序；COM组件可以动态的插入或卸出应用。

2.动态链接库

   先来阐述一下DLL(Dynamic Linkable Library)的概念，你可以简单的把DLL看成一种仓库，它提供给你一些可以直接拿来用的变量、函数或类。在仓库的发展史上经历了“无库－静态链接库－动态链接库”的时代。

　　静态链接库与动态链接库都是共享代码的方式，如果采用静态链接库，则无论你愿不愿意，lib中的指令都被直接包含在最终生成的EXE文件中了。但是若使用DLL，该DLL不必被包含在最终EXE文件中，EXE文件执行时可以“动态”地引用和卸载这个与EXE独立的DLL文件。静态链接库和动态链接库的另外一个区别在于静态链接库中不能再包含其他的动态链接库或者静态库，而在动态链接库中还可以再包含其他的动态或静态链接库。

 

   下面将给出一个利用dll实现的组件，当然这个组件并没有完全实现，缺少将组件添加到注册表中的功能。

组件

   在该组件中我们实现了IX和IY的接口，IX和IY借口约定该组件必须提供Fx和Fy方法的实现。

 

query.h

 

#ifndef QUERY_H_ #define QUERY_H_ #include <objbase.h> #include <iostream> #ifdef DLLEXPORT #define DLLFUNCTION _declspec(dllexport) #define DLLINTERFACE extern "C" interface _declspec(dllexport) #define DLLCLASS extern "C" class _declspec(dllexport) #else #define DLLFUNCTION _declspec(dllimport) #define DLLINTERFACE extern "C" interface _declspec(dllimport) #define DLLCLASS extern "C" class _declspec(dllimport) #endif /* DLLINTERFACE IX:IUnknown { virtual void _stdcall Fx()=0; }; */ DECLARE_INTERFACE_(IX,IUnknown) { BEGIN_INTERFACE STDMETHOD(QueryInterface)(THIS_ REFIID,void **ppv) PURE; STDMETHOD_(ULONG,AddRef)(THIS) PURE; STDMETHOD_(ULONG,Release)(THIS) PURE; STDMETHOD_(void,Fx)(THIS) PURE; END_INTERFACE }; DLLINTERFACE IY:IUnknown { virtual void _stdcall Fy()=0; }; DLLINTERFACE IZ:IUnknown { virtual void _stdcall Fz()=0; }; extern "C" DLLFUNCTION IUnknown* CreateInstance(); extern "C" DLLFUNCTION void trace(char* msg); extern "C" { const IID IID_IX; const IID IID_IY; const IID IID_IZ; } #endif 

在该头文件中我们定义了一些宏，这些宏是为了我们定义组件和使用组件的方便性而定义的，在定义组件时通过#define DLLEXPORT 就可以给出一个动态链接库中定义的函数，而在使用时因为没有田间#define DLLEXPORT宏所以是导入定义好的函数。

query.cpp

#define DLLEXPORT #include "query.h" DLLCLASS CA:public IX,public IY { virtual HRESULT _stdcall QueryInterface(const IID& IID,void** ppv); virtual ULONG _stdcall AddRef(); virtual ULONG _stdcall Release(); virtual void _stdcall Fx(); virtual void _stdcall Fy(); private: long m_cRef; }; void trace(char* msg) { std::cout<<"trace guids"<<msg<<std::endl; } HRESULT _stdcall CA::QueryInterface(const IID& IID,void** ppv) { if(IID==IID_IUnknown) { trace("QueryInterface:Return pointer to IUnkown"); *ppv=static_cast<IX*>(this); } else if(IID==IID_IX) { trace("QueryInterface:Return pointer to IX"); *ppv=static_cast<IX*>(this); } else if(IID==IID_IY) { trace("QueryInterface:Return pointer to IY"); *ppv=static_cast<IY*>(this); } else { trace("QueryInterface:interface not Supported"); *ppv=NULL; return E_NOINTERFACE; } reinterpret_cast<IUnknown* >(*ppv)->AddRef(); return S_OK; } void _stdcall CA::Fx() { trace("Fx function"); } void _stdcall CA::Fy() { trace("Fy function"); } IUnknown* CreateInstance() { IUnknown* pI=static_cast<IX*>(new CA); pI->AddRef(); return pI; } ULONG _stdcall CA::AddRef() { trace("AddRef"); return InterlockedIncrement(&m_cRef); } ULONG _stdcall CA::Release() { trace("Release"); if(InterlockedDecrement(&m_cRef)==0) { delete this; } return m_cRef; }  

正如上面提到的那样，在该组件定义文件中，我们定义了DLLEXPORT宏，所以导入头文件是这一部分

#define DLLFUNCTION _declspec(dllexport)

#define DLLINTERFACE extern "C" interface _declspec(dllexport)

#define DLLCLASS extern "C" class _declspec(dllexport) 

当用这些宏来修饰函数时，表明这是dllexport 的即是定义函数。

guids.cpp

#include "query.h" // {059E203E-A5D6-42D3-9D67-BBD1705B6999} extern "C" const IID IID_IX = { 0x59e203e, 0xa5d6, 0x42d3, { 0x9d, 0x67, 0xbb, 0xd1, 0x70, 0x5b, 0x69, 0x99 } }; // {9D00F6E4-C2C0-4DE8-8767-5F81409C617D} extern "C" const IID IID_IY = { 0x9d00f6e4, 0xc2c0, 0x4de8, { 0x87, 0x67, 0x5f, 0x81, 0x40, 0x9c, 0x61, 0x7d } }; // {DAADF8D2-8D8D-4908-8F55-D4E930DCD73E} extern "C" const IID IID_IZ = { 0xdaadf8d2, 0x8d8d, 0x4908, { 0x8f, 0x55, 0xd4, 0xe9, 0x30, 0xdc, 0xd7, 0x3e } }; 

这一部分是定义IID，通过guidgen工具生成，没有什么需要解释的。

编译生成query.dll,query.lib,query.h文件可以将这几个文件copy到你自己新建的一个文件夹下面，并将这个文件夹添加到系统路径中，并导入客户端使用时导入query.lib.

 

客户端

 

test.cpp

 

#include<iostream> #include <objbase.h> #include <query.h> #include <create.h> using std::endl; using std::cout; int main() { OleInitialize(NULL); HRESULT hr; trace("Client: Get an IUnkown pointer."); //::CoCreateInstance(CLSID_Componet1) IUnknown* pIUknown=CreateInstance(); //IUnknown* pIUknown=CallCreateInstance("querylink.dll"); trace("Client: Get interface IX: "); IX* pIx=NULL; hr=pIUknown->QueryInterface(IID_IX,(void**)&pIx); if(SUCCEEDED(hr)) { trace("Client: Succeed in getting IX."); pIx->Fx(); pIx->Release(); } trace("Client: Get interface IY: "); IY* pIy=NULL; hr=pIUknown->QueryInterface(IID_IY,(void**)&pIy); if(SUCCEEDED(hr)) { trace("Client: Succeed in getting IY."); pIy->Fy(); pIy->Release(); } trace("Client: Get interface IZ: "); IZ* pIz=NULL; hr=pIUknown->QueryInterface(IID_IZ,(void**)&pIz); if(SUCCEEDED(hr)) { trace("Client: Succeed in getting IZ."); pIz->Fz(); pIz->Release(); } pIUknown->Release(); OleUninitialize(); return 0; } 

 

需要解释的是create.h文件现在可以不用导入，这是后来新增的。这样子就是一个简单的使用com组件的例子。

 

再进一步解释一下create.h文件。

 

其实这是另外定义了一个组件导入函数，这样子就可以方便地通过制定的dll导入需要的组件真正实现动态链接的功能，其定义在另一个dll中。

create.h

 

#ifndef CREATE_H_ #define CREATE_H_ #ifdef DLLEXPORT #define DLLFUNCTION extern "C" _declspec(dllexport) #define DLLINTERFACE extern "C" interface _declspec(dllexport) #define DLLCLASS extern "C" class _declspec(dllexport) #else #define DLLFUNCTION extern "C" _declspec(dllimport) #define DLLINTERFACE extern "C" interface _declspec(dllimport) #define DLLCLASS extern "C" class _declspec(dllimport) #endif //extern "C" DLLFUNCTION IUnknown* CallCreateInstance(char* name); //typedef IUnknown* (*CREATEFUNPTR)(); DLLFUNCTION IUnknown* CallCreateInstance(char* name); #endif 

create.cpp

 

#define DLLEXPORT #include<iostream> #include<unknwn.h> #include "create.h" typedef IUnknown* (*CREATEFUNPTR)(); IUnknown* CallCreateInstance(char* name) { HINSTANCE hComponent=LoadLibrary(name); std::cout<<"CallCreateInstance Begin: "<<std::endl; if(hComponent==NULL) { std::cout<<"CallCreateInstance:/tERROR Can't Load Component"<<std::endl; return NULL; } CREATEFUNPTR CreateInstance=(CREATEFUNPTR)::GetProcAddress(hComponent,"CreateInstance"); if(CreateInstance==NULL) { std::cout<<"CallCreateInstance:/tERROR Can't Find CreateInstance function"<<std::endl; return NULL; } std::cout<<"CallCreateInstance SUCCEED: "<<std::endl; return CreateInstance(); }  

按上面说过的同样的方式处理create.dll,create.lib和create.h就可以如同test.cpp中注释掉的IUnknown* pIUknown=CallCreateInstance("querylink.dll");了。

当然由于没有将编写好的组件添加到注册表中，并不能像真正的组件哪像使用，后面我将会给出如何注册一个自己编写的组件。