handling-pattern-basics-test.cpp

Go to the documentation of this file.

/*
  HandlingPatternBasics(Test)  -  verify elementary operation of a command handling pattern
 
   Copyright (C)
     2009,            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/test/run.hpp"
#include "steam/control/command.hpp"
#include "steam/control/command-impl.hpp"
#include "steam/control/command-registry.hpp"
#include "steam/control/argument-erasure.hpp"
#include "steam/control/handling-pattern.hpp"
#include "lib/test/event-log.hpp"
 
#include "steam/control/test-dummy-commands.hpp"
 
 
namespace steam  {
namespace control{
namespace test   {
  
  using std::function;
  
  namespace { // test fixture...
    
    string TEST_CMD  = "test.command1.handling";
    HandlingPattern::ID TEST_PATTERN = HandlingPattern::DUMMY;
    
    
    class CustomHandler
      : public HandlingPattern
      {
        mutable
        lib::test::EventLog log_{"custom command handler"};
        
        
        /* ==== HandlingPattern - Interface ==== */
        
        void
        performExec (CommandImpl& command)  const override
          {
            log_.call (TEST_CMD, "exec");
            command.invokeCapture();
            command.invokeOperation();
          }
        
        void
        performUndo (CommandImpl& command)  const override
          {
            log_.call (TEST_CMD, "undo");
            command.invokeUndo();
          }
        
        bool
        isValid()  const override
          {
            return true;
          }
        
        
      public:
        bool
        invokedExec()
          {
            return log_.verifyCall("exec").on(TEST_CMD);
          }
        
        bool
        invokedUndo()
          {
            return log_.verifyCall("undo").on(TEST_CMD)
                       .afterCall("exec");
          }
      };
    
  }//(End) test fixture
  
  using PCommandImpl = shared_ptr<CommandImpl>;
  using HaPatt       = HandlingPattern const&;
  
  
  
  
  
  
  /******************************************************************************/
  class HandlingPatternBasics_test : public Test
    {
      
      uint cnt_inst;
      
      
      virtual void
      run (Arg)
        {
          seedRand();
          CommandRegistry& registry = CommandRegistry::instance();
          CHECK (&registry);
          
          cnt_inst = registry.instance_count();
          
          {
            PCommandImpl pCom = buildTestCommand(registry);
            checkExec (pCom);
            checkUndo (pCom);
            
            useCustomHandler (pCom);
          }
          
          CHECK (cnt_inst == registry.instance_count());
        }
      
      
      PCommandImpl
      buildTestCommand (CommandRegistry& registry)
        {
          
          typedef void Sig_oper(int);
          typedef long Sig_capt(int);
          typedef void Sig_undo(int,long);
          
          function<Sig_oper> o_Fun (command1::operate);
          function<Sig_capt> c_Fun (command1::capture);
          function<Sig_undo> u_Fun (command1::undoIt);
          
          CHECK (o_Fun and c_Fun and u_Fun);
          
          // when the CommandDef is complete, it issues the
          // allocation call to the registry behind the scenes....
          
          PCommandImpl pImpl = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
          CHECK (pImpl);
          CHECK (*pImpl);
          return pImpl;
        }
      
      
      void
      checkExec (PCommandImpl com)
        {
          CHECK (com);
          CHECK (not com->canExec());
          
          using ArgTuple = std::tuple<int>;
          const int ARGR{1 + rani (1000)};
          ArgTuple argTup{ARGR};
          TypedArguments<ArgTuple> arg{argTup};
          com->setArguments(arg);
          
          CHECK (com->canExec());
          CHECK (!com->canUndo());
          command1::check_ = 0;
          
          HaPatt patt = HandlingPattern::get(TEST_PATTERN);
          ExecResult res = patt.exec (*com, TEST_CMD);
          
          CHECK (res);
          CHECK (ARGR == command1::check_);
          CHECK (com->canUndo());
        }
      
      
      void
      checkUndo (PCommandImpl com)
        {
          CHECK (com);
          CHECK (com->canExec());
          CHECK (com->canUndo());
          
          CHECK (command1::check_ > 0);
          
          HaPatt ePatt = HandlingPattern::get(TEST_PATTERN);
          ExecResult res = ePatt.undo (*com, TEST_CMD);
          
          CHECK (res);
          CHECK (command1::check_ == 0);
        }
      
      
      void
      useCustomHandler (PCommandImpl com)
        {
          CustomHandler specialHandler;
          
          CHECK (com->canExec());
          CHECK (not specialHandler.invokedExec());
          
          specialHandler.exec (*com, TEST_CMD);
          CHECK (    specialHandler.invokedExec());
          CHECK (not specialHandler.invokedUndo());
          
          specialHandler.undo (*com, TEST_CMD);
          CHECK (    specialHandler.invokedExec());
        }
    };
  
  
  LAUNCHER (HandlingPatternBasics_test, "function controller");
  
  
}}} // namespace steam::control::test