介绍 这篇文章展示了一种结合ACE和ATL的方法。它不打算作为功能演示,而是作为一个小型的“入门”解决方案,展示实现此目标的可行方法。 我假设熟悉ACE的开发人员会对本文感兴趣,因此本文对如何设置项目的ATL部分进行了冗长的描述。 ACE在多线程和同步方面提供了丰富的功能。它拥有功能最完整的api之一,可以用c++开发快速可靠的网络解决方案。该框架为编写实时软件解决方案提供了最先进的功能。 在本文中,我们将构建一个简单的COM服务应用程序,演示一种集成ACE和ATL的可能方法。ACE将用于实现从服务到COM客户端的异步回调。 ACE是一个c++库,在开发可靠的解决方案方面有着良好的记录。有关使用ACE的公司和项目列表,请查看谁在使用ACE。 虽然ACE主要用于开发可移植的、高效的网络解决方案,但将它与ATL集成是一个有趣的概念。同样的方法也可以用于实现与TAO的集成,使我们能够轻松地开发Corba和COM服务的组合。 按照ACE的发明者Douglas C. Schmidt的说法,ACE就是为了便于携带、灵活、可扩展、可预测、可靠和负担得起而编写的。 因为它是一个开源项目,所以它当然是负担得起的,而且它有一个活跃的、响应迅速的开发人员社区。 作为一名开发人员,我也欣赏“灵活、可扩展、可预测、可靠”的部分。 如果你对ACE一无所知,不妨看看这个教程。 先决条件 从http://download.dre.vanderbilt.edu下载ACE,并根据包含的说明构建项目——或者查看http://www.dre.vanderbilt.edu/~schmidt/DOC_ROOT/ACE/ACE-INSTALL.html获得详细说明。 本文假设“config”。“h”的ACE图书馆包括: 隐藏,复制Code
#define ACE_NTRACE 0
之前: 隐藏,复制Code
#include <spanclass="code-string">"ace/config-win32.h"</span>
将“ACE_NTRACE”定义为0可以在执行期间通过打开“ACE_TRACE”宏输出大量的跟踪信息。 请记住设置“ACE_ROOT”环境变量并将“%ACE_ROOT%\lib”添加到系统路径。 在Windows 7下,以管理员身份运行Visual Studio,以便在构建期间自动注册COM应用程序。 创建项目 我们将从创建一个标准的ATL服务应用程序开始。 记得在ATL项目向导的“应用程序设置”页面选择“服务(EXE)”单选按钮。 单击finish, Visual Studio将创建一个标准的ATL服务应用程序。 现在我们需要告诉Visual Studio在哪里可以找到ACE库。 将"$(ACE_ROOT)\lib"添加到"库目录" 现在,我们已经准备好添加ATL COM对象实现了,所以切换到“类视图”并从项目弹出菜单中选择add ->Class。 这将打开“添加类”对话框,我们将在其中选择“ATL简单对象”。 点击“添加”弹出ATL简单对象向导: 在“短名称”中输入“Demo”,进入“选项”页面: 通过选择“Free”线程模型,我们告诉COM我们将能够自己处理同步问题。在本例中,我们不希望支持聚合,但我们确实希望使用“ISupportErrorInfo”和“连接点”提供错误处理支持,以使用COM事件提供通知。 现在,我们有了一个基本的“不做任何事”的COM服务,是时候开始添加基于ACE的功能了,但首先我们需要告诉Visual Studio在哪里可以找到允许我们使用ACE的包含文件。打开项目的属性对话框,将$(ACE_ROOT)添加到“Include目录”中。 到链接器->System页面,将“子系统”设置为“控制台(/子系统:控制台)”。这在调试期间通常很有用,在生产场景中无害,因为服务无论如何都是不可见的。 这一步还允许我们使用ACE_TMAIN(int argc, ACE_TCHAR* argv[])作为入口点。 “stdafx开放。h”,并在文件末尾添加以下内容: 隐藏,复制Code
#include <spanclass="code-string">"ace/Log_Msg.h"
</span>#include <spanclass="code-string">"ace/Svc_Handler.h"
</span>#include <spanclass="code-string">"ace/Method_Request.h"
</span>#include <spanclass="code-string">"ace/Activation_Queue.h"
</span>#include <spanclass="code-string">"ace/Future.h"
</span>#include <spanclass="code-keyword"><vector></span>
打开ACEATLDemo.cpp并在include部分之后添加以下内容,以告诉链接器关于ACE库的信息: 隐藏,复制Code
#ifndef _DEBUG
#pragma comment(lib,"ace")
#else
#pragma comment(lib,"aced")
#endif
现在,我们的项目看起来是这样的: 重新构建项目,我们就可以开始基于ACE的功能实现COM服务了。 为了让事情变得有趣,我们将把服务的核心实现为活动对象,其中功能在单独的线程上异步执行。班级是这样的: 隐藏,复制Code
class CDemo;
class CDemoImpl : public ACE_Task_Base
{
ACE_Activation_Queue activation_queue_;
std::vector<CDemo*> clients_;
public:
CDemoImpl(void);
~CDemoImpl(void); virtual int svc (void);
int enqueue (ACE_Method_Request *request); int exitImpl();
int postMessageImpl(CComBSTR text);
int registerImpl(CDemo *pDemo);
int unregisterImpl(CDemo *pDemo); IntFuture callExit();
void callPostMessage(BSTR bstr);
IntFuture callRegister(CDemo *pDemo);
IntFuture callUnregister(CDemo *pDemo);
};
IntFuture是一个简单的定义类型: 隐藏,复制Code
typedef ACE_Future<int> IntFuture;
未来是一种允许我们等待未来可能值的构造。 ACE允许我们使用下面的声明来实现一个单例,它是一个保证通过“DemoImpl”只能访问一个“CDemoImpl”实例的构造。 隐藏,复制Code
typedef ACE_Singleton<CDemoImpl, ACE_Null_Mutex> DemoImpl;
“CDemoImpl”类的核心是“svc”函数: 隐藏,复制Code
int CDemoImpl::svc (void)
{
ACE_TRACE ("CDemoImpl::svc");
HRESULT hr = CoInitializeEx(NULL, COINIT_MULTITHREADED);
if (FAILED(hr))
{
ACE_ERROR ((LM_ERROR,
ACE_TEXT ("CoInitializeEx failed - returned:%d\n"),hr));
return -1;
} while (1)
{
auto_ptr<ace_method_request />
request (this->activation_queue_.dequeue ()); if (request->call () == -1)
{
break;
}
}
return 0;
}
请求从激活队列中脱离,并使用它们的“call”函数执行。 一个“ACE_Method_Request”通常是这样的: 隐藏,复制Code
class CExitMethodRequest : public ACE_Method_Request
{
IntFuture result_;
public:
CExitMethodRequest(IntFuture& result)
: result_(result)
{
ACE_TRACE ("CExitMethodRequest::CExitMethodRequest");
} ~CExitMethodRequest( )
{
ACE_TRACE ("CExitMethodRequest::~CExitMethodRequest");
} virtual int call (void)
{
ACE_TRACE ("CExitMethodRequest::call");
int result = DemoImpl::instance()->exitImpl();
result_.set(result);
return result;
}
};
“call”函数使用了我们的“DemoImpl”单例定义,并设置了“IntFuture”“result_”的值,使得通过“IntFuture”调用线程可以使用结果。 与“svc”函数对应的是“enqueue”函数: 隐藏,复制Code
int CDemoImpl::enqueue (ACE_Method_Request *request)
{
ACE_TRACE ("CDemoImpl::enqueue");
return this->activation_queue_.enqueue (request);
}
“enqueue”函数是这样使用的: 隐藏,复制Code
IntFuture CDemoImpl::callExit()
{
ACE_TRACE ("CDemoImpl::callExit");
IntFuture result; CExitMethodRequest *request = new CExitMethodRequest(result);
enqueue (request); return result;
}
打开ACEATLDemo.cpp,进入… 隐藏,复制Code
typedef ATL::CAtlServiceModuleT< CACEATLDemoModule, IDS_SERVICENAME > Inherited;
…在“CACEATLDemoModule”类定义的顶部。然后在类中添加以下声明: 隐藏,复制Code
void RunMessageLoop() throw(); void OnStop() throw(); bool ParseCommandLine(LPCTSTR lpCmdLine,HRESULT* pnRetCode) throw();
然后像这样实现它们: 隐藏,收缩,复制Code
void CACEATLDemoModule::RunMessageLoop() throw()
{
ACE_TRACE( "RunMessageLoop" ); ACE_Reactor::instance()->run_reactor_event_loop();
} void CACEATLDemoModule::OnStop() throw()
{
ACE_TRACE( "OnStop" );
ACE_Reactor::instance()->end_reactor_event_loop(); IntFuture futureResult = DemoImpl::instance()->callExit();
int result = 0;
futureResult.get(result); if(result != -1)
{
ACE_ERROR ((LM_ERROR,
ACE_TEXT ("callExit failed - returned:%d\n"),result));
}
DemoImpl::instance()->wait();
} bool CACEATLDemoModule::ParseCommandLine(LPCTSTR lpCmdLine,
HRESULT* pnRetCode) throw()
{
ACE_TRACE( "ParseCommandLine" );
bool result = Inherited::ParseCommandLine(lpCmdLine,pnRetCode);
return result;
}
通过实现RunMessageLoop,我们有效地替换了ATL的默认实现,并使用ACE反应器作为标准消息循环的替代品。为了提供对服务控制管理器停止事件的正确处理,我们还需要实现OnStop方法。由于“DemoImpl”在一个单独的线程上运行“svc”函数,所以我们使用“callExit”告诉“svc”该退出请求处理循环了,并调用wait来确保线程已经完成了它的执行。ParseCommandLine使用我们添加到“CACEATLDemoModule”类定义顶部的“Inherited”调用默认实现。这里展示了如何“挂钩”到命令行的ATLs处理。为了支持服务控制管理器停止事件时的模拟,我们为控制台控制事件(如Ctrl+C和Ctrl+Break)实现了一个应用处理程序例程。 隐藏,复制Code
BOOL WINAPI ConsoleCtrlHandler(DWORD dwCtrlType)
{
ACE_TRACE( "ConsoleCtrlHandler" );
_AtlModule.OnStop();
return TRUE;
}
现在我们将“_tWinMain”函数更改为: 隐藏,收缩,复制Code
int ACE_TMAIN (int argc, ACE_TCHAR * argv[] )
{
ACE_TRACE("main");
int result = 0;
try
{
STARTUPINFO startupInfo = {sizeof(STARTUPINFO),0,};
GetStartupInfo(&startupInfo);
if(IsDebuggerPresent())
{
SetConsoleCtrlHandler(ConsoleCtrlHandler,TRUE);
HRESULT hr = _AtlModule.InitializeCom(); result = _AtlModule.Run(startupInfo.wShowWindow); _AtlModule.UninitializeCom();
_AtlModule.Term();
SetConsoleCtrlHandler(ConsoleCtrlHandler,FALSE);
}
else
{
result = _AtlModule.WinMain(startupInfo.wShowWindow);
}
}
catch(...)
{
ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"),
ACE_TEXT ("Unknown exception in main")));
} return result;
}
至此,我们已经创建了一个工作应用程序,它在执行期间为我们提供了一些有用的信息。当应用程序在调试器下执行时,它将始终作为控制台应用程序运行,而不考虑注册表中的“LocalService”设置。ACEATLDemo开放。idl,并添加: 隐藏,复制Code
[id(1)] HRESULT PostMessage(BSTR messageText);
到“IDemo”接口的定义,然后打开Demo.h,添加: 隐藏,复制Code
STDMETHOD(PostMessage)(BSTR messageText);
作为一个公共方法。打开Demo.cpp,实现方法: 隐藏,复制Code
STDMETHODIMP CDemo::PostMessage(BSTR messageText)
{
ACE_TRACE("CDemo::PostMessage"); DemoImpl::instance()->callPostMessage(messageText); return S_OK;
}
callPostMessage函数将CPostMessageMethodRequest请求放入激活队列中。 隐藏,复制Code
void CDemoImpl::callPostMessage(BSTR bstr)
{
ACE_TRACE ("CDemoImpl::callPostMessage");
CPostMessageMethodRequest *request = new CPostMessageMethodRequest(bstr);
enqueue (request);
}
当请求脱离队列时,它的call()函数将调用: 隐藏,复制Code
int CDemoImpl::postMessageImpl(CComBSTR text)
{
ACE_TRACE ("CDemoImpl::postMessageImpl"); for(vector<cdemo* />::iterator it = clients_.begin();
it < clients_.end();
it++)
{
CDemo *pDemo = (*it);
pDemo->Fire_OnPostMessage(text.m_str);
}
return 0;
}
实现测试客户端 要测试我们的服务器,我们需要开发一个小型测试应用程序。使用。net和c#很容易做到这一点。我们这样实现客户端: 隐藏,收缩,复制Code
public partial class MainForm : Form
{
ACEATLDemoLib.Demo demo; public MainForm()
{
InitializeComponent();
} protected override void OnShown(EventArgs e)
{
base.OnShown(e); demo = new ACEATLDemoLib.Demo(); demo.OnPostMessage += new ACEATLDemoLib._IDemoEvents_OnPostMessageEventHandler
(demo_OnPostMessage);
} delegate void demo_OnPostMessageDelegate(string messageText);
void demo_OnPostMessage(string messageText)
{
if (InvokeRequired)
{
BeginInvoke(new demo_OnPostMessageDelegate(demo_OnPostMessage), messageText);
}
else
{
messagesTextBox.AppendText(messageText + Environment.NewLine);
}
} private void sendMessageButtonButton_Click(object sender, EventArgs e)
{
demo.PostMessage(messageTextBox.Text);
}
}
在Visual Studio 2010中,表单是这样的: 现在我们可以启动服务器和客户端应用程序的几个实例。因为我们已经启用了ACE_TRACE宏,所以服务器将提供一个有趣的视图来了解它的行为。把这个项目看作一个起点,将ACE或TAO与ATL结合,可以让我们基于所提供的功能创建软件。浏览文档,您会发现实时软件开发中一些极具挑战性的方面的高质量实现。 进一步的阅读 由Stephen D. Huston、James CE Johnson和Umar Syyid合著的《ACE程序员指南:网络和系统编程的实用设计模式》一书介绍了ACE开发。 历史 2011年1月2日-初始版本 本文转载于:http://www.diyabc.com/frontweb/news30038.html