/* SINGLETONPRECONFIGURE - declare the configuration of some Singleton types in advance Copyright (C) Lumiera.org 2008, Hermann Vosseler 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. */ /** @file singletonpreconfigure.hpp ** Preconfiguration of some Singleton types, done by template specialisation. ** Typically the client code just includes singleton.h and uses the Singleton ** type. But in some cases, we want to configure specific (dependency injection) ** behaviour at a central location. At some point, we may well have a full blown ** Dependency Manager, but for the moment using just some specialized Singleton ** type for some instances seems sufficient. ** ** One reason why one wants special Singleton behaviour is testing: Without ** altering the executable, for running some tests we need to inject a Test Mock ** in place of some service object, so we can verify the behaviour of the code ** using this service. For this, we mix lumiera::test::MockInjector ** into the actual Singleton type. ** ** @note we declare the specialisations into the target namespace ** ** @see SingletonFactory ** @see singletontestmocktest.hpp */ #ifndef LUMIERA_SINGLETONPRECONFIGURE_H #define LUMIERA_SINGLETONPRECONFIGURE_H #include "lib/test/mockinjector.hpp" namespace lumiera { /** * Default Singleton configuration * @note all Policy template parameters taking default values */ template class Singleton : public SingletonFactory { } ; /* ********************************************************************** */ /* Forward declarations of all Classes we want to specialise the template */ /* ********************************************************************** */ namespace test { class TestSingletonO; using lumiera::Singleton; } // namespace test } // namespace lumiera namespace backend_interface { class MediaAccessFacade; using lumiera::Singleton; } // namespace backend_interface /* ************************** */ /* Specialisation Definitions */ /* ************************** */ namespace lumiera { using test::MockInjector; template<> class Singleton : public MockInjector { }; template<> class Singleton : public MockInjector { }; } // namespace lumiera #endif