ICE的属性配置 c++

 

2009-07-12 13:53:30 作者：毛毛 来源：www.cppprog.com =

本文介绍了如何通过命令行参数或配置文件设置ICE的行为
 

在前一篇文章中，大家可能都注意到了一个细节，Ice的初始化函数initialize的输入参数正好是主函数的输入参数，也就是命令行参数（注：辅助类Ice::Application也调用了initialize函数）。

Ice的初始化函数得到命令行参数后，抽取出Ice专有参数，并把分析后的配置存入到Ice的属性表中。

假设命令行为：

MyProg.exe --myoption --Ice.Config=config\
     -x a --Ice.Trace.Network=3 -y opt file

其中MyProg.exe是我们用Ice编写的程序，当Ice::initialize返回时，Ice的两个专用参数就会被抽去，argc由原来的9变成7，argv为:

  1. MyProg.exe
  2. --myoption
  3. -x
  4. a
  5. -y
  6. opt
  7. file

抽去的两个参数则存放于属性表里。属性表的类型为Ice::Properties，它的常用方法有:

  1. std::string getProperty(const std::string& prop);
  2. std::string getPropertyWithDefault(const std::string& prop, const std::string&);
  3. Ice::Int getPropertyAsInt(const std::string& prop);
  4. Ice::Int getPropertyAsIntWithDefault(const std::string& prop, Ice::Int);

取得prop属性的值

  1. Ice::StringSeq getPropertyAsList(const ::std::string& prop);
  2. Ice::StringSeq getPropertyAsListWithDefault(const ::std::string& prop, const ::Ice::StringSeq&);

取得prop属性的值，并返回按逗号分割成的一组值。这里的Ice::StringSeq就是std::vector<std::string>(注：集合类型可通过配置改变，默认是vector)。
比如：有命令行参数： --MyProp.Test=abc,def,aaa,sde,s 则返回

abc
def
aaa
sde
s

 

  1. Ice::PropertyDict getPropertiesForPrefix(const ::std::string& prefix);

返回所有含有prefix前缀的所有属性，PropertyDict是一个std::map<std::string, std::string>类型的数据表。

  1. void setProperty(const ::std::string& prop, const ::std::string&);

设置prop属性的值

  1. Ice::StringSeq getCommandLineOptions();

把属性表中的所有数据转化成字符串列表

  1. Ice::StringSeq parseCommandLineOptions(
  2.     const std::string& prefix, const Ice::StringSeq& args);

分析命令行参数，抽取出所有prefix前缀的参数，返回剩余的命令行参数。由于main函数输入的是argc和argv，我们可以使用Ice::StringSeq argsToStringSeq(int, char*[])和void stringSeqToArgs(const StringSeq&, int&, char*[])函数在StringSeq与argc/argv之间互相转换。

  1. Ice::StringSeq parseIceCommandLineOptions(const Ice::StringSeq&);

分析Ice专有命令行参数

  1. void load(const std::string& file);

载入file指定的配置文件，关于配置文件后文还会讲到

  1. Ice::PropertiesPtr clone()

返回一个属性表的拷贝

下面是获得属性表的两个常用方式：

  1. Ice::PropertiesPtr createProperties();

生成一个全新的属性表

  1. Ice::PropertiesPtr Ice::Communicator::getProperties();

从连接器中取得当前使用的属性表

利用属性表改进我们的程序

比如，我们前面的客户端的例子：

  1. class MyApp: public Ice::Application{
  2. public:
  3.     virtual int run(int, char*[])
  4.     {
  5.         Ice::CommunicatorPtr ic = communicator();
  6.         Ice::ObjectPrx base = 
  7.             ic->stringToProxy("SimplePrinter:default -p 10000");
  8.         PrinterPrx printer =  PrinterPrx::checkedCast(base);
  9.         if(!printer) throw "Invalid Proxy!";
  10.         printer->printString("Hello World!");
  11.         return 0;
  12.     }
  13. };

