向ATL DLL中传递C++对象

 
[ 翻译文档 本文适合中级读者 已阅读10013次 ] 文档 代码 工具
 

向ATL DLL中传递C++对象

原著:Uttam Kumar
翻译:王先生(MrWang2000)

下载源代码

原文出处:Passing C++ Object in ATL DLL

简介
  几个星期以前,我拼命的寻找一个能够通过COM接口传递C++对象的例子,但是,没有找到.这就是我发表这篇文章的原因。

  向ATL的DLL中传递一个C++对象参数并不是非常之难,但是,当然也会有点难度,也很有趣。

  在开始一个工程以前,首先你得确信客户机和服务器组件都是适应C++的程序,其次,你必须知道怎样设置你的客户机和服务器。

接口的局限性
  COM技术要求客户机和服务器高度的分离,这是通过接口实现的,但是问题出在:接口的方法中只提供了有限个参数数据类型,如果这个接口是基于IDispatch的,参数类型的可选范围就更加受到限制了,由于这些局限性,C++对象只有在满足以下条件时才能够传递:

  1. 客户机和服务器都是由VC++编写。
  2. 它们必须共享对象的定义(比如 头文件)。
  3. 传递应用程序设计的简单的对象。
  4. 你的应用程序可能需要运行在一个分布式环境下。你希望COM的远程活动,本地/远程活动是透明的,安全的。

我建议,在开始工作之前,先顺序的看一下各个标题,现在,我列出实例,并作以下事情:

  1. 创建一个ATL DLL服务器,
  2. 添加一个MFC类,从CObject类派生,
  3. 在类的头部使用 DECLARE_SERIAL 宏,
  4. 在类的中间使用 IMPLEMENT_SERI 宏,
  5. 覆盖Serialize() 方法,
    // 你的 CSimpleObj 类应该像这样:
    class CSimpleObj : public CObject
    {
    	  DECLARE_SERIAL( CSimpleObj )
    public:
    	// 构造函数和析构函数
    	  CSimpleObj();
    	  virtual ~CSimpleObj();
    	// 设置内部字符串数据
    	  void SetString( CString csData );
    	// 用来向存档文件串行输入数据(序列化)
    	  virtual void Serialize(CArchive& ar);
    	// 现实字符串数据
    	  void Show();
    private:
    	  CString m_strData;// 内部字符串数据
    };
    // 把这个数据对象写入到文档中
    void CSimpleObj::Serialize(CArchive& ar)
    {
    	  CObject::Serialize( ar );
    	if (ar.IsLoading())
    	{
    		// 从档案文件提取数据
    		  ar >> m_strData;
    	}
    	else
    	{
    		// 把数据存入档案文件
    		  ar << m_strData;
    	}
    }
    // 显示对象数据的方法
    void CSimpleObj::Show()
    {
    	  AfxMessageBox(m_strData);
    }
    //把字符串数据保存到一个变量中
    void CSimpleObj::SetString(CString csData)
    {
    	  m_strData = csData;
    }      
  6. 现在,下一步就是用一个CArchive对象来进行序列化和反序列化(载入和存储对象),我用了一个叫CBlob的新类来实现的
    class CBlob
    {
    public:
    	  CBlob() {};
    	  virtual ~CBlob() {};
    	// 从一个 CObject对象中提取数据并载入到一个 SAFEARRAY对象中.
    	  SAFEARRAY* Load( CObject *pObj );
    	// 重新创建一个SAFEARRAY对象
    	  BOOL Expand( CObject * &pObj, SAFEARRAY *pVar );
    private:
    };
    // 从一个 CObject对象中提取数据并用它构建一个 SAFEARRAY对象.
    SAFEARRAY* CBlob::Load( CObject *pObj)
    {
    	  CMemFile memfile; // 内存文件
    	// 定义一个用来标记档案文件是读取还是存储的标志
    	  long lMode = CArchive::store | CArchive::bNoFlushOndelete;
    	// 用内存文件创建档案文件
    	  CArchive ar(&memfile, lMode );
    	// m_pDocument 不使用
    	  ar.m_pDocument = NULL;
    	// 序列化对象到档案文件中
    	  ar.WriteObject(pObj);
    	// 关闭档案文件--现在,数据在内存文件中
    	  ar.Close();
    	// 取得内存文件的长度(以字节为单位)
    	  long llen = memfile.GetLength();
    	// 释放缓冲区 关闭文件
    	  unsigned char *pMemData = memfile.Detach();
    	// 设定safearray
    	  SAFEARRAY *psa;
    	// 创建safearray对象存取流数据
    	  psa = SafeArrayCreateVector( VT_UI1, 0, llen );
    	// 指向字节数组的指针
    	  unsigned char *pData = NULL;
    	// 取得一个 safe array的指针. 锁定数组.
    	  SafeArrayAccessData( psa, (void**)&pData );
    	// 拷贝内存文件到 safearray
    	  memcpy( pData, pMemData, llen );
    	// 清理缓冲区
    	  delete pMemData;
    	// 锁定对 safearray的访问
    	  SafeArrayUnaccessData(psa);
    	// 返回一个在这分配的SAFEARRAY的指针
    	  return psa;
    }
    // 重新创建一个SAFEARRAY对象
    BOOL CBlob::Expand(CObject * &rpObj, SAFEARRAY *psa)
    {
    	  CMemFile memfile; // 反序列化的内存文件
    	  long lLength; // 字节数
    	  char *pBuffer; // 缓冲区指针
    	// 锁定数组数据的访问
    	  SafeArrayAccessData( psa, (void**)&pBuffer );
    	// 取得数组中元素个数. 是字节数
    	  lLength = psa->rgsabound->cElements;
    	// 连接缓冲区到内存文件
    	  memfile.Attach((unsigned char*)pBuffer, lLength);
    	// 从缓冲区头部开始
    	  memfile.SeekToBegin();
    	// 创建一个连接到内存文件上的档案文件
    	  CArchive ar(&memfile, CArchive::load | CArchive::bNoFlushOndelete);
    	// 不使用文档指针
    	  ar.m_pDocument = NULL;
    	// 填充对象 取得指针
    	  rpObj = ar.ReadObject(0);
    	// 关闭档案文件
    	  ar.Close();
    	// 注意: 当SAFEARRAY被毁坏时 pBuffer 被释放
    	// 释放缓冲区 关闭文件
    	  pBuffer = (char*) memfile.Detach();
    	// 释放safearray 缓冲区
    	  SafeArrayUnaccessData( psa );
    	  return TRUE;
    }
    
