该类用语访问合操纵配置信息,它们的接口由ACE_Configuration类来定义的;

1、ACE_Configuration_Heap:它可以用在几乎所有的平台上,在内存中保存所有配置信息.可以对内存的分配进行定制,使用持久的后备存储,但是最常用的是动态分配的堆内存,所以这个类的名字里面含有一个Heap;

2、ACE_Configuration_Win32Registry:它只能用在Windows平台上,它实现了ACE_Configuration类的接口,可以访问合操纵注册表中的数据;

3、ACE_Registry_ImpExp:这个类使用了一种文本格式,其中的每个值都有类型信息.

4、ACE_Ini_ImpExp:这个类使用的是较老的Windows"INI"文件的格式,其中的值没有相关联的类型信息,因此,不管原来的类型是什么,使用ACE_Ini_ImpExp导出的配置数据总是作为字符串数据导入;

下面的例子是ACE_Configuration_Heap类的使用样例,用于从配置文件中读取配置信息;配置文件的格式如下:

[SECTION]

"Key1"="Value1"

"Key2"="Value2"

"Key2"="Value2"

例子代码:

#include "ace/Get_Opt.h"  
#include "ace/Log_Msg.h"  
#include "ace/SString.h"  
#include "ace/OS_String.h"  
#include "ace/Configuration.h"  
#include "ace/Configuration_Import_Export.h"  
 
int ACE_TMAIN(int argc, ACE_TCHAR** argv)  
{  
 int opt = 0;  
 ACE_TCHAR strCfgFile[128] = "";  
 ACE_TCHAR strSegName[128] = "";  
 
 ACE_TCHAR options[] = "f:F:s:S:vV";  
 ACE_Get_Opt cmd_opts(argc, argv, options);  
 
 //set long options  
 cmd_opts.long_option(ACE_TEXT("config"), 'f', ACE_Get_Opt::ARG_REQUIRED);  
 cmd_opts.long_option(ACE_TEXT("segment"), 's', ACE_Get_Opt::ARG_REQUIRED);  
 
 cmd_opts.long_option(ACE_TEXT("CONFIG"), 'f', ACE_Get_Opt::ARG_REQUIRED);  
 cmd_opts.long_option(ACE_TEXT("SEGMENT"), 's', ACE_Get_Opt::ARG_REQUIRED);  
 
 while((opt = cmd_opts()) != EOF)  
 {  
  switch(opt)  
  {  
   case 'f':  
   case 'F':  
    {  
     ACE_OS_String::strcpy(strCfgFile, cmd_opts.opt_arg());  
    }  
    break;  
 
   case 's':  
   case 'S':  
    {  
     ACE_OS_String::strcpy(strSegName, cmd_opts.opt_arg());  
    }  
    break;  
 
   case 'v':  
   case 'V':  
    {  
     ACE_DEBUG((LM_INFO, ACE_TEXT("test the configuration with ace\n")));  
    }  
    break;  
  }  
 }  
 
 ACE_DEBUG( (LM_INFO, 
ACE_TEXT("You entered ---> CfgFileName: %s;  SegName: %s\n")
, strCfgFile, strSegName) );  
 
 //declare a configuration object  
 ACE_Configuration_Heap config;  
 
 if(config.open() == -1)  
 {  
  ACE_ERROR_RETURN( (LM_ERROR, 
ACE_TEXT("--->failed to open the configuration object[%p]"), 
ACE_TEXT("open_config")), -1);  
 }  
 
 //declare a importer of config, and import the configuration-file  
 ACE_Registry_ImpExp config_importer(config);  
 if(config_importer.import_config(ACE_TEXT(strCfgFile)) == -1)  
 {  
  ACE_ERROR_RETURN( (LM_ERROR, 
ACE_TEXT("--->failed to import config-file %s[%p]\n"), 
strCfgFile, ACE_TEXT("import_config()")), -2);  
 }  
 
 //declare a section-key pair, and open this section with the config-object;  
 ACE_Configuration_Section_Key status_section;  
 if(config.open_section(config.root_section(), 
ACE_TEXT(strSegName), 0, status_section) == -1)  
 {  
  ACE_ERROR_RETURN( (LM_ERROR, ACE_TEXT("--->failed to open section %s[%p]\n"),
 strSegName, ACE_TEXT("open_section(LOG_IMPORT)")), -3 );  
 }  
 
 //get port  
 ACE_TString port = "";  
 if(config.get_string_value(status_section, ACE_TEXT("Port"), port) == -1)  
 {  
  ACE_ERROR_RETURN( (LM_ERROR, ACE_TEXT("--->failed to get HOST PORT[%p]\n"),
 ACE_TEXT("get_string_value(Port)")), -4 );  
 }  
 
 //get host ip  
 ACE_TString strHostIP = "";  
 if(config.get_string_value(status_section, ACE_TEXT("HostIP"), strHostIP) == -1)  
 {  
  ACE_ERROR_RETURN( (LM_ERROR, ACE_TEXT("--->failed to get HOST IP[%p]\n"),
 ACE_TEXT("get_string_value()")), -5 );  
 }  
 
 ACE_DEBUG( (LM_INFO, ACE_TEXT("IP: %s\nPort: %d\n"), strHostIP.c_str(),
 ACE_OS::atoi(port.c_str())) );  
 return 0;  
}