ic->stringToProxy("SimplePrinter:default -p 10000");这句把代理名、协议、端口以及主机名都固化在了程序中。有时，我们需要更大的灵活性，比如由命令行参数或配置文件指定它们，上面提到的Properties接口就可以帮我们：

  1. class MyApp: public Ice::Application{
  2. public:
  3.     virtual int run(int, char*[])
  4.     {
  5.         Ice::CommunicatorPtr ic = communicator();
  6.         Ice::PropertiesPtr prop = ic->getProperties();
  7.         string s = prop->getPropertyWithDefault(
  8.             "Ice.Printer","SimplePrinter:default -p 10000");
  9.         Ice::ObjectPrx base = ic->stringToProxy(s);
  10.         PrinterPrx printer =  PrinterPrx::checkedCast(base);
  11.         if(!printer) throw "Invalid Proxy!";
  12.         printer->printString("Hello World!");
  13.         return 0;
  14.     }
  15. };

这里，代理字符串从属性表（Ice::Properties，Ice::PropertiesPtr是Ice::Properties的智能指针）中得到，我们只要改变命令行参数就可以改变这个字符串，如:

MyProg.exe --Ice.Printer="SimplePrinter:tcp -p 10000"
MyProg.exe --Ice.Printer="SimplePrinter:tcp -p 1234 -h 192.168.1.5"
...

可能你已经猜到，如果命令行里没有指定Ice.Printer，则使用默认的"SimplePrinter:default -p 10000"

另外，上面的:

  1. Ice::PropertiesPtr prop = ic->getProperties();
  2. string s = prop->getPropertyWithDefault(
  3.     "Ice.Printer","SimplePrinter:default -p 10000");
  4. Ice::ObjectPrx base = ic->stringToProxy(s);

三条指令可以用一条指令代替：

  1. Ice::ObjectPrx base = ic->propertyToProxy("Ice.Printer");

多写几行有时还是有用的，我们可以利用它来读取我们自定义的一些参数^_^（当然还有默认参数功能）

上面的命令行里我们取的是"Ice.Printer"属性，注意它的前缀是"Ice."，如果我们改成其它前缀，如"MyProp."，那么Ice初始化时就不认为这是Ice专用参数而不理睬它了。

我们想自定义一些属性用于“私用”的话，使用"Ice."前缀就显得不合理了，这时我们可以使用属性集的parseCommandLineOptions方法来解析指定前缀的参数:

  1. class MyApp: public Ice::Application{
  2. public:
  3.     virtual int run(int argc, char*argv[])
  4.     {
  5.         Ice::CommunicatorPtr ic = communicator();
  6.         Ice::PropertiesPtr prop = Ice::createProperties();
  7.         prop->parseCommandLineOptions("MyProp", 
  8.             Ice::argsToStringSeq(argc,argv));
  9.         string s = prop->getPropertyWithDefault(
  10.             "MyProp.Printer","SimplePrinter:default -p 10000");
  11.         Ice::ObjectPrx base = ic->stringToProxy(s);
  12.         PrinterPrx printer =  PrinterPrx::checkedCast(base);
  13.         if(!printer) throw "Invalid Proxy!";
  14.         printer->printString("Hello World!");
  15.         return 0;
  16.     }
  17. };

现在，程序可以解析MyProp.Printer属性了。

配置文件

对于少量的属性，使用命令行参数确实没什么问题，一旦自定义属性增加，使用命令行参数就显得不太合适了。

Ice允许我们把所有的属性参数写到一个文本文件里，每个参数一行，比如有：

MyProg.exe \
    --MyProp.Printer="SimplePrinter:tcp -p 1234 -h 192.168.1.5" \
    --MyProp.Test="abc,def,aaa,sde,s"

我们可以生成一个文本文件，内容：

MyProp.Printer="SimplePrinter:tcp -p 1234 -h 192.168.1.5"
MyProp.Test="abc,def,aaa,sde,s"

然后，把上面的命令行参数改成：

MyProg.exe --Ice.Config=文件名

或者使用Ice::Properties::load方法载入文件,

或者使用Ice::Properties::parseIceCommandLineOptions方法解析文本内容。

posted @ 2011-11-21 10:44  tangr206  阅读(698)  评论(0)  编辑  收藏  举报