Config.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:7k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_CONFIG_HXX)
  2. #define VOCAL_CONFIG_HXX
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF ,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const Config_hxx_Version = 
  53.   "$Id: Config.hxx,v 1.2 2001/05/24 11:01:37 icahoon Exp $";
  54. #include "RWMutex.hxx"
  55. #include "IPAddress.hxx"
  56. #include "GetOpt.hxx"
  57. #include "NameValue.hxx"
  58. #include "Writer.hxx"
  59. #include <string>
  60. #include <list>
  61. /** Vovida Open Communication Application Library.<br><br>
  62.  */
  63. namespace Vocal 
  64. {
  65. /** 
  66.  */
  67. namespace Configuration
  68. {
  69. using Vocal::IO::Writer;
  70. using Vocal::Transport::IPAddress;
  71. using Vocal::Threads::RWMutex;
  72. using Vocal::ReturnCode;
  73. using Vocal::Configuration::GetOpt;
  74. using Vocal::Configuration::NameValueMap;
  75. /** 
  76.  */
  77. class Config : public Vocal::IO::Writer
  78. {
  79.     public:
  80.      /** Creates the configuration information. The defaults are
  81.  *  set here.
  82.  */
  83.      Config();
  84.      /** Destroys the configuration information.
  85.       */
  86.      virtual ~Config();
  87.         /** Provide the usage to the user.
  88.          */
  89.         virtual void        usage() const;
  90.         
  91.         /** Provide the error message when the config file parsing fails.
  92.          */
  93.         virtual void        loadCfgFileErrorMsg(ReturnCode) const;
  94.         
  95.         
  96.         /** Provide the error message when loading provisioning fails.
  97.          */
  98.         virtual void        loadProvisioningErrorMsg(ReturnCode) const;
  99.         
  100.         
  101.      /** Loads the configuration information from the command line.
  102.  *  The command line may in turn load information from 
  103.  *  a configuration and/or a provisioning server.
  104.  */
  105. ReturnCode     load(int, char **);
  106.     
  107.         /** The user has the ability to modify the options before
  108.          *  it is used to parse the command line.
  109.          */
  110.         virtual ReturnCode  preParse();
  111.         
  112.         
  113.         /** The user has the ability to query the options after
  114.          *  it has been used to parse the command line.
  115.          */
  116.         virtual ReturnCode  postParse();
  117.         
  118.      /** If set, it is the configuration file used to configure the
  119.  *  application.
  120.  */
  121. string          configFile() const;
  122. /** If set, these are the ip addresses of the provisioning servers 
  123.  *  used to configure the application.
  124.  */
  125. list<IPAddress>     pservers() const;
  126.         /** Get the new pid. Useful if you have been Daemon-ed.
  127.          */
  128.         void                pid();
  129.         
  130.         
  131.      /** Accessor for process id. A good thing to know.
  132.  */
  133. pid_t          pid() const;
  134. /** Flag indicates whether we are running as a daemon or not.
  135.  */
  136. bool          asDaemon() const;
  137.      /** Flag indicates at which log level to run.
  138.  */
  139. int           logLevel() const;
  140. /** Flag indicates if we are being run under the debugger.
  141.  */
  142. bool          underDebugger() const;
  143.         /** Provides the name of the application.
  144.          */
  145.         string              applicationName() const;
  146.         
  147.         
  148.         /** The config file loads is xml.
  149.          */
  150.         bool                xmlConfig() const;
  151.         /** Returns a copy of the map of all options set.
  152.          */
  153.         const NameValueMap  options() const;
  154.         
  155.         
  156.      /** If we need to dump it to a log.
  157.  */
  158.         virtual ostream &   writeTo(ostream &) const;
  159.     protected:
  160.         string  cfgStr;
  161.         string  pserverStr;
  162.         string  nodaemonStr;
  163.         string  loglevelStr;
  164.         string  debuggerStr;
  165.         string  xmlcfgStr;
  166.         char    cfgChar;
  167.         char    pserverChar;
  168.         char    nodaemonChar;
  169.         char    loglevelChar;
  170.         char    debuggerChar;
  171.         char    xmlcfgChar;
  172.      /** Parse the command line. The mutex is write locked on entry.
  173.  */
  174.      virtual ReturnCode   parseCmdLine(int argc, char ** argv);
  175. /** Load configuration from a file. The mutex is write locked on entry.
  176.  */
  177. virtual ReturnCode   loadCfgFile();
  178. /** Load configuration from a provisioning server. The mutex is write 
  179.          *  locked on entry.
  180.  */
  181. virtual ReturnCode   loadProvisioning();
  182.      /** If set, it is the configuration file used to configure the
  183.  *  application.
  184.  */
  185. string          myConfigFile;
  186.         
  187. /** If set, it is the ip addresses of the provisioning servers 
  188.  *  used to configure the application.
  189.  */
  190. list<IPAddress>     myPservers;
  191.      /** It's a good thing to know.
  192.  */
  193. pid_t          myPid;
  194. /** Flag indicates whether we are running as a daemon or not.
  195.  */
  196. bool          myAsDaemon;
  197.      /** Flag indicates at which log level to run.
  198.  */
  199. int           myLogLevel;
  200. /** Flag indicates if we are being run under the debugger.
  201.  */
  202. bool          myUnderDebugger;
  203.         /** Application name
  204.          */
  205.         string              myApplicationName;
  206.         /** Should we load an xml cfg file?
  207.          */
  208.         bool                myXmlCfg;
  209.         /** My options
  210.          */
  211.         GetOpt              myOptions;
  212.                 
  213.         
  214.      /** Provide safe mutlithreaded access.
  215.  */
  216. mutable RWMutex     myMutex;
  217.     private:
  218.     
  219.         void    populate();
  220. };
  221. } // namespace Configuration
  222. } // namespace Vocal
  223. #endif // !defined(VOCAL_CONFIG_HXX)