Create COM step by step 2.
第七步 实现IClassFactory的方法
实现类CAddFactory的方法。创建一个新文件(AddObjFactory.cpp)。提供类IUnknown和IClassFactory的方法实现。AddRef,Release和QueryInterface方法实现和前面类CAddObj中这三个函数实现基本一样。在方法CreateInstance中,类CaddObj被实例化并且传回其接口指针。LockServer方法没有给出细节的实现。
HRESULT __stdcall CAddFactory::CreateInstance(IUnknown* pUnknownOuter,
const IID& iid,
void** ppv)
{
//
//This method lets the client manufacture components en masse
//The class factory provides a mechanism to control the way
//the component is created. Within the class factory the
//author of the component may decide to selectivey enable
//or disable creation as per license agreements
//
//
// Cannot aggregate.
if (pUnknownOuter != NULL)
{
return CLASS_E_NOAGGREGATION ;
}
//
// Create an instance of the component.
//
CAddObj* pObject = new CAddObj ;
if (pObject == NULL)
{
return E_OUTOFMEMORY ;
}
//
// Get the requested interface.
//
return pObject->QueryInterface(iid, ppv) ;
}
HRESULT __stdcall CAddFactory::LockServer(BOOL bLock)
{
return E_NOTIMPL;
}
/////////////////////////////////////////////////////////////////
第八步 实现DllGetClassObject的方法
一个进程内COM对象只是一个简单的WIN32DLL,他遵循既定的协议。每一个COM DLL必须有一个通过名字DllGetClassObject的出口函数。客户端将调用这个函数以得到类厂的接口(IUnknown or IClassFactory),之后就是调用CreateInstance方法。创建一个新文件(Exports.cpp),在其中实现DllGetClassObject。(代码如下)
STDAPI DllGetClassObject(const CLSID& clsid,
const IID& iid,
void** ppv)
{
//
//Check if the requested COM object is implemented in this DLL
//There can be more than 1 COM object implemented in a DLL
//
if (clsid == CLSID_AddObject)
{
//
//iid specifies the requested interface for the factory object
//The client can request for IUnknown, IClassFactory,
//IClassFactory2
//
CAddFactory *pAddFact = new CAddFactory;
if (pAddFact == NULL)
return E_OUTOFMEMORY;
else
{
return pAddFact->QueryInterface(iid , ppv);
}
}
//
//if control reaches here then that implies that the object
//specified by the user is not implemented in this DLL
//
return CLASS_E_CLASSNOTAVAILABLE;
}
/////////////////////////////////////////////////////////////////
第九步 实现DllCanUnloadNow
客户需要知道什么时候COM DLL可以被从内存中卸载。更进一步,一个进程内COM对象显示的通过调用API函数LoadLibrary装入内存中的客户程序的进程空间中。这个显示装载的DLL也可以使用FreeLibrary卸载。COM客户必须知道什么时候DLL可以被安全的卸载。一个客户必须确定没有任何来自于特别是DLL中的COM对象的实例仍在生命期中。要使得这个可以被简单的计算,在一个COM DLL中,我们在类CAddObj和CAddFactory的构造函数中自加一个全局变量(g_nComObjsInUse)。类似的,在析构函数中,自减这个全局变量。
我们输出另一个COM规定的函数:DllCanUnloadedNow,实现如下:
STDAPI DllCanUnloadNow()
{
//
//A DLL is no longer in use when it is not managing any existing objects
// (the reference count on all of its objects is 0).
//We will examine the value of g_nComObjsInUse
//
if (g_nComObjsInUse == 0)
{
return S_OK;
}
else
{
return S_FALSE; }
}
第十步 DllRegisterServer 和 UnregisterServer
COM对象的位置信息将会进入到注册表中。这个工作可以在外面通过一个.REG文件完成,也可以使用一个输出函数DllRegisterServer。要去除注册表的内容,我们将使用另一个输出函数DllUnregisterServer。这两个函数的实现在文件Registry.cpp中。一个简单的工具regsrv32.exe也可以用来装入一个指定的DLL并执行DllRegisterServer/DllUnregisterServer。
要使得连接器输出这两个函数,我们将创建一个模块定义文件(Exports.def)
;
;contains the list of functions that are being exported from this DLL
;
DESCRIPTION "Simple COM object"
EXPORTS
DllGetClassObject PRIVATE
DllCanUnloadNow PRIVATE
DllRegisterServer PRIVATE
DllUnregisterServer PRIVATE
第十一步
我们下面就给出最后完成我们AddObj Win32 DLL工程的绝技。将文件IAdd.idl插入到工程工作空间中。
为了在每一次编译完成后执行regsrv32.exe,在"Post-bulid step"对话框中插入一个命令串如下图示:
编译这个DLL。将IDL文件插入到工程中是为了减少每一次文件被编辑后必须要执行外部编译。每次我们成功的编译我们的工程,这个COM对象就会被注册。
第十二步 在Visual Basic 中使用COM刚创建的对象
要从Visual Basic中使用AddObj COM 对象,创建一个简单的EXE工程,添加如下的代码。确定已经添加了对IAdd.tlb模板库的一个对象的引用。
Dim iAdd As CodeGuruMathLib.iAdd
Set iAdd = CreateObject("CodeGuru.FastAddition")
iAdd.SetFirstNumber 100
iAdd.SetSecondNumber 200
MsgBox "total = " & iAdd.DoTheAddition()
第十三步 分析我们刚创建的所有文件
如下是我们曾使用过的文件
IAdd.idl |
接口定义文件的内容 |
AddObj.h |
包含类 CAddObj 声明 |
AddObjFactory.h |
包含类 CAddFactory 声明 |
AddObj.cpp |
包含类CAddObj 实现 |
AddObj.cpp |
包含类CAddFactory 实现 |
Exports.cpp |
包含DllGetClassObject,DllCanUnloadNow & DllMain 的实现 |
Registry.cpp |
包含r DllRegisterServer,DllUnregisterServer 的实现 |
AddObjGuid.h |
包含我们 AddObj COM 对象的GUID值 |
第十四步 在ActiveX DLL中嵌入类型库
随AddObj.dll一起,类型模板库也可以被发布。对于一个简单的进程,类型模板库IAdd.tlb可以作为二进制资源嵌入到AddObj.dll文件中。以后,仅仅将这个DLL文件AddObj.dll发布给客户就可以了。
第十五步 从Visual C++客户方使用刚创建的COM对象
通过如下的任一种方式,Visual C++客户可以使用这个COM接口
1、#import “IAdd.tlb”
2、IAdd.h头文件。在此情况下,这个DLL提供商必须将IAdd.h随DLL文件一起发布。
3、使用一些工具向导生成c++代码(例如,MFC类向导)
在第一种情况下,编译器创建一些中间文件(.TLH,.TLI),这些文件中含有扩展的接口声明。此外,编译器也可以声明根据接口建立(bulit around the raw interfaces)智能指针类。对于COM程序员来说,通过适当的管理COM对象的生存期,智能指针类使生存期更容易(控制)。
下面的例子中,#import 来输入AddObj.dll文件,而不是IAdd.tlb,因为我们把TLB文件放到了DLL中(译者注,前面提到的将类型库作为二进制资源放到DLL资源中)。此外,#import也应该使用TLB文件。
在Visual C++中,创建一个控制台EXE工程。键入(或拷贝)如下的内容并编译。
//
///Client.cpp
//
//Demo of client using the COM object from AddObj.dll
//
#include <objbase.h>
#include <stdio.h>
#import "AddObj.dll"
//
//Here we do a #import on the DLL ,you can also do a #import on the .TLB
//The #import directive generates two files (.tlh/.tli) in the output folders.
//
void main()
{
long n1 =100, n2=200;
long nOutPut = 0;
CoInitialize(NULL);
CodeGuruMathLib::IAddPtr pFastAddAlgorithm;
//
//IAddPtr is not the actual interface IAdd, but a template C++ class (_com_ptr_t)
//that contains an embedded instance of the raw IAdd pointer
//While destructing , the destructor makes sure to invoke Release() on the internal
//raw interface pointer. Further, the operator -> has been overloaded to direct all
//method invocations to the internal raw interface pointer.
//
pFastAddAlgorithm.CreateInstance("CodeGuru.FastAddition");
pFastAddAlgorithm->SetFirstNumber(n1);//"->" overloading in action
pFastAddAlgorithm->SetSecondNumber(n2);
nOutPut = pFastAddAlgorithm->DoTheAddition();
printf("\nOutput after adding %d & %d is %d\n",n1,n2,nOutPut);
}