COM学习(一)——COM基础思想
概述
学习微软技术COM是绕不开的一道坎,最近做项目的时候发现有许多功能需要用到COM中的内容,虽然只是简单的使用COM中封装好的内容,但是许多代码仍然只知其然,不知其所以然,所以我决定从头开始好好学习一下COM基础的内容,因此在这记录下自己学习的内容,以便日后参考,也给其他朋友提供一点学习思路。
COM的全称是Component Object Module,组件对象模型。组件就我自己的理解就是将各个功能部分编写成可重用的模块,程序就好像搭积木一样由这些可重用模块构成,这样将各个模块的耦合降到最低,以后升级修改功能只需要修改某一个模块,这样就大大降低了维护程序的难度和成本,提高程序的可扩展性。COM是微软公司提出的组件标准,同时微软也定义了组件程序之间进行交互的标准,提供了组件程序运行所需的环境。
COM是基于组件化编程的思想,在COM中每一个组件成为一个模块,它可以是动态链接库或者可执行文件,一个组件程序可以包含一个或者多个组件对象,COM对象不同于OOP(面向对象)中的对象,COM对象是定义在二进制机器代码基础之上,是跨语言的。而OOP中的对象是建立在语言之上的。脱离了语言对象也就不复存在.COM是独立在编程语言之上的,是语言无关的。COM的这一特性使得不同语言开发的组件之间的互相交互成为可能。
COM对象和接口
COM中的对象类似于C++中的对象,对象是某个类中的实例。而类则是一组相关的数据和功能组合在一起的一个定义。使用对象的应用(或另一个对象)称为客户,有时也称为对象的用户。
接口是一组逻辑相关的函数的集合,比如一组处理URL的接口,处理HTTP请求的接口等等。在习惯上接口通常是以”I”开头。对象通过接口成员函数为客户提供各种形式的服务。一个对象可以拥有多个不同的接口,以表现不同的功能集合。 在C++语言中,一个接口就是一个虚基类,而对象就是该接口的实现类,派生自该接口并实现接口的功能。
class IBook
{
public:
virtual void NextPage() = 0;
virtual void ForwardPage() = 0;
}
class IAppliances
{
public:
virtual void charge() = 0;
virtual void shutdown() = 0;
}
class CKindle: public IBook, IAppliances
{
public:
virtual void NextPage();
virtual void ForwardPage();
virtual void charge();
virtual void shutdown();
}
就像上面的例子,上面的例子中提供了一个书本的接口,书本可以翻到上一页,下一页,而电器有充电和关机的接口,最后我们利用kindle这个类来实现这两个接口。所以在使用上我们可以利用下面的伪代码来使用
pInterface = CreateInterface(ID_IBOOK, ID_KINDLE);
pInterface->NextPage();
if(Late())
{
pInter2 = pInterface->QueryInterface(ID_APPLIANCES);
pInter2->shutdown();
}
在平时我们使用kindle的翻页功能来看书,因为翻页功能在接口IBook,所以首先调用一个创建接口的函数,传入对应接口以及接口实现类的标识,用来生成相应的接口,其实在内部也就是根据类ID来创建一个对应的实现类的实例。然后根据需要转化为对应基类的指针。在看书看累的时候,将接口转化为电子产品的接口,调用对应的关机功能,关闭电子书。在之后比如说kindle进行了升级,也就是重写了实现这些接口的代码,但是接口原型不变,这样使用接口的代码不用改变,也就是说即使kindle对内部进行了升级,优化某些功能,用户在使用上仍然是那样在用,不必改变使用习惯。再比如kindle出了一个新款,提供了背光功能,这个时候可能提供一个新接口:
class IAppliances2 : public IAppliances
{
public:
virtual void Light() = 0;
}
然后只需要稍微更新一下CKindle这个实现类,新增一个Light接口的实现,在使用上如果不用背光功能原来的代码就够用了,如果要使用背光功能,只需要将原来的接口类型改为IAppliances2 ,并且添加调用背光功能的函数,而其余的功能也不变,这与实际生活相似,某个产品提供新功能时,一般保持原始功能的使用方法不变,新功能会有新的按钮或者其他方法进行打开。
再比如说我不想用kindle了改用其他的电子阅读器,只要接口不变,我的使用方法基本不变,唯一改变的可能是我以前拿着kindle,现在拿着其他品牌的阅读器,也就是说可能要改变传入CreateInterface函数中的类标识。
COM基本接口
COM中所有接口都派生自该接口:
struct IUnknown
{
virtual HRESULT QueryInterface(REFIID riid,void **ppvObject) = 0;
virtual ULONG AddRef( void) = 0;
virtual ULONG Release( void) = 0;
};
所有类都应该实现上述三个方法,AddRef主要将接口的引用计数+1, 而Release则是将引用计数 -1,当对象的引用计数为0,则会调用析构函数,释放对象的存储空间。每一次接口的创建和转化都会增加引用计数,而每次不再使用调用Release,都会把引用计数 -1,当引用计数为0时会释放对象的空间。
QueryInterface主要用来进行接口转化,将对象的指针转化为另外一个接口的指针,就好像上面例子中pInter2 = pInterface->QueryInterface(ID_APPLIANCES);这句代码将之前的Ibook接口转化为电子产品的接口。在C++中也就是做了一次强制类型转化。
对象和接口的唯一标识
在COM中,对象本身对于客户来说是不可见的,客户请求服务时,只能通过接口进行。每一个接口都由一个128位的全局唯一标识符(GUID,Global Unique Identifier)来标识。客户通过GUID来获得接口的指针,再通过接口指针,客户就可以调用其相应的成员函数。与接口类似,每个组件也用一个 128 位 GUID 来标识,称为 CLSID(class identifer,类标识符或类 ID),用 CLSID 标识对象可以保证(概率意义上)在全球范围内的唯一性。
实际上,客户成功地创建对象后,它得到的是一个指向对象某个接口的指针,因为 COM 对象至少实现一个接口(没有接口的 COM 对象是没有意义的),所以客户就可以调用该接口提供的所有服务。根据 COM 规范,一个 COM 对象如果实现了多个接口,则可以从某个接口得到该对象的任意其他接口。
由此可看出,客户与 COM 对象只通过接口打交道,对象对于客户来说只是一组接口。
在COM中GUID的定义如下:
typedef struct _GUID {
unsigned long Data1;
unsigned short Data2;
unsigned short Data3;
unsigned char Data4[ 8 ];
} GUID;
一般我们在程序中只是作为一个标志来使用,并不对它进行特别的操作。生成它一般是使用VS自带的GUID生成工具。
而CLSID的定义如下:
typedef GUID CLSID;
其实在COM中一般涉及到ID的都是GUID,只是利用typedef另外定义了一个名称而已
另外COM也提供了一组函数用来对GUID进行操作:
函数 | 功能 |
---|---|
IsEqualGUID | 判断GUID是否相等 |
IsEqualCLSID | 判断CLSID是否相等 |
IsEqualIID | 判断IID是否相等 |
CLSIDFromProgID | 把字符串形式的CLSID转化为CLSID结构形式(类似于将字符串的234转化为数字,也是把字面上的CLSID转化为计算机能识别的CLSID) |
StringFromCLSID | 把CLSID转化为字符串形式 |
IIDFromString | 把字符串形式的IID转化为IID接口形式 |
StringFromIID | 把IID结构转化为字符串 |
StringFromGUID2 | 把GUID形式转化为字符串形式 |
COM接口的一般使用步骤
一般使用COM中的时候首先使用CoInitialize初始化COM环境,不用的时候使用CoUninitialize卸载COM环境,在使用接口中一般需要进行下面的步骤
1. 调用CoCreateInstance函数传入对应的CLSID和对应的IID,生成对应对象并传入相应的接口指针。
2. 使用该指针进行相关操作
3. 调用接口的QueryInterface函数,转化为其他形式的接口
4. 在最后分别调用各个接口的Release函数,释放接口
下面提供一个小例子,以供参考,也方便更好的理解COM
//组件部分
extern "C" __declspec(dllexport) void __stdcall ComCreateObject(GUID clsID, GUID interfaceID, void** pObj);
void __stdcall ComCreateObject(GUID clsID, GUID interfaceID, void** pObj)
{
if (clsID == CLSID_COMSTRING)
{
CComString *pComObject = new CComString;
*pObj = pComObject->QueryInterface(interfaceID);
}
}
class IComBase
{
public:
virtual void* QueryInterface(GUID gInterfaceId) = 0;
virtual void AddRef() = 0;
virtual void Release() = 0;
};
static const GUID IID_ICOMSTRING = { 0xb2fcd22c, 0x63fa, 0x4f61, { 0xbf, 0x12, 0xd3, 0xd2, 0x5a, 0x99, 0x59, 0x24 } };
class IComString : public IComBase
{
public:
virtual void Init(LPCTSTR pStr) = 0;
virtual int Find(LPCTSTR lpSubStr) = 0;
virtual int GetLength() = 0;
};
static const GUID CLSID_COMSTRING = { 0xf57f3489, 0xff2d, 0x4c97, { 0xb1, 0xf6, 0xc, 0x60, 0x7e, 0xf7, 0xae, 0xfc } };
class CComString : public IComString
{
public:
virtual void* QueryInterface(GUID gInterfaceId);
virtual void AddRef();
virtual void Release();
virtual void Init(LPCTSTR pStr);
virtual int Find(LPCTSTR lpSubStr);
virtual int GetLength();
protected:
int m_nCnt = 0;
CString m_csString;
};
//cpp
void* CComString::QueryInterface(GUID gInterfaceId)
{
if (gInterfaceId == IID_ICOMSTRING)
{
//该接口的引用计数+1
AddRef();
return dynamic_cast<IComString*>(this);
}
//如果它还实现了其他接口,可以再写判断,生成其他类型的接口
return NULL;
}
void CComString::AddRef()
{
m_nCnt++;
}
void CComString::Release()
{
m_nCnt--;
//引用计数为0,此时没有该类的接口被使用,应该释放该类
if (m_nCnt == 0)
{
delete this;
}
}
void CComString::Init(LPCTSTR pStr)
{
m_csString = pStr;
}
int CComString::Find(LPCTSTR lpSubStr)
{
return m_csString.Find(lpSubStr);
}
int CComString::GetLength()
{
return m_csString.GetLength();
}
这些代码被封装在一个dll中,dll中导出一个函数ComCreateObject,外部在使用时调用该函数传入对应的ID,以便生成对应的接口。
在这个dll里面提供一个接口的基类IComBase,这个是仿照了COM种的IUnknow基类,另外定义了一个IComString字符串的接口,同时定义了它的实现类CComString,为了简单,它的功能方法我直接使用了一个CString类实现。
在函数ComCreateObject,会根据传入对应的类ID,来生成对应的类实例,然后调用实例的QueryInterface,转化成对应的接口,在实现类中实现了这个方法,实现类中的QueryInterface方法主要完成了类型转化并将引用计数+1。
而Release函数在每次-1的时候会进行判断,当引用计数为0时销毁该类的实例
由于类是new出来创建在堆上的,所以每次用完一定要记得调用Release释放,否则会造成内存泄露
注意:在使用这里使用的是dynamic_cast进行类型转化,在进行类的强制类型转化时,特别是在有多重继承的情况下,最好使用dynamic_cast方式进行转化,当一个类拥有多个基类时,类中有多个虚函数表,为了能正常找到对应的虚函数表,就需要进行对应的偏移量的计算,C中的强制类型转化是直接将对象的首地址进行转化,这样在寻址虚函数表时可能会出错。而dynamic_cast会进行对应的计算。详细情形请参考这里
在使用上
void ComInitialize();
void ComUninitialize();
typedef void(__stdcall *pfnCreateInstance)(GUID, GUID, void**);
pfnCreateInstance CreateInstance;
HMODULE hComDll = NULL;
int _tmain(int argc, _TCHAR* argv[])
{
ComInitialize();
IComString *pIString = NULL;
CreateInstance(CLSID_COMSTRING, IID_ICOMSTRING, (void**)&pIString);
pIString->Init(_T("Hello World"));
IComString* pIString2 = (IComString*)(pIString->QueryInterface(IID_ICOMSTRING));
int nLength = pIString2->GetLength();
int iPos = pIString2->Find(_T("World"));
printf("%d, %d\n", nLength, iPos);
pIString->Release();
pIString2->Release();
return 0;
}
void ComInitialize()
{
hComDll = LoadLibrary(_T("ComInterface.dll"));
if (NULL != hComDll)
{
CreateInstance = (pfnCreateInstance)GetProcAddress(hComDll, "ComCreateObject");
}
}
void ComUninitialize()
{
FreeLibrary(hComDll);
}
给使用者使用时只需要提供对应类和接口的GUID,然后将函数ComCreateObject原型提供给调用者,以便生成对应的接口。
这里为了模仿COM的使用定义了ComInitialize和ComUninitialize这两个函数,真实的初始化函数怎么写的,我也不知道,在这里只是为了模仿COM的使用。
至此相信各位小伙伴应该对COM有了一个初步的了解