lifecycle.cpp

Go to the documentation of this file.

/*
  Lifecycle  -  registering and triggering lifecycle callbacks
 
   Copyright (C)
     2008,2017        Hermann Vosseler <Ichthyostega@web.de>
 
 **Lumiera** 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. See the file COPYING for further details.
 
* *****************************************************************/
 
 
#include "lib/error.hpp"
#include "include/lifecycle.h"
#include "lib/lifecycleregistry.hpp"
#include "lib/util.hpp"
 
 
 
 
namespace lumiera {
  
  // ==== implementation Lifecycle Registry =======
  
  LifecycleRegistry&
  LifecycleRegistry::instance()
  {
    static LifecycleRegistry theRegistry;
    return theRegistry;   // Meyer's singleton
  }
  
  
  
  // ==== implementation LifecycleHook class =======
  
  using Callback = LifecycleRegistry::Hook;
  
  
  LifecycleHook::LifecycleHook (Symbol eventLabel, Callback callbackFun)
  {
    add (eventLabel,callbackFun);
  }
  
  void
  LifecycleHook::add (Symbol eventLabel, Callback callbackFun)
  {
    bool isNew = LifecycleRegistry::instance().enrol (eventLabel,callbackFun);
    
    if (isNew and eventLabel == ON_BASIC_INIT)
      callbackFun();  // when this code executes,
                     //  then per definition we are already post "basic init"
                    //   (which happens in the AppState ctor); thus fire it immediately
  }
  
  
  void
  LifecycleHook::trigger (Symbol eventLabel)
  {
    LifecycleRegistry::instance().execute (eventLabel);
  }
  
  
  
  CStr ON_BASIC_INIT      ("ON_BASIC_INIT");
  CStr ON_GLOBAL_INIT     ("ON_GLOBAL_INIT");
  CStr ON_GLOBAL_SHUTDOWN ("ON_GLOBAL_SHUTDOWN");
  
  CStr ON_EMERGENCY       ("ON_EMERGENCY");
  
  
} // namespace lumiera
 
 
extern "C" { /* ==== implementation C interface for lifecycle hooks ======= */
  
  
  const char * lumiera_ON_BASIC_INIT       = lumiera::ON_BASIC_INIT;
  const char * lumiera_ON_GLOBAL_INIT      = lumiera::ON_GLOBAL_INIT;
  const char * lumiera_ON_GLOBAL_SHUTDOWN  = lumiera::ON_GLOBAL_SHUTDOWN;
  
  const char * lumiera_ON_EMERGENCY        = lumiera::ON_EMERGENCY;
  
  
  
  void
  lumiera_LifecycleHook_add (const char* eventLabel, void callbackFun(void))
  {
    lumiera::LifecycleHook (eventLabel, callbackFun);
  }
  
  
  void
  lumiera_Lifecycle_trigger (const char* eventLabel)
  {
    lumiera::LifecycleRegistry::instance().execute (eventLabel);
  }
  
}