在这里 ,我使用SAFEARRAY是因为它对我们来说是最好的选择,它可以包含一些复杂的多维数组,但是,这个例子我们只使用了非常简单的数组,SAFEARRAY数据,有一个问题:MIDL认不出这个数据类型,在下一篇文章中我将讲述最简单的方法:使用 VARIANT数据类型。

下一步如下:
  1. 创建一个COM接口,
  2. 创建一个SAFEARRAY对象,
  3. 在IDL文件中定义:
    [helpstring("method SetArray")] 
    HRESULT SetArray([in]SAFEARRAY (unsigned char) pData);[helpstring("method GetArray")] 
    HRESULT GetArray([out/*,retval*/]SAFEARRAY(unsigned char) *pData); 
  4. 创建一个基于MFC的客户机来测试该应用程序 你的IDL文件应该象这样:
interface IBolbData : IUnknown
{
	  [helpstring("method SetArray")] HRESULT SetArray([in]SAFEARRAY
		    (unsigned char) pData);
	  [helpstring("method GetArray")] HRESULT GetArray([out/*,retval*/]
		    SAFEARRAY(unsigned char) *pData);
};
// 设定对象
STDMETHODIMP CBolbData::SetArray(SAFEARRAY *pData)
{
	  AFX_MANAGE_STATE(AfxGetStaticModuleState())
		// 创建CSimpleObj的亚元指针
		  CSimpleObj *dummy=NULL; 
	// 创建 blob 对象 用来填充、反序列化
	  CBlob blob;
	// 使用 safearray 创建亚元对象
	  blob.Expand( (CObject*&)dummy, pData );
	  dummy->Show(); // 调用显示函数测试对象
	  delete dummy; //删除指针
	  return S_OK;
}
// 创建对象 并发送给客户机.
STDMETHODIMP CBolbData::GetArray(SAFEARRAY **pData)
{
	  AFX_MANAGE_STATE(AfxGetStaticModuleState())
		// 创建对象并发送给服务器
		  CSimpleObj *pMyOb = new CSimpleObj();
	//设定字符串数据
	  pMyOb->SetString( "A SAFEARRAY from the server!" );
	// 创建blob来序列化对象
	  CBlob blob;
	// 将对象载入blob
	  *pData = blob.Load( pMyOb );
	// 删除pMyOb指针
	  delete pMyOb;
	  return S_OK;
}
       
最后,写一个有两个按钮的基于对话框的 MFC 应用程序 并添加如下代码:  
void CClientDlg::OnOK()
{
	// 从CLSID串创建COM智能指针
	try
	{
		  IBolbDataPtr pI( "Server.BolbData.1" );
		  SAFEARRAY *psa ;
		// 从服务器取得 safearray
		  pI->GetArray( &psa );
		// 创建指针
		  CSimpleObj *dummy=NULL;
		// blob 对象
		  CBlob blob;
		//使用blob 扩展 safearray 到一个对象里
		  blob.Expand( (CObject *&)dummy, psa );
		//通过调用一个对象的方法来测试它
		  dummy->Show();
		// 删除对象
		  delete dummy;
	}
	// 通过智能指针处理任意 COM 异常
	catch (_com_error e)
	{
		// 显示错误信息
		  AfxMessageBox( e.ErrorMessage() );
	}
}
void CClientDlg::OnLoad()
{
	try
	{
		// 从CLSID 串创建智能指针
		  IBolbDataPtr pI( "Server.BolbData.1" );
		  SAFEARRAY *psa ;
		// 创建送给服务器的对象
		  CSimpleObj *pMyOb = new CSimpleObj();
		// 设置字符串数据
		  pMyOb->SetString( "The client sent a SAFEARRAY!" );
		// 创建 blob 用来序列化对象
		  CBlob blob;
		// 将对象载入到 blob
		  psa = blob.Load( pMyOb );
		//删除对象
		  delete pMyOb;
		  pI->SetArray( psa );
	}
	catch (_com_error e)
	{
		// 显示错误信息
		  AfxMessageBox( e.ErrorMessage() );
	}
}      

你可能感兴趣的:(职场,休闲,向ATL,DLL中传递C++对象)