如何用ACE来实现一个windows Service

freeeyes

好久没来写技术文章，归结原因依旧是很忙。
有时间就多写一些吧。
最近有朋友在我的开源服务器上做了一个windows服务版本，挺有趣，于是我想把这个功能和我的服务器做一个整合，一开始并不顺利，原因是自己对windows服务的流程不熟悉。走了一些弯路，在这里记录下来，供大家参考。
其实windows下的服务和Linux下的服务大相径庭，linux下的步骤大概在7步，实际上一个function即可完成，windows下的服务必须先注册，再运行，当然，如果你想删除服务，还的有一个删除的步骤。
这篇文章先讨论windows下的服务开启和启动。
首先，先要了解一个类，ACE_NT_Service
这个类是一个标准的windows服务类，我们要创建一个自己的服务，就必须先继承它，
这里有几个函数，我需要再这里说明一下。

1. class CProgramService : public  ACE_NT_Service
2. {
3. public:
4.         CProgramService(void);
5.         ~CProgramService(void);
7.         virtual int svc(void);
9.         virtual int  handle_exception (ACE_HANDLE h);
11.         virtual void handle_control (DWORD control_code);
13. private:
14.         typedef ACE_NT_Service inherited;
16. private:
17.         bool m_blsStop;
18. };class CProgramService : public  ACE_NT_Service
19. {
20. public:
21.         CProgramService(void);
22.         ~CProgramService(void);
24.         virtual int svc(void);
26.         virtual int  handle_exception (ACE_HANDLE h);
28.         virtual void handle_control (DWORD control_code);
30. private:
31.         typedef ACE_NT_Service inherited;
33. private:
34.         bool m_blsStop;
35. };

复制代码

svc() 这个函数是用来处理服务运行的，你可以在这里添加你的任意代码，比如一个死循环，或者一个你需要执行的函数。
handle_control ()函数是当windows service管理控制器被操作的时候，比如点击运行，暂停，停止，重新运行等，会对应这些消息被投递到这里。control_code就是这些消息类型。你可以case一下，用作你的处理。
handle_exception ()是当异常发生的时候，通知windows service你的进程当前的状态，从而统一service管理器对你的服务状态的完整监控。

好了，知道以上几个接口，基本能够完成windows service的所有控制了。
那么下面，我们来看怎么控制。

1. ACE_NT_SERVICE_DEFINE (freeeyes, CProgramService, ACE_TEXT("freeeyes Service"));

复制代码

这行代码是必要的，这个宏的意思是说，把Service对应的接口绑定给CProgramService类，也就是你的ACE_NT_Service。
为了方便测试服务的启动和注册，借用一下ACE例子里面的一个类。

1. class Process
2. {
3. public:
4.         Process (void);
5.         ~Process (void);
7.         int run(int argc, ACE_TCHAR* argv[]);
9. private:
10.         void parse_args (int argc,
11.                 ACE_TCHAR* argv[]);
12.         void print_usage_and_die (void);
14. private:
15.         char progname[128];
17.         int opt_install;
18.         int opt_remove;
19.         int opt_start;
20.         int opt_kill;
21.         int opt_type;
22.         int opt_debug;
24.         int opt_startup;
25. };
27. typedef ACE_Singleton<Process, ACE_Mutex> PROCESS;
29. Process::Process (void)
30. : opt_install (0),
31. opt_remove (0),
32. opt_start (0),
33. opt_kill (0),
34. opt_type (0),
35. opt_debug (0),
36. opt_startup (0)
37. {
38.         ACE_OS::strcpy (progname,
39.                 "service");
40.         ACE::init ();
41. }
43. Process::~Process (void)
44. {
45.         ACE::fini ();
46. }
48. void
49. Process::print_usage_and_die (void)
50. {
51.         ACE_DEBUG ((LM_INFO,
52.                 "Usage: %s"
53.                 " -in -r -s -k -tn -d\n"
54.                 "  -i: Install this program as an NT service, with specified startup\n"
55.                 "  -r: Remove this program from the Service Manager\n"
56.                 "  -s: Start the service\n"
57.                 "  -k: Kill the service\n"
58.                 "  -t: Set startup for an existing service\n"
59.                 "  -d: Debug; run as a regular application\n",
60.                 progname,
61.                 0));
62.         ACE_OS::exit(1);
63. }
65. void
66. Process::parse_args (int argc, ACE_TCHAR* argv[])
67. {
68.         ACE_Get_Opt get_opt (argc, argv, ACE_TEXT ("i:rskt:d"));
69.         int c;
71.         while ((c = get_opt ()) != -1)
72.                 switch (c)
73.         {
74.                 case 'i':
75.                         opt_install = 1;
76.                         opt_startup = ACE_OS::atoi (get_opt.opt_arg());
77.                         if (opt_startup <= 0)
78.                                 print_usage_and_die ();
79.                         break;
80.                 case 'r':
81.                         opt_remove = 1;
82.                         break;
83.                 case 's':
84.                         opt_start = 1;
85.                         break;
86.                 case 'k':
87.                         opt_kill = 1;
88.                         break;
89.                 case 't':
90.                         opt_type = 1;
91.                         opt_startup = ACE_OS::atoi(get_opt.opt_arg());
92.                         if (opt_startup <= 0)
93.                                 print_usage_and_die ();
94.                         break;
95.                 case 'd':
96.                         opt_debug = 1;
97.                         break;
98.                 default:
99.                         // -i can also be given without a value - if so, it defaults
100.                         // to defined value.
101.                         if (ACE_OS::strcmp (get_opt.argv ()[get_opt.opt_ind () - 1], ACE_TEXT ("-i")) == 0)
102.                         {
103.                                 opt_install = 1;
104.                                 opt_startup = DEFAULT_SERVICE_INIT_STARTUP;
105.                         }
106.                         else
107.                         {
108.                                 print_usage_and_die();
109.                         }
110.                         break;
111.         }
112. }
114. int Process::run (int argc, ACE_TCHAR* argv[])
115. {
116.         App_Service::instance()->name(ACE_TEXT ("freeeyes"), ACE_TEXT ("freeeyes Service"));
118.         parse_args(argc, argv);
120.         if (opt_install && !opt_remove)
121.         {
122.                 if (-1 == App_Service::instance ()->insert(opt_startup))
123.                 {
124.                         ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("insert")));
125.                         return -1;
126.                 }
127.                 return 0;
128.         }
130.         if (opt_remove && !opt_install)
131.         {
132.                 if (-1 == App_Service::instance ()->remove())
133.                 {
134.                         ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("remove")));
135.                         return -1;
136.                 }
137.                 return 0;
138.         }
140.         if (opt_start && opt_kill)
141.                 print_usage_and_die ();
143.         if (opt_start)
144.         {
145.                 if (-1 == App_Service::instance ()->start_svc())
146.                 {
147.                         ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("start")));
148.                         return -1;
149.                 }
150.                 return 0;
151.         }
153.         if (opt_kill)
154.         {
155.                 if (-1 == App_Service::instance()->stop_svc())
156.                 {
157.                         ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("stop")));
158.                         return -1;
159.                 }
160.                 return 0;
161.         }
163.         if (opt_type)
164.         {
165.                 if (-1 == App_Service::instance ()->startup(opt_startup))
166.                 {
167.                         ACE_ERROR ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("set startup")));
168.                         return -1;
169.                 }
170.                 return 0;
171.         }
173.         //开始启动服务
174.         ACE_NT_SERVICE_RUN (freeeyes,
175.                 App_Service::instance (),
176.                 ret);
177.         if (ret == 0)
178.                 ACE_ERROR ((LM_ERROR,
179.                 ACE_TEXT ("%p\n"),
180.                 ACE_TEXT ("Couldn't start service")));
181.         else
182.                 ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("%T (%t): Service stopped.\n")));
184.         return 0;
185. }

复制代码

最后，在Main函数里面，添加一行语句即可

1. int ACE_TMAIN (int argc, ACE_TCHAR* argv[])
2. {
3.         return PROCESS::instance ()->run(argc, argv);
4. }

复制代码

这里要说明，并不是这些代码写好了，你就可以直接点运行了，这样你的服务是肯定起不来的。
首先，要注册服务。
你需要打开cmd窗口，切换到你的工程目录下，找到你的exe文件。然后注册一个你的服务。
比如我这个程序， freeeyes.exe -i
注册成功什么都不显示，程序退出，否则显示错误信息。
然后找到"我的电脑" 右键"服务"，打开windows服务窗口，查找你添加的服务名称。
然后点击运行
这样，你的服务就启动了。
如果你想删除服务，也简单，同样到cmd下， freeeyes.exe -r 即可。
这里得说一下ACE windows服务下的一些容易出错的地方。
你或许会觉得这段代码永远不会被执行

1. //开始启动服务
2.         ACE_NT_SERVICE_RUN (freeeyes,
3.                 App_Service::instance (),
4.                 ret);
5.         if (ret == 0)
6.                 ACE_ERROR ((LM_ERROR,
7.                 ACE_TEXT ("%p\n"),
8.                 ACE_TEXT ("Couldn't start service")));
9.         else
10.                 ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("%T (%t): Service stopped.\n")));

复制代码

实际上，这段代码非常重要，在你的服务注册以后，当启动的时候，windows服务管理器会直接运行freeeyes.exe，这个程序，这时候，代码会自己走到这个里面调用ACE_NT_SERVICE_RUN这个宏，实际上，只有当freeeyes这个服务正确注册的时候，才会被启动，否则会返回1053错误。这里一定要注意。还有，要运行这个测试用例，一定要把ACEd.dll拷贝到当前目录下啊。否则服务会因为找不到dll而启动不起来。
好啦，废话少说，把我的这个样例代码贴在下面吧。
此代码windows7 ACE6.1.0下测试通过。