ACE入门－配置功能

peakzhang

作者：吴尔平
      ACE 是一个很大的东西，每个人学习路径可能都不一样。我的方法首先阅读 C++ Network Programming, Volume 1 ，让自己明了ACE 的设计思路；再从实际的小项目入手，逐步的用 ACE 内容替换掉自己的东西，在比较和实践之间求得较深的了解。
     就一个正常项目而言，一个配置文件是必不可少的，那就先从这里入手了。linux/unix 程序可能经常用到命令行方式，不过我还是比较喜欢 windows 的 ini 格式的，当然，有xml 的更好，不过 ACE 里暂时没有提供。配置文件的使用很简单，ACE 提供的类也很友好。在这里主要是整理一些细节，让大家不在这里浪费太多时间。

1、ACE 配置类简介与使用
  
   先给出一个印象（为了直指主题，所有错误处理都被清除）：
     ACE_Configuration_Heap config;
     ACE_Registry_ImpExp impExp(config);    // win32的注册表导出格式
     //ACE_Ini_ImpExp impExp(config);          // windows的.ini格式
     impExp.import_config("配置文件名");    // 读取配置文件  
  
     ACE_Configuration_Section_Key section;// 指向一个配置节section
     config.open_section(config.root_section(), ACE_TEXT("节名"), 0, section);
  
     // 读取字符串
     ACE_TString str;   
     config.get_string_value(section, ACE_TEXT("键名"), str); // ACE_Ini_ImpExp，只能使用这一种方法
  
    // 读取整型
     u_int i;
     config.get_integer_value(section, ACE_TEXT("键名"), i);
  
    // 读取二进制
     void * data_out = 0; // 最好使用智能指针
     size_t length = 0;
     config.get_binary_value(section, ACE_TEXT("键名"), data_out, length);
     delete []data_out;

    可以浏览一下 ACE_Configuration_Heap　和 ACE_Ini_ImpExp　或　ACE_Registry_ImpExp　之间的关系。不需要套上术语来理解，简化一下代码对此很有帮助。

一个超简化的ACE_Configuration_Heap


1 class ACE_Export ACE_Configuration_Heap : public ACE_Configuration
2 {
3  // 其它函数全部略去
4  private:
5    SECTION_MAP *index_;
6 };

值得注意的是 ACE_Registry_ImpExp　和 ACE_Ini_ImpExp ，这两个类都继承自 ACE_Config_ImpExp_Base，分别处理不同的格式。
  
简化版本的 ACE_Config_ImpExp_Base，　具体实现请看 Configuration_Import_Export.h
1 class ACE_Config_ImpExp_Base
2 {
3  public:
4   ACE_Config_ImpExp_Base (ACE_Configuration& config);
5   virtual int import_config (const ACE_TCHAR* filename) = 0;  // 从文件中导入配置
6   virtual int export_config (const ACE_TCHAR* filename) = 0;  // 导出配置到文件  
7  protected:
8   ACE_Configuration &config_;
9 };


从两个简化的类，可以想象 ACE_Registry_ImpExp　和 ACE_Ini_ImpExp对import_config的具体实现会将不同格式的文件里的配置数据转化成相同的格式化的数据，并将之放到 ACE_Configuration_Heap　的 SECTION_MAP *index_。 ACE_Config_ImpExp_Base　具体实现的作用就是作为一个适配器。

2、ACE 配置格式说明：

（内容来自Configuration_Import_Export.h的注释）

   2.1. ACE_Registry_ImpExp

   使用win32 注册表文件导出文件格式，格式如下:


  [Section]
          "key"="String Data"
          "key"=dword: 十六进制数值
          "key"=hex: 二进制
          注意，二进制的写法如下  
          "pwd"=hex:31,32,33,34,35,36,37,38


2.2. ACE_Ini_ImpExp

从文件中导入字符串配置数据。充许 not-typed 值（没有　＃，dword: hex:, 等前缀），在标准的.ini和.conf中跳过空白字符(tabs和spaces)。　值 （在等式的右边）可以被双引号限定，使得tabs或spaces能够留在字符串中。调用者必须自己转换字符串到类型。格式如下：
TimeToLive     =    100
Delay          =    false
Flags          =    FF34  # 可以象这样写注释
Heading        =    "ACE - Adaptive Communication Environment"

   
3、一个友好的函数

     使用此类配置文件时，如果用到会变化的配置集合，我们经常遇到这样的写法


[section]
"size"=dword:2
"item_1"="value1"
"item_2"="value2"


     这样写因为 window 提供的 API 只能一项一项读取，我们只能在读取了size 的值后，才能拼凑出"item_1"键名来取到相应的值。在实际操作中维护人员很容易遗漏操作，增加了选项但忘记增加size的值。ACE则提供了非常友好的enumerate_values函数，配合一下 boost 的 split 使用起来感觉很好。
  
     一个非常简单的TCP转发程序的配置文件，将一端口接收到的数据转发至指定地址的端口，可以开多个服务端口:
[server\listen_items]
;listen_port, target_ip, target_port, timeout (second), validate
"item_1"="19998,192.168.168.217,8101,60,1"
"item_2"="8000, 192.168.0.57, 23, 60, 1"

        实际的代码摘录，但不一定能编译呵 :-)   
1  
2 #include <boost/algorithm/string.hpp>
3 #include <boost/lexical_cast.hpp>
4 using namespace boost;
5
6  
7 class ListenItem
8 {
9 public:
10  unsigned int listen_port_;  
11  string target_ip_;     
12  unsigned int target_port_;  
13  unsigned int timeout_;     
14  bool validate_;      
15 };
16
17 vector<ListenItem> vec;
18  
19 int index = -1;
20 ACE_TString name;
21 ACE_Configuration::VALUETYPE type;
22 while(0 == config.enumerate_values(section, ++index, name, type))
23 {
24  ACE_TString str;
25  if(config.get_string_value(section, ACE_TEXT(name.c_str()), str) == -1)
26  {
27   ACE_ERROR_RETURN((LM_ERROR, ACE_TEXT("%p\n"), ACE_TEXT("ListenPort item does not exist\n")), -1);
28  }
29
30  ListenItem item;
31  vector<string> splitVec;  
32  string ss = str.c_str();
33  split( splitVec, ss, is_any_of(",") );   
34  item.listen_port_ = lexical_cast<unsigned int>(trim_copy(splitVec[0]));
35  item.target_ip_ = lexical_cast<string>(trim_copy(splitVec[1]));
36  item.target_port_ = lexical_cast<unsigned int>(trim_copy(splitVec[2]));
37  item.timeout_ = lexical_cast<unsigned int>(trim_copy(splitVec[3]));
38  item.validate_ =  lexical_cast<bool>(trim_copy(splitVec[4]));
39  if(item.validate_)
40   vec.push_back(item);
41
42 }
43  
44
45

  这样就可以不写


1stringstream s;
2 s << "item_" << i+1;
3

     这样的代码了，也避免了维护人员遗漏操作

     4、编译选项
     
    上面代码有用到 boost 的相关内容，如果你使用的是 ACE Programmer's Guide　的　2.5 How to Build Your Applications 节所介绍的Makefile，在 linux 下面的话是不可少的
     
     CPPFLAGS = -i"$(BOOST_ROOT)"
     
   当然，还要在.bash_profile或相应原地方加入类似说明:
      
     BOOST_ROOT=$HOME/boost_X_XX_X
     export BOOST_ROOT