LUMIERA.clone/src/steam/mobject/session/session-impl.hpp

/*
  SESSION-IMPL.hpp  -  holds the complete session data to be edited by the user

   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 session-impl.hpp
 ** Session and SessionServices Implementation classes.
 ** Session and the corresponding Manager are primary Interfaces
 ** to control the behaviour of the editing part of the application.
 ** All all implementation complexities are hidden behind a "PImpl".
 ** 
 ** This file contains the implementation level API, it should never
 ** be included by client code. Besides the actual SessionImpl, a set
 ** of further implementation level services is provided for use by
 ** Steam-Layer's internals. These additional SessionServices are to be
 ** accessed through dedicated headers and interface classes (typically
 ** through static access functions), thereby abstracting from the actual
 ** session implementation. Within this file, the implementation of these
 ** SessionServices is wired up with the SessionImpl object.
 ** 
 ** @see Session public API
 ** @see session-services.hpp
 ** @see session-service-access-test.cpp for a complete simplified mock session manager 
 **
 */


#ifndef STEAM_MOBJECT_SESSION_SESSIONIMPL_H
#define STEAM_MOBJECT_SESSION_SESSIONIMPL_H

#include "steam/mobject/session.hpp"
#include "steam/fixture/fixture.hpp"
#include "steam/mobject/session/placement-index.hpp"
#include "steam/mobject/session/session-services.hpp"
#include "steam/mobject/session/session-interface-modules.hpp"

#include "steam/mobject/session/session-service-fetch.hpp"
#include "steam/mobject/session/session-service-explore-scope.hpp"
#include "steam/mobject/session/session-service-mock-index.hpp"
#include "steam/mobject/session/session-service-defaults.hpp"

#include "steam/mobject/session/placement-index-query-resolver.hpp"





namespace steam {
namespace mobject {
namespace session {
  
  using fixture::PFixture;
  
  
  /**
   * Implementation class for the Session interface
   */
  class SessionImpl
    : protected SessionInterfaceModules
    , public mobject::Session
    {
      PlacementIndex contents_;
      
      PFixture fixture_;
      
      
      
      
      /* ==== Session API ==== */
      virtual bool isValid()  override;
      virtual MObjectRef attach (PMO const& placement)  override;
      virtual bool       detach (PMO const& placement)  override;
      
      virtual MObjectRef getRoot()   override;

      virtual PFixture& getFixture() override;
      virtual void rebuildFixture()  override;
      
    protected: /* == management API === */
      SessionImpl ();
      
      void clear ();
      friend class SessManagerImpl;
      
      PlacementIndex&
      getPlacementIndex()
        {
          ENSURE (contents_.isValid());
          return contents_;
        }
      
    };
  
  
  
  /* ===== providing internal services for Steam ===== */
  
  template<class IMPL>
  struct ServiceAccessPoint<SessionServiceFetch, IMPL>
    : IMPL
    {
      bool
      isRegisteredID (PMO::ID const& placementID)
        {
          return IMPL::getPlacementIndex().contains (placementID); //never throws
        }
      
      PMO&
      resolveID (PMO::ID const& placementID)
        {
          return IMPL::getPlacementIndex().find (placementID); //may throw
        }
    };
  
  
  
  
  template<class IMPL>
  struct ServiceAccessPoint<SessionServiceMutate, IMPL>
    : IMPL
    {
      PMO::ID const&
      insertCopy (PMO const& newPlacement, PMO::ID const& scope)
        {
          return index().insert (newPlacement,scope);
        }
      
      bool
      purgeScopeRecursively (PMO::ID const& scope)
        {
          size_t siz = index().size();
          if (index().contains (scope))
              index().clear (scope);
          
          ENSURE (!index().contains (scope) || (scope == index().getRoot().getID()));
          ENSURE (siz >= index().size());
          return siz != index().size();
        }
      
      bool
      detachElement (PMO::ID const& placementID)
        {
          return index().remove (placementID);
        }
      
    private:
      PlacementIndex&
      index()
        {
          return IMPL::getPlacementIndex();
        }
    };
  
  
  
  
  template<class IMPL>
  struct ServiceAccessPoint<SessionServiceExploreScope, IMPL>
    : IMPL
    {
      QueryResolver&
      getScopeQueryResolver()
        {
          return resolvingWrapper_;
        }
      
      PlacementMO&
      getScope (PlacementMO const& placement2locate)
        {
          return IMPL::getPlacementIndex().getScope(placement2locate);
        }
      
      PlacementMO&
      getScope (PlacementMO::ID const& placement2locate)
        {
          return IMPL::getPlacementIndex().getScope(placement2locate);
        }
      
      PlacementMO& 
      getScopeRoot()
        {
          return IMPL::getPlacementIndex().getRoot();
        }
      
    private:
      PlacementIndexQueryResolver resolvingWrapper_;
      
      /** indirection to use the \em currently defined
       *  index access point (might be a test mock) */
      struct
      AccessCurrentIndex
        {
          IMPL& accessPoint_;  
          PlacementIndex& operator() (void) { return accessPoint_.getPlacementIndex(); }
          
          AccessCurrentIndex (IMPL& impl) : accessPoint_(impl) { }
        };
      
    protected:
      ServiceAccessPoint()
        : resolvingWrapper_(AccessCurrentIndex (*this))
        { }
    };
  
  
  
  
  
  template<class IMPL>
  struct ServiceAccessPoint<SessionServiceMockIndex, IMPL>
    : IMPL
    {
      PlacementIndex&
      getPlacementIndex()
        {
          if (mockIndex_ && mockIndex_->isValid())
            return *mockIndex_;
          else
            return IMPL::getPlacementIndex();
        }
      
      void
      reset_PlacementIndex (PlacementIndex* alternativeIndex =0)
      {
        mockIndex_ = alternativeIndex;
      }
    
    protected:
      ServiceAccessPoint()
        : mockIndex_(0)
        { }
      
    private:
      PlacementIndex* mockIndex_;
    };
  
  
  
  template<class IMPL>
  struct ServiceAccessPoint<SessionServiceDefaults, IMPL>
    : IMPL
//    , SessionServiceDefaults
    {
      ////////////////////////////TODO
    };
  
  
  
  
  
  
  class SessManagerImpl;
  
  /** 
   * actual configuration of the session implementation compound:
   * forming an inheritance chain of all internal SesssionServices
   * stacked on top of the SessionImpl class.
   * @note SessionImplAPI is actually used within the SessManagerImpl
   *       to create "the session" instance and expose it through the
   *       global Session PImpl
   */
  using SessionImplAPI = SessionServices< Types< SessionServiceFetch
                                               , SessionServiceMutate
                                               , SessionServiceExploreScope
                                               , SessionServiceMockIndex
                                               , SessionServiceDefaults
                                               >              // List of the APIs to provide
                                        , SessManagerImpl    //  frontend for access
                                        , SessionImpl       //   implementation base class
                                        >;                 //
  
  
  
}}} // namespace steam::mobject::session
#endif