src/engine/Container.hxx

   1 // Copyright (C) 2006-2014  CEA/DEN, EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License, or (at your option) any later version.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  18 //
  19
  20 #ifndef __CONTAINER_HXX__
  21 #define __CONTAINER_HXX__
  22
  23 #include "YACSlibEngineExport.hxx"
  24 #include "Exception.hxx"
  25 #include "RefCounter.hxx"
  26
  27 #include <list>
  28 #include <map>
  29
  30 namespace YACS
  31 {
  32   namespace ENGINE
  33   {
  34     class ComponentInstance;
  35     class Proc;
  36     class Task;
  37     /*!
  38      * This is an abstract class, that represents an abstract process in which ComponentInstances can be launched and run.
  39      * An instance of this will be mapped to one and only one physical container (except in the foreach context)
  40      */
  41     class YACSLIBENGINE_EXPORT Container : public RefCounter
  42     {
  43     protected:
  44       Container();
  45 #ifndef SWIG
  46       virtual ~Container();
  47 #endif
  48     public:
  49       //Execution only methods
  50       virtual std::string getDiscreminantStrOfThis(const Task *askingNode) const;
  51       virtual bool isAlreadyStarted(const Task *askingNode) const = 0;
  52       virtual void start(const Task *askingNode) throw(Exception) = 0;
  53       virtual std::string getPlacementId(const Task *askingNode) const = 0;
  54       virtual std::string getFullPlacementId(const Task *askingNode) const = 0;
  55       //Edition only methods
  56       virtual void attachOnCloning() const;
  57       virtual void dettachOnCloning() const;
  58       virtual bool isAttachedOnCloning() const;
  59       virtual void lock() = 0;
  60       virtual void unLock() = 0;
  61       //! \b WARNING ! clone behaviour \b MUST be in coherence with what is returned by isAttachedOnCloning() method
  62       virtual Container *clone() const = 0;
  63       virtual Container *cloneAlways() const = 0;
  64       virtual bool isSupportingRTODefNbOfComp() const;
  65       virtual void checkCapabilityToDealWith(const ComponentInstance *inst) const throw(Exception) = 0;
  66       virtual void setProperty(const std::string& name,const std::string& value) = 0;
  67       virtual std::string getProperty(const std::string& name) const = 0;
  68       virtual void clearProperties() = 0;
  69       virtual void addComponentName(const std::string& name) = 0;
  70       virtual std::map<std::string,std::string> getProperties() const = 0;
  71       virtual std::map<std::string,std::string> getResourceProperties(const std::string& name) const = 0;
  72       virtual void setProperties(const std::map<std::string,std::string>& properties);
  73       std::string getName() const { return _name; }
  74       //! \b WARNING ! name is used in edition to identify different containers, it is not the runtime name of the container
  75       void setName(std::string name) { _name = name; }
  76       void setProc(Proc* proc) { _proc = proc; }
  77       Proc* getProc() { return _proc; }
  78       virtual void shutdown(int level) = 0;
  79     protected:
  80       std::string _name;
  81       mutable bool _isAttachedOnCloning;
  82       Proc* _proc;
  83     };
  84   }
  85 }
  86
  87 #endif