- 下载source code - 39.66 KB
介绍 这篇文章展示了一种结合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" #include <spanclass="code-string">"ace/Svc_Handler.h" #include <spanclass="code-string">"ace/Method_Request.h" #include <spanclass="code-string">"ace/Activation_Queue.h" #include <spanclass="code-string">"ace/Future.h" #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::vectorclients_; 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_FutureIntFuture;
未来是一种允许我们等待未来可能值的构造。 ACE允许我们使用下面的声明来实现一个单例,它是一个保证通过“DemoImpl”只能访问一个“CDemoImpl”实例的构造。 隐藏,复制Code
typedef ACE_SingletonDemoImpl;
“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_ptrrequest (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::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