前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >COM学习(三)——COM的跨语言

COM学习(三)——COM的跨语言

作者头像
Masimaro
发布2019-02-25 17:22:05
1.7K0
发布2019-02-25 17:22:05
举报

COM是基于二进制的组件模块,从设计之初就以支持所有语言作为它的一个目标,这篇文章主要探讨COM的跨语言部分。

idl文件

一般COM接口的实现肯定是以某一具体语言来实现的,比如说使用VC++语言,这就造成了一个问题,不同的语言对于接口的定义,各个变量的定义各不相同,如何让使用vc++或者说Java等其他语言定义的接口能被别的语言识别?为了达到这个要求,定义了一种文件格式idl——(Interface Definition Language)接口定义语言,IDL提供一套通用的数据类型,并以这些数据类型来定义更为复杂的数 据类型。一般来说,一个文件有下面几个部分说明

  1. 接口的定义
  2. 组件库的定义
  3. 实现类的定义 而各个部分又包括他们的属性定义,以及函数成员的定义 属性: 属性是在接口定义的上方,使用“[]”符号包裹,一般在属性中使用下面几个关键字: object:标明该部分是一个对象(可以理解为c++中的对象,包括接口和具体的实现类) uuid:标明该部分的GUID version:该部分的版本 接口定义 接口定义采用关键字interface,接口函数定义在一对大括号中,它的定义与类的定义相似,其中函数定义需要修饰函数各个参数的作用,比如使用in 表示它作为输入参数,out表示作为输出参数,retval表示该参数作为返回值,一般在VC++定义的接口中,函数返回值为HRESULT,但是需要返回一个值供外界调用,此时就使用输出参数并加上retval表示它将在其他语言中作为函数的返回值。 组件库定义 库使用library关键字定义,在定义库的时候,它的属性一般定义GUID和版本信息,而在库中通常定义库中的实现类的相关信息,库中的信息也是写在一对大括号中 实现类的定义 接口实现类使用关键字coclass,接口类的属性一般定义一个object,一个GUID,然后一般定义实现类不需要向在C++中那样定义它的各个接口,各个数据成员,只需要告知它实现哪些接口即可,也就是说它继承自哪些接口。 下面是一个具体的例子:
代码语言:javascript
复制
import "unknwn.idl";

[
    object,
    uuid(CF809C44-8306-4200-86A1-0BFD5056999E)
]
interface IMyString : IUnknown
{
    HRESULT Init([in] BSTR bstrInit);
    HRESULT GetLength([out, retval] ULONG *pretLength);
    HRESULT Find([in] BSTR bstrFind, [out, retval] BSTR* bstrSub);
};

[
    uuid(ADF50A71-A8DD-4A64-8CCA-FFAEE2EC7ED2),
    version(1.0)
]
library ComDemoLib 
{
    importlib("stdole32.tlb");
    [
        uuid(EBD699BA-A73C-4851-B721-B384411C99F4)
    ]
    coclass CMyString
    {
        interface IMyString;
    };
};

上面的例子中定义了一个IMyString接口继承自IUnknown接口,函数参数列表中in表示参数为输入参数,out表示它为输出参数,retval表示该参数是函数的返回值。import导入了一个库文件类似于include。而importlib导入一个tlb文件,我们可以将其看成VC++中的#pragma comment导入一个lib库 从上面不难看出一个IDL文件至少有3个ID,一个是接口ID,一个是库ID,还有一个就是实现类的ID 在VC环境中通过midl命令可以对该文件进行编译,编译会生成下面几个我们在编写实现时会用到的重要文件:

  1. 一个.h文件:包含各个部分的声明,以及接口的定义
  2. 一个_i.c文件:包含各个部分的定义,主要是各个GUI的定义

需要实现的导出函数

一般我们需要在dll文件中导出下面几个全局的导出函数:

代码语言:javascript
复制
STDAPI DllRegisterServer(void);
STDAPI DllUnregisterServer(void);
STDAPI DllGetClassObject(const CLSID & rclsid, const IID & riid, void ** ppv);
STDAPI DllCanUnloadNow(void);

