lumiera_documentation/tests/basics/singleton-subclass-test.cpp
Ichthyostega 9c74466778 Tests: build an link a test-support library
This is something I wanted to clean-up since a very long time indeed,
but always postponed it, since it requires a lot of nasty clean-up and disentangling....

Several parts had been stashed away into `src/lib/test`, which are not really related:
 * the testrunner and testsuite builder
 * generic helper utilities
 * specialised test-support facilities, e.g. the EventLog

This changeset introduces a new top-level test folder and a namespace `::test`
Code from this folder is linked into a shared library `libtestsupport.so`,
which resides in the linkage hierarchy between »Vessel« and »Vault«,
yet is no longer part of the Lumiera application and only linked into the test-suite.
2026-03-06 23:16:32 +01:00

144 lines
3.9 KiB
C++
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
SingletonSubclass(Test) - actually creating a subclass of the Singleton Type
Copyright (C)
2008, 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.
* *****************************************************************/
/** @file singleton-subclass-test.cpp
** unit test \ref SingletonSubclass_test
*/
#include "test/run.hpp"
#include "test/test-helper.hpp"
#include "lib/format-string.hpp"
#include "lib/format-cout.hpp"
#include "lib/util.hpp"
#include "test-target-obj.hpp"
#include "lib/depend.hpp"
#include "lib/depend-inject.hpp"
#include <boost/lexical_cast.hpp>
using boost::lexical_cast;
using util::isSameObject;
using util::_Fmt;
using util::isnil;
using std::string;
namespace lib {
namespace test{
using LERR_(LIFECYCLE);
/**
* Target object to be instantiated as Singleton
* Allocates a variable amount of additional heap memory
* and prints diagnostic messages.
*/
class Interface : public TestTargetObj
{
public:
static int cnt;
static void setCountParam (uint c) { Interface::cnt = c; }
virtual string identify() { return "Interface"; }
protected:
Interface () : TestTargetObj(cnt) {}
virtual ~Interface() {}
friend class lib::DependencyFactory<Interface>;
};
int Interface::cnt = 0;
class Impl : public Interface
{
public:
virtual string identify() { return "Implementation"; }
};
// for checking the safety.....
class Impl_XXX : public Impl { };
class Unrelated { };
/***************************************************************//**
* @test specific dependency-injection setup, to create a singleton
* subclass (implementation class) instance, without coupling
* the caller to the concrete type.
* @remark Expected results: an instance of the subclass is created.
* @see lib::Depend
* @see lib/depend-inject.hpp
*/
class SingletonSubclass_test : public Test
{
virtual void
run(Arg arg)
{
uint num{firstVal (arg)};
cout << _Fmt("using the Singleton should create TargetObj(%d)...\n") % num;
Interface::setCountParam(num);
// configuration to use the subclass on demand
DependInject<Interface>::useSingleton<Impl>();
// define an instance of the Singleton factory as always...
Depend<Interface> instance;
// Now use the Singleton factory...
// Note: we get the Base type
Interface& t1 = instance();
Interface& t2 = instance();
CHECK (isSameObject (t1, t2), "not a Singleton, got two different instances." );
CHECK ( INSTANCEOF (Impl,&t1)); // got the subclass as expected
CHECK ("Implementation" == t2.identify());
cout << "calling a non-static method on the Singleton-"
<< t1.identify() << endl
<< t1 << endl;
verify_error_detection ();
}
void
verify_error_detection ()
{
VERIFY_ERROR (LIFECYCLE, DependInject<Interface>::useSingleton<Impl_XXX>() );
Depend<Interface> newFactory;
CHECK ( INSTANCEOF (Impl, &newFactory() )); // works as before
//////////does not compile due to incompatible baseclass
// DependInject<Interface>::useSingleton<Unrelated>();
}
};
/** Register this test class... */
LAUNCHER (SingletonSubclass_test, "unit common");
}} // namespace lib::test