lib/appconfig.hpp

Go to the documentation of this file.

/*
  APPCONFIG.hpp  -  for global initialization and configuration 
 
  Copyright (C)         Lumiera.org
    2008,               Hermann Vosseler <Ichthyostega@web.de>
 
  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of the
  License, or (at your option) any later version.
 
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.
 
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 
*/

#ifndef LUMIERA_APPCONFIG_H
#define LUMIERA_APPCONFIG_H

#include <map>
#include <string>
#include <boost/scoped_ptr.hpp>
#include <boost/noncopyable.hpp>
#include "lib/lifecycleregistry.hpp"



namespace lumiera
  {
  using std::string;
  using boost::scoped_ptr;
  using boost::noncopyable;


  class Appconfig
    : private noncopyable
    {
    private:
      Appconfig ();
      
      ~Appconfig ()  throw()   {};  
      friend void boost::checked_delete<Appconfig>(Appconfig*);

      
    public:
      static Appconfig& instance()
      {
        static scoped_ptr<Appconfig> theApp_ (0);
        if (!theApp_) theApp_.reset (new Appconfig ());
        return *theApp_;
      }
      
      
      static const string & get (const string& key);  // never throws
      
      static void lifecycle (Symbol eventLabel);
      
      // note: if necessary, we can add support 
      // for querying the current lifecycle phase...
      
    private:
      typedef std::map<string,string> Configmap; 
      typedef scoped_ptr<Configmap> PConfig;
      typedef scoped_ptr<LifecycleRegistry> PLife;
      
      PConfig configParam_;
      PLife lifecycleHooks_;
      
      friend class LifecycleHook;
      
    };
    
  
  extern Symbol ON_BASIC_INIT;      
  extern Symbol ON_GLOBAL_INIT;     
  extern Symbol ON_GLOBAL_SHUTDOWN; 
  
  // client code is free to register and use additional lifecycle events
  
  
  class LifecycleHook
    : private noncopyable
    {
    public:
      LifecycleHook (Symbol eventLabel, LifecycleRegistry::Hook callbackFun);
      
      LifecycleHook& add (Symbol eventLabel, LifecycleRegistry::Hook callbackFun); 
    };



} // namespace lumiera


extern "C" {  //TODO provide a separate header if some C code happens to need this...

  void lumiera_LifecycleHook_add (const char* eventLabel, void callbackFun(void));
  void lumiera_Lifecycle_execute (const char* eventLabel);
  const char* lumiera_Appconfig_get (const char* key);
  
}


#endif

---