其中DllRegisterServer用来向注册表中注册模块的相关信息,主要注测在HKEY_CLASSES_ROOT中,主要定义下面几项内容:

  1. 字符串名称项,该项中包含一个默认值,一般给组件的字符串名称;CLSID子健,一般给实现类的GUID;CurVer子健一般是子健的版本
  2. 以版本字符串为键的注册表项,该项中主要保存:默认值,当前版本的项目名称;CLSID当前版本库的实现类的GUID
  3. 在HKEY_CLASSES_ROOT/CLSID子健中注册以实现类GUID字符串为键的注册表项,里面主要包含:默认值,组件字符串名称;InprocServer32,组件所在模块的全路径;ProgID组件名称;TypeLib组件类型库的ID,也就是在定义IDL文件时,定义的实现库的GUID。 下面是具体的定义:
代码语言:javascript
复制
const TCHAR *g_RegTable[][3] = {
    { _T("CLSID\\{EBD699BA-A73C-4851-B721-B384411C99F4}"), 0, _T("FirstComLib.MyString")}, //组件ID
    { _T("CLSID\\{EBD699BA-A73C-4851-B721-B384411C99F4}\\InprocServer32"), 0, (const TCHAR*)-1 }, //组建路径
    { _T("CLSID\\{EBD699BA-A73C-4851-B721-B384411C99F4}\\ProgID"), 0, _T("FirstComLib.MyString")}, //组件名称
    { _T("CLSID\\{EBD699BA-A73C-4851-B721-B384411C99F4}\\TypeLib"), 0, _T("{ADF50A71-A8DD-4A64-8CCA-FFAEE2EC7ED2}") }, //类型库ID
    { _T("FirstComLib.MyString"), 0, _T("FirstComLib.MyString") }, //组件的字符串名称
    { _T("FirstComLib.MyString\\CLSID"), 0, _T("{EBD699BA-A73C-4851-B721-B384411C99F4}")}, //组件的CLSID
    { _T("FirstComLib.MyString\\CurVer"), 0, _T("FirstComLib.MyString.1.0") }, //组件版本
    { _T("FirstComLib.MyString.1.0"), 0, _T("FirstComLib.MyString") }, //当前版本的项目名称
    { _T("FirstComLib.MyString.1.0\\CLSID"), 0, _T("{EBD699BA-A73C-4851-B721-B384411C99F4}")} //当前版本的CLSID
};

使用上一篇博文的代码,来循环注册这些项即可 DllGetClassObject:该函数用来生成对应的工厂类,而工厂类负责产生对应接口的实现类。 DllCanUnloadNow:函数用来询问是否可以卸载对应的dll,一般在COM中有两个全局的引用计数,用来记录当前内存中有多少个模块中的类,以及当前有多少个线程在使用它,如果当前没有线程使用或者存在的对象数为0,则可以卸载

实现类的定义

实现部分的整体结构图如下:

类图
类图

由于所有类都派生自IUnknown,所在在这里就不显示这个基类了。 每个实现类都对应了一个它具体的类工厂,而项目中CMyString类的类厂的定义如下:

代码语言:javascript
复制
class CMyClassFactory : public IClassFactory
{
public:
    CMyClassFactory();
    ~CMyClassFactory();

    STDMETHOD(CreateInstance)(IUnknown *pUnkOuter, REFIID riid, void **ppvObject);
    STDMETHOD(LockServer)(BOOL isLock);

    STDMETHOD(QueryInterface)(REFIID riid, void **ppvObject);
    STDMETHOD_(ULONG, AddRef)(void);
    STDMETHOD_(ULONG, Release)(void);

protected:
    ULONG m_refs;
};

STDMETHOD宏展开如下:

代码语言:javascript
复制
#define STDMETHOD(method) virtual HRESULT __stdcall method

所以上面的代码展开后就变成了:

代码语言:javascript
复制
virtual HRESULT __stdcall CreateInstance((IUnknown *pUnkOuter, REFIID riid, void **ppvObject);

另外3个派生自IUnknown接口就没什么好说的,主要说说另外两个: CreateInstance:主要用来生成对应的实现类,然后再调用实现类——CMyString的QueryInterface函数生成对应的接口 LockServer:当前是否被锁住:如果传入的值为TRUE,则表示被锁住,对应的锁计数器+1, 否则 -1 至于CMyString类的代码与之前的大同小异,也就没什么说的。 其他语言想要调用,以该项目为例,一般会经历下面几个步骤:

  1. 调用对应语言提供的产生接口的函数,该函数参数一般是传入一个组件的字符串名称。如果要引用该项目中的组件则会传入FirstComLib.MyString
  2. 在注册表的HKEY_CLASSES_ROOT\组件字符串名\CLSID(比如HKEY_CLASSES_ROOT\FirstComLib.MyString\CLSID)中找到对应的CLSID值
  3. 在HKEY_CLASSES_ROOT\CLSID\对应ID\InprocServer32(CLSID\{EBD699BA-A73C-4851-B721-B384411C99F4}\InprocServer32)位置处找到对应模块的路径
  4. 加载该模块
  5. 根据IDL文件告知其他语言里面存在的接口,由语言调用对应的创建接口的函数创建接口
  6. 调用模块的导出函数DllGetClassObject将查询到的CLSID作为第一个参数,并将接口ID作为第二个参数传入,得到一个接口 6.后面根据idl文件中的定义,直接调用接口中提供的函数 真实ATLCOM项目的解析 最后来看看一个正式的ATLCOM项目里面的内容,来复习前面的内容,首先通过VC创建一个ATLCOM的dll项目 在项目上右键-->New Atl Object,输入接口名称,IDE会根据名称生成一个对应的接口,还是以MyString接口为例,完成这一步后,整个项目的类结构如下:
项目类结构图
项目类结构图

这些全局函数的作用与之前的相同,它里面多了一个_Module的全局对象,该对象类似于MFC中的CWinApp类,它用来表示整个项目的实例,里面封装了对于引用计数的管理,以及对项目中各个接口注册信息的管理,所以看DllRegisterServer等函数就会发现它们里面其实很简单,大部分的工作都由_Module对象完成。 整个IDL文件的定义如下:

代码语言:javascript
复制
import "oaidl.idl";
import "ocidl.idl";
    [
        object,
        uuid(E3BD0C14-4D0C-48F2-8702-9F8DBC96E154),
        dual,
        helpstring("IMyString Interface"),
        pointer_default(unique)
    ]
    interface IMyString : IDispatch
    {
    };

[
    uuid(A61AC54A-1B3D-4D8E-A679-00A89E2CBE93),
    version(1.0),
    helpstring("FirstAtlCom 1.0 Type Library")
]
library FIRSTATLCOMLib
{
    importlib("stdole32.tlb");
    importlib("stdole2.tlb");

    [
        uuid(11CBC0BE-B2B7-4B5C-A186-3C30C08A7736),
        helpstring("MyString Class")
    ]
    coclass MyString
    {
        [default] interface IMyString;
    };
};

里面的内容与上一次的内容相差无几,多了一个helpstring属性,该属性用于产生帮助信息,当使用者在调用接口函数时IDE会将此提示信息显示给调用者。 由于有系统框架给我们做的大量的工作,我们再也不用关心像引用计数的问题,只需要将精力集中在编写接口的实现上,减少了不必要的工作量。

至此从结构上说明了为了实现跨语言COM组件内部做了哪些工作,当然只有这些工作是肯定不够的,后面会继续说明它所做的另一块工作——提供的一堆通用的变量类型。

本文参与?腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2017-10-30 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客?前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与?腾讯云自媒体分享计划? ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • idl文件
  • 需要实现的导出函数
  • 实现类的定义
相关产品与服务
日志服务
日志服务(Cloud Log Service,CLS)是腾讯云提供的一站式日志服务平台,提供了从日志采集、日志存储到日志检索,图表分析、监控告警、日志投递等多项服务,协助用户通过日志来解决业务运维、服务监控、日志审计等场景问题。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档
http://www.vxiaotou.com