COM(组件对象模型)简单介绍

最新推荐文章于 2024-04-25 21:16:15 发布

奔跑的兔子

最新推荐文章于 2024-04-25 21:16:15 发布

阅读量987

点赞数

文章标签： interface server methods mfc 语言 class

COM(组件对象模型)简单介绍

什么是COM？

简单地说，COM提供了一种在不同的应用程序和语言之间共享二进制代码的规范。COM定义了软件组件互相通讯的方式。它是一种二进制和网络标准，允许任意两个组件互相通讯，而不管它们是在什么计算机上运行（只要计算机是相连的），也不管计算机运行的是什么操作系统（只要该操作系统支持COM），也不管该组件是用什么语言编写的。COM还提供了位置透明性：当使用COM组件时，该组件是进程内Dll、本地exe还是位于其他机器上的组件，都无所谓。

为什么需要COM？

虽然可能有很多历史的原因，但是，我们仅从二进制代码共享的角度来看看，为什么要引入COM。

Windows可以使用DLLs在二进制级别共享代码，如kernel32.dll、user32.dll等。但是，这些dll都采用C接口，它们仅能被C语言或者能够理解C调用规范的语言使用。这从语言层次上限定了二进制代码的共享范围。

MFC有一种被称为MFC扩展DLL的共享机制。但是你只能在MFC应用程序中使用它们。

COM利用定义一个二进制规范来解决这些问题。使用COM编写的二进制模块必须匹配一些特定的数据结构。COM规范同样也定义COM对象在内存中应该如何被组织。这份二进制代码同样也不能依赖任何语言层面的特征。

COM对象的结构使用与C++虚函数相同的结构。所以很多COM使用C++编写，但是严格来说COM与编写该COM的语言是不想关的，因为最后的二进制代码可以被任何语言使用。

COM并不是Win32相关的，理论上，COM可以被移植到任何操作系统上，但是现实中COM依然只是Windows世界的东西。

COM基本术语

1.interface：一个接口可以看做是一组称为方法的函数。接口名以"I"打头，如"IShellLink"，在C++中，接口即是一个只含有纯虚函数的抽象基类。

2.coclass：component object class的简称。coclass用来实现接口。一个COM对象是coclass在内存中的一个实例（instance）。注意COM"class"跟 C++"class"不是一个东西，虽然COM class 的实现通常都是C++ class。

3.COM Server：含有一个或多个coclass的二进制模块（DLL或者EXE）。

4.Registration：向Windows注册，登记COM Server的位置和入口。Unregistration是一个相反的过程：从Windows中移除掉这个登记。

5.GUID：globally unique identifier。一个128位的数。COM使用语言无关的GUID作为标识。每一个interface和coclass都有一个GUID，因为 GUID是全世界范围内唯一的。所以避免了名字冲突。有时候GUID也被称为UUID（universally unique identifier）。一个coclass的class ID称为CLSID；一个interface的interfaceID称为IID。

6.HRESULT：一个整数类型的值，COM使用它来返回成功或者错误码。可以使用Windows错误码查询来获取HRESULT所代表的字符含义。

基接口（base interface）：IUnknown

每一个COM接口都要从IUnknown接口继承。IUnknown这个名字的含义是：如果你拥有一个指向IUnknown接口的COM对象指针，那个你无从知道它真正指向的对象是什么，因为COM中的每一个对象都实现了这个接口。

这个接口有三个方法：AddRef、Release和QueryInterface。其中QueryInterface用于在获取某个COM的一个接口指针后，查询该COM的其他接口指针。

HRESULT IUnknown::QueryInterface (

    REFIID iid,

    void** ppv );

使用COM

1.创建一个COM对象：C++中使用new操作符或者直接在栈上创建；创建COM对象则要调用COM library中的一个API（CoCreateInstance）。

2.删除COM对象：C++中，使用delete操作符或者在栈上的对象超出作用域以后会自动析构。但是在COM中，所有的对象拥有它们自己的引用计数（reference count）。调用者必须在使用完COM对象以后通知它（减少引用计数）。COM对象在引用计数到达0时，自动从内存中释放自己。

创建COM对象的函数原型如下：

HRESULT CoCreateInstance (

    REFCLSID  rclsid,

    LPUNKNOWN pUnkOuter,

    DWORD     dwClsContext,

    REFIID    riid,

    LPVOID*   ppv );

参数说明：

rclsid

coclass的CLSID。例如，你可以传递 CLSID_ShellLink 来创建一个用于创建快捷方式的COM对象。

pUnkOuter

只在使用聚合COM对象的时候有用。如果不是用，则传递NULL。

dwClsContext

指示我们希望使用什么类型的COM Server。这里我们使用最简单的一种Server，an in-process DLL，传递 CLSCTX_INPROC_SERVER。

riid

我们要使用的接口的IID。例如，传递 IID_IShellLink来得到 IShellLink interface的指针。

ppv

所请求的接口的指针地址。

当调用CoCreateInstance函数时，它查询注册表中的CLSID，读取COM server的位置，将其加载到内存中并创建函数所请求的coclass的一个实例。需要注意的是，在使用函数CoCreateInstance之前，确保你的程序已经初始化了COM library，并且需要在程序退出时卸载它，分别调用CoInitialize和CoUninitialize函数。

-----------------COM object create sample-------------------------------------------------------

HRESULT hr;
    IShellLink* pISL;
    hr = CoCreateInstance(CLSID_ShellLink,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IShellLink,
        (void*)&pISL);
    if (SUCCEEDED(hr))
    {
        pISL->Release();//just release.
    }
    else
    {
    }

---------------------------------------------------------------------------------------------------------

COM中的字符串操作

只要注意到COM中的字符串都是Unicode的，就应该没有问题的。习惯于使用Unicode并在与COM的交互中使用Unicode，就不会有任何问题。当使用ANSI时，需要自己处理Unicode与ANSI之间的转换。除了常规的转换方法外，ATL提供了几个宏处理这种转换：W2A()、 OLE2A()、OLE2CA()等。

一个完整的使用COM的样例代码通常如下，代码从参考文章中copy的：

------------------------------------------------------------------------------------------------------------------------

CString       sWallpaper = wszWallpaper;  // Convert the wallpaper path to ANSI

IShellLink*   pISL;

IPersistFile* pIPF;



    // 1. Initialize the COM library (make Windows load the DLLs). Normally you would

    // call this in your InitInstance() or other startup code.  In MFC apps, use

    // AfxOleInit() instead.

    CoInitialize ( NULL );



    2. Create a COM object, using the Shell Link coclass provided by the shell.

    // The 4th parameter tells COM what interface we want (IShellLink).

    hr = CoCreateInstance ( CLSID_ShellLink,

                            NULL,

                            CLSCTX_INPROC_SERVER,

                            IID_IShellLink,

                            (void**) &pISL );



    if ( SUCCEEDED(hr) )

        {

        // 3. Set the path of the shortcut's target (the wallpaper file).

        hr = pISL->SetPath ( sWallpaper );



        if ( SUCCEEDED(hr) )

            {

            // 4. Get a second interface (IPersistFile) from the COM object.

            hr = pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF );



            if ( SUCCEEDED(hr) )

                {

                // 5. Call the Save() method to save the shortcut to a file.  The

                // first parameter is a Unicode string.

                hr = pIPF->Save ( L"C://wallpaper.lnk", FALSE );



                // 6a. Release the IPersistFile interface.

                pIPF->Release();

                }

            }



        // 6b. Release the IShellLink interface.

        pISL->Release();

        }



    // Printing of error messages omitted here.



    // 7. Uninit the COM library.  In MFC apps, this is not necessary since MFC

    // does it for us.

    CoUninitialize();

------------------------------------------------------------------------------------------------------------------------

编写COM

下面看看一个最简单的COM server，进程内server（in-process server），需要如何编写。

要想能用COM lib来使用该COM server，首先必须做两件事情：

1.必须在注册表HKEY_CLASSES_ROOT/CLSID下注册自己；

2.必须导出一个称为DllGetClassObject的函数。

这是这个COM的最低配置。需要在该注册表项下创建一个以该GUID为名的键，该键下有包含一系列的键值，如COM的位置以及它的线程模型等。

一般情况下，COM还需要导出下面三个函数：

DllCanUnloadNow() : COM lib调用此函数以判断该server是否可以被卸载；
DllRegisterServer() : 由安装工具调用，像RegSvr32一样让server能够注册自身。

DllUnregisterServer() : 由卸载工具调用，用于卸载COM。

前面说道每一个接口都必须实现IUnknown接口，因为IUnknown接口包含了COM对象的两个基本特征：引用计数和接口查询。在写coclass时，也必须实现该接口。下面是一个简单的coclass：

-----------------------------------------------------------------------------------------------------------------------------

class CUnknownImpl : public IUnknown

{

public:

    // Construction and destruction

    CUnknownImpl();

    virtual ~CUnknownImpl();



    // IUnknown methods

    ULONG AddRef();

    ULONG Release)();

    HRESULT QueryInterface( REFIID riid, void** ppv );



protected:

    UINT m_uRefCount;  // object's reference count

};

HRESULT CUnknownImpl::QueryInterface ( REFIID riid, void** ppv )

{

HRESULT hrRet = S_OK;



    // Standard QI() initialization - set *ppv to NULL.

    *ppv = NULL;



    // If the client is requesting an interface we support, set *ppv.

    if ( IsEqualIID ( riid, IID_IUnknown ))

        {

        *ppv = (IUnknown*) this;

        }

    else

        {

        // We don't support the interface the client is asking for.

        hrRet = E_NOINTERFACE;

        }



    // If we're returning an interface pointer, AddRef() it.

    if ( S_OK == hrRet )

        {

        ((IUnknown*) *ppv)->AddRef();

        }



    return hrRet;

}

-----------------------------------------------------------------------------------------------------------------------------

在每一次实现一个coclass时，同时也需要写一个被称为class factory配对的类，该类用于创建这个coclass的实例。需要这个工厂类的原因是为了语言无关：COM本身不创建COM对象，因为那样的话就不是语言和实现无关的了。

当COM lib调用DllGetClassObject时，它传递COM客户端请求的CLSID，server创建代表这个CLSID的类工厂。工厂类（class factory）本身也是一个coclass，它实现了IClassFactory。当DllGetClassObject成功返回时，它返回给COM lib一个指向IClassFactory的指针，然后COM lib使用IClassFactory的方法来创建COM对象。

IClassFactory像下面这样：

struct IClassFactory : public IUnknown

{

    HRESULT CreateInstance( IUnknown* pUnkOuter, REFIID riid,

                            void** ppvObject );

    HRESULT LockServer( BOOL fLock );

};

在这之后我们需要用COM实现自己的功能，首先定义一个接口，接口里包含了我们自己的功能定义（记住，它必须实现IUnknown接口），例如：

struct ISimpleMsgBox : public IUnknown

{

    // IUnknown methods

    ULONG AddRef();

    ULONG Release();

    HRESULT QueryInterface( REFIID riid, void** ppv );



    // ISimpleMsgBox methods

    HRESULT DoSimpleMsgBox( HWND hwndParent, BSTR bsMessageText );

};



struct __declspec(uuid("{7D51904D-1645-4a8c-BDE0-0F4A44FC38C4}"))

                  ISimpleMsgBox;

注意到最后一行，__declspec表示将一个GUID分配给ISimpleMsgBox，然后我们可以使用__uuidof操作符来获取这个GUID，__declspec和__uuidof都是微软的C++扩展

（Microsoft C++ extensions）。

然后，你需要一个类来实现这个接口：

class CSimpleMsgBoxImpl : public ISimpleMsgBox  

{

public:

	CSimpleMsgBoxImpl();

	virtual ~CSimpleMsgBoxImpl();



    // IUnknown methods

    ULONG AddRef();

    ULONG Release();

    HRESULT QueryInterface( REFIID riid, void** ppv );



    // ISimpleMsgBox methods

    HRESULT DoSimpleMsgBox( HWND hwndParent, BSTR bsMessageText );



protected:

    ULONG m_uRefCount;

};



class  __declspec(uuid("{7D51904E-1645-4a8c-BDE0-0F4A44FC38C4}")) 

                  CSimpleMsgBoxImpl;

其他细节：与COM有关的宏

STDMETHOD()：包含了virtual关键字和HRESULT返回类型以及__stdcall调用约定。STDMETHOD_()与之相同，但是允许指定非HRESULT的返回值。

PURE：与C++中的"=0"效果相同，将一个函数声明为纯虚函数。

STDMETHODIMP：对应于STDMETHOD()的实现，相应地，STDMETHODIMP_()与STDMETHOD_()对应。

STDAPI：包含了返回类型和调用约定，由于STDAPI的扩展方式，使用了此宏以后不能再使用__declspec(dllexport)。可以使用".DEF"文件完成类似功能。

还有一些实现上的问题，就不多讲了，千言万语，都在代码里面:)。

本文完全基于下面两篇英文文章，作了一个简单的理解和翻译，代码也请到下面的链接地址里下载。

参考文章

http://www.codeproject.com/KB/COM/comintro.aspx#upd0722b

http://www.codeproject.com/KB/COM/comintro2.aspx

奔跑的兔子

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
COM(组件对象模型)简单介绍

COM(组件对象模型)简单介绍 <br />什么是COM？<br />简单地说，COM提供了一种在不同的应用程序和语言之间共享二进制代码的规范。COM定义了软件组件互相通讯的方式。它是一种二进制和网络标准，允许任意两个组件互相通讯，而不管它们是在什么计算机上运行（只要计算机是相连的），也不管计算机运行的是什么操作系统（只要该操作系统支持COM），也不管该组件是用什么语言编写的。COM还提供了位置透明性：当使用COM组件时，该组件是进程内Dll、本地exe还是位于其他机器上的组件，都无所
复制链接

扫一扫