解析命令行参数-ACE_Get_Opt类的用法

winston

通常我们开发后台服务程序时经常要提供命令行解析和搜集配置信息的功能。重复这样的
劳动不仅耗时而且对操作系统平台也有依赖性，ACE框架提供了对命令行参数的解析及配置
文件的解析的API接口使我们可以方面的对我们的程序进行方面的配置。
解析命令行参数-ACE_Get_Opt类的用法
ARGV_Example.cpp
此示例演示了ACE_Get_Optint类的基本用法，用来解析类似 program -c -g -a param 这样的程序参数源码解释

1. /**
2. * ARGV_Example.cpp,v 1.3
3. 2004/01/03 13:04:35 jwillemsen Exp
4. *
5. * ACE_ARGV examples not in a larger
6. program. Sample code from The ACE
7. * Programmer's Guide, Copyright 2003
8. Addison-Wesley. All Rights Reserved.
9. */
11. #include
12. "ace/os_include/os_netdb.h"
13. #include "ace/OS_NS_string.h"
14. #include
15. "ace/Log_Msg.h"
17. // Listing 1 code/ch04
18. #include
19. "ace/ARGV.h"
20. #include
21. "ace/Get_Opt.h"
23. //此示例演示了ACE_Get_Optint类的基本用法，用来解析类似 program -c -g -a
24. param  //这样的程序参数
25. ACE_TMAIN (int argc, ACE_TCHAR *argv[])
26. {
27.    
28. //'(":f:h:")'类似一个参数解析的模版 字母紧跟着一个冒号':'那就意味着该“参数开关”    //后期望一个参数
29.     //"f:"
30. 和"h:"说明参数列表必须是 -f parm1 -h parm2的形式
31.     //options[] = "ab:" 则说明参数列表应该是 -a -b
32. parm1类似的形式
33.     static const ACE_TCHAR options[] = ACE_TEXT (":f:h:");
34.    
35. //ACE_Get_Opt会根据指定的参数和模版生产我们需要的参数列表
36.    ACE_Get_Opt cmd_opts (argc, argv,
37. options);
40. // Listing 1
42.   int option;
43.   ACE_TCHAR
44. config_file[MAXPATHLEN];
45.   ACE_TCHAR hostname[MAXHOSTNAMELEN];
46.   
47. ACE_OS_String::strcpy (config_file, ACE_TEXT ("HAStatus.conf"));
48.   
49. ACE_OS_String::strcpy (hostname, ACE_TEXT ("not set"));
50.   
51. //遍历参数列表并进行读取、解析
52.   while ((option = cmd_opts ()) != EOF)
53.     switch
54. (option) {
55.     case 'f':
56.       ACE_OS_String::strncpy
57. (config_file,
58.                               cmd_opts.opt_arg
59. (),
60.                               MAXPATHLEN);
61.       break;
63.    
64. case 'h':
65.       ACE_OS_String::strncpy
66. (hostname,
67.                               cmd_opts.opt_arg
68. (),
69.                               MAXHOSTNAMELEN);
70.       break;
71.      
72. //':'放在"参数模版"的最前面，如果根据模版指示如没有找到期待的参数
73.      //重载的'='操作符会返回':'否则会返回'?'
74.      
75. case ':':
76.       ACE_ERROR_RETURN
77.         ((LM_ERROR, ACE_TEXT ("-%c
78. requires an argument\n"),
79.           cmd_opts.opt_opt ()), -1);
82.    
83. default:
84.       ACE_ERROR_RETURN
85.         ((LM_ERROR, ACE_TEXT ("Parse
86. error.\n")), -1);
87.     }
89.   ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("Config
90. file: %s\n"), config_file));
91.   ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("Hostname:
92. %s\n"), hostname));
93.   return 0;
94. }执行结果演示
95. //正常的参数解析
96. D:\project\ACE_wrappers\examples\APG\Config>ARGV_Example -f
97. my.conf -h chengkai
98. Config file: my.conf
99. Hostname:
100. chengkai
101. //确实一个必要的参数
102. D:\project\ACE_wrappers\examples\APG\Config>ARGV_Example
103. -f my.conf -h
104. -h requires an
105. argument
106. //指定了一个无效的参数
107. D:\project\ACE_wrappers\examples\APG\Config>ARGV_Example
108. -f my.conf -a
109. Parse error.
110. Get_Opt_Long.cpp
111. 此示例演示长参数开关的使用，你可以用'program
112. -config my.conf' 或用'program --config my.conf'
113. 这样形式的用法和 'program -f
114. my.conf'是等价的。源码解释
115. /**
116. * Get_Opt_Long.cpp,v 1.2 2004/01/03 13:04:35 jwillemsen Exp
117. *
118. *
119. ACE_Get_Opt long_only examples. Sample code from The ACE
120. * Programmer's
121. Guide, Copyright 2003 Addison-Wesley. All Rights Reserved.
122. */
124. #include
125. "ace/OS_NS_string.h"
126. #include "ace/Get_Opt.h"
127. #include
128. "ace/Log_Msg.h"
130. //此示例演示长参数开关的使用，你可以用'program -config my.conf'//或用'program
131. --config my.conf'
132. //这样形式的用法和 'program -f my.conf'是等价的
133. int
134. ACE_TMAIN
135. (int argc, ACE_TCHAR *argv[])
136. {
138.   static const ACE_TCHAR options[] =
139. ACE_TEXT (":f:");
140.   ACE_Get_Opt cmd_opts
141.     (argc, argv, options, 1, 0,
142. ACE_Get_Opt::PERMUTE_ARGS, 1);
143.   //指定短选项开关对应的长选项开关
144.   if
145. (cmd_opts.long_option
146.       (ACE_TEXT ("config"), 'f',
147. ACE_Get_Opt::ARG_REQUIRED) == -1)
148.     return -1;
150.   int option;
151.   
152. ACE_TCHAR config_file[MAXPATHLEN];
153.   ACE_OS_String::strcpy (config_file,
154. ACE_TEXT ("HAStatus.conf"));
155.   while ((option = cmd_opts ()) != EOF)
156.    
157. switch (option) {
158.     case 'f':
159.       ACE_OS_String::strncpy
160. (config_file,
161.                               cmd_opts.opt_arg
162. (),
163.                               MAXPATHLEN);
164.       break;
166.    
167. case ':':
168.       ACE_ERROR_RETURN
169.         ((LM_ERROR, ACE_TEXT ("-%c
170. requires an argument\n"),
171.           cmd_opts.opt_opt ()), -1);
174.    
175. default:
176.       ACE_ERROR_RETURN
177.         ((LM_ERROR, ACE_TEXT ("Parse
178. error.\n")), -1);
179.     }
181.   ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("Config file
182. is %s\n"), config_file));
184.   return 0;
185. }执行结果演示
186. D:\project\ACE_wrappers\examples\APG\Config>Get_Opt_Long -f
187. my.conf
188. Config file is my.conf
189. D:\project\ACE_wrappers\examples\APG\Config>Get_Opt_Long -config
190. my.conf
191. Config file is my.conf
192. D:\project\ACE_wrappers\examples\APG\Config>Get_Opt_Long --config
193. my.conf
194. Config file is
195. my.conf
196. Get_Opt.cpp
197. 此示例展示了在使用长选项并且没有指定与之对应的短选项的时候，ACE_Get_Opt可以通过指定一个整数返回值与长选项匹配/**
198. *
199. Get_Opt.cpp,v 1.2 2004/01/03 13:04:35 jwillemsen Exp
200. *
201. * ACE_Get_Opt
202. examples not in a larger program. Sample code from The ACE
203. * Programmer's
204. Guide, Copyright 2003 Addison-Wesley. All Rights Reserved.
205. */
207. #include
208. "ace/OS_NS_string.h"
209. #include "ace/Get_Opt.h"
210. #include
211. "ace/Log_Msg.h"
213. //此示例展示了在使用长选项并且没有指定与之对应的短选项的时候，可以通过指定一个//  
214. 整数返回值与长选项匹配
215. int
216. ACE_TMAIN (int argc, ACE_TCHAR *argv[])
217. {
219.   //
220. Example for a long option without a corresponding short option.
221.   // Just put
222. some context here so the following compiles and runs.
223.   static const
224. ACE_TCHAR options[] = ACE_TEXT (":f:");
225.   ACE_Get_Opt cmd_opts (argc, argv,
226. options);
228.   // 指定长选项--cool_option 并且其缺省返回值0
229.   cmd_opts.long_option
230. (ACE_TEXT ("cool_option"));
231.   cmd_opts.long_option (ACE_TEXT ("the_answer"),
232. 42);
233.   // Listing 1
235.   int option;
236.   ACE_TCHAR
237. config_file[MAXPATHLEN];
238.   ACE_OS_String::strcpy (config_file, ACE_TEXT
239. ("HAStatus.conf"));
240.   while ((option = cmd_opts ()) != EOF)
241.     switch
242. (option) {
243.     case 'f':
244.       ACE_OS_String::strncpy
245. (config_file,
246.                               cmd_opts.opt_arg
247. (),
248.                               MAXPATHLEN);
249.       break;
251.       
252. // Listing 2 code/ch04
253.     case 0:
254.       ACE_DEBUG ((LM_DEBUG, ACE_TEXT
255. ("Yes, very cool.\n")));
256.       break;
258.     case 42:
259.       ACE_DEBUG
260. ((LM_DEBUG, ACE_TEXT ("the_answer is 42\n")));
261.       break;
262.       //
263. Listing 2
265.     case ':':
266.       ACE_ERROR_RETURN
267.         ((LM_ERROR,
268. ACE_TEXT ("-%c requires an argument\n"),
269.           cmd_opts.opt_opt ()),
270. -1);
273.     default:
274.       ACE_ERROR_RETURN
275.         ((LM_ERROR,
276. ACE_TEXT ("Parse error.\n")), -1);
277.     }
279.   return 0;
280. }执行结果演示
281. Get_Opt --cool_option  --the_answer
282. Yes, very cool.
283. the_answer is
284. 42
285. 读写配置文件-ACE_Configuration_Heap类的用法
286. HA_Status.cpp
287. 此示例演示了ACE对配置文件的读取的功能，ACE可以方便的从配置文件读取字符串类型、整数类型、二进制信息/**
288. *
289. HA_Status.cpp,v 1.4 2005/06/29 16:35:46 shuston Exp
290. *
291. * Home Automation
292. Status server. Sample code from The ACE Programmer's Guide,
293. * Copyright 2003
294. Addison-Wesley. All Rights Reserved.
295. */
297. #include
298. "ace/OS_NS_string.h"
299. #include "ace/Configuration.h"
300. #include
301. "ace/Configuration_Import_Export.h"
302. #include "ace/Get_Opt.h"
303. #include
304. "ace/Log_Msg.h"
305. #include "ace/INET_Addr.h"
306. #include
307. "ace/Service_Object.h"
309. class HA_Status : public
310. ACE_Service_Object
311. {
312. public:
313.   virtual int init (int argc, ACE_TCHAR
314. *argv[]);
316. private:
317.   ACE_INET_Addr
318. listen_addr_;
319. };
322. int
323. HA_Status::init (int argc, ACE_TCHAR
324. *argv[])
325. {
327.   // Do ACE_Get_Opt and get conf file name, read out the
328. sections
329.   // and print the names.
331.   // Listing 1 code/ch04
332.   
333. static const ACE_TCHAR options[] = ACE_TEXT (":f:");
334.   ACE_Get_Opt cmd_opts
335. (argc, argv, options);
336.   if (cmd_opts.long_option
337.       (ACE_TEXT
338. ("config"), 'f', ACE_Get_Opt::ARG_REQUIRED) == -1)
339.     return -1;
340.   int
341. option;
342.   ACE_TCHAR config_file[MAXPATHLEN];
343.   ACE_OS::strcpy
344. (config_file, ACE_TEXT ("HAStatus.conf"));
345.   while ((option = cmd_opts ()) !=
346. EOF)
347.     switch (option) {
348.     case 'f':
349.       ACE_OS::strncpy
350. (config_file,
351.                        cmd_opts.opt_arg
352. (),
353.                        MAXPATHLEN);
354.       break;
355.     case
356. ':':
357.       ACE_ERROR_RETURN
358.         ((LM_ERROR, ACE_TEXT ("-%c requires an
359. argument\n"),
360.           cmd_opts.opt_opt ()), -1);
361.     default:
362.       
363. ACE_ERROR_RETURN
364.         ((LM_ERROR, ACE_TEXT ("Parse error.\n")),
365. -1);
366.     }
367.   // Listing 1
369.   // Listing 2 code/ch04
370.   
371. ACE_Configuration_Heap config;
372.   if (config.open () == -1)
373.    
374. ACE_ERROR_RETURN
375.       ((LM_ERROR, ACE_TEXT ("%p\n"), ACE_TEXT ("config")),
376. -1);
377.   ACE_Registry_ImpExp config_importer (config);
378.   if
379. (config_importer.import_config (config_file) == -1)
380.    
381. ACE_ERROR_RETURN
382.       ((LM_ERROR, ACE_TEXT ("%p\n"), config_file),
383. -1);
385.   ACE_Configuration_Section_Key status_section;
386.   //指定打开HAStatus
387. 节进行读取
388.   if (config.open_section (config.root_section
389. (),
390.                            ACE_TEXT
391. ("HAStatus"),
392.                            0,
393.                            
394. status_section) == -1)
395.     ACE_ERROR_RETURN ((LM_ERROR, ACE_TEXT
396. ("%p\n"),
397.                        ACE_TEXT ("Can't open HAStatus
398. section")),
399.                       -1);
401.   
402. //分别用来保存读取的字符串类型的地址和整形的端口号
403.   u_int status_port;
404.   ACE_TString  server_ip
405. ;
406.   //读取取字符串类型的地址属性
407.   if(config.get_string_value(status_section,ACE_TEXT
408. ("ServerIP"),                                                   server_ip)
409. ==-1)  
410.        ACE_ERROR_RETURN
411.       ((LM_ERROR,
412.         ACE_TEXT
413. ("HAStatus ServerIP does not exist\n")),
414.        -1);
415.   //读取整形的端口属性
416.   if
417. (config.get_integer_value (status_section,
418.                                 
419. ACE_TEXT ("ListenPort"),
420.                                 status_port) ==
421. -1)
422.     ACE_ERROR_RETURN
423.       ((LM_ERROR,
424.         ACE_TEXT ("HAStatus
425. ListenPort does not exist\n")),
426.        -1);
427.   //this->listen_addr_.set
428. (static_cast<u_short> (status_port));
429.   // Listing 2
430.   ACE_DEBUG
431. ((LM_DEBUG, ACE_TEXT ("ServerIP =
432. %s\n"),                                            server_ip.c_str()));
433.   
434. ACE_DEBUG ((LM_DEBUG, ACE_TEXT ("ListenPort = %d"),status_port));
437.   
438. return 0;
439. }
441. int
442. ACE_TMAIN (int argc, ACE_TCHAR *argv[])
443. {
444.   
445. HA_Status status;
446.   status.init (argc, argv);
447.   return
448. 0;
449. }

复制代码

配置文件内容格式
•[名称]用来定义一个节。
•可以用'#' 或';'来作为注释
•“attribute”=“value”表示一个字符串类型的属性 。
•attribute=#value 或 表示一个整数类型的属性值。
•“attribute”=dword:value 表示一个64位的双字(十六进制)
•“attribute”=hex:value 以十六进制串表示二进制序列
ACE对配置文件的解析和我们通常用的对配置文件读写的类库不太一样1),感觉ACE对配置文件的
读取对格式要求比较严格和我们普通使用的配置文件格式兼容性稍差一些。
有以下几点点需要我们注意。

1.如果你用来表示一个字符串类型的属性值，你应该用'”'包括你的属性值和属性名称，
2.否则ACE将不能正常解析
3.如果你使用类似”dword:“、”hex:“等前缀表示数字类型的属性值，
4.你需要把属性名称用'”'包括起来 ,属性值能用'”'包括起来
5.表示整数类型的属性时，属性名称和属性值都不要'”'包括起来
测试程序
配置文件内容
#这用来表示一个"节"
[HAStatus]
;字符串类型的属性值
"ServerIP"="127.0.0.1"
;整数类型的属性值
ListenPort=#8080
执行结果
D:\project\ACE_wrappers\examples\APG\Config>HA_Status.exe
ServerIP = 127.0.0.1
ListenPort = 8080
1) 象 attribute=value 这样的定义ACE将不能正常解析，这也是我在读了ACE的实现代码后才得知的，
一开始还以为这是一个BUG