1 // Copyright (C) 2006-2016 CEA/DEN, EDF R&D
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.
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.
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
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
23 #include "YACSlibEngineExport.hxx"
24 #include "PlayGround.hxx"
25 #include "AutoRefCnt.hxx"
27 #include "OutGate.hxx"
28 #include "Exception.hxx"
40 void YACSLIBENGINE_EXPORT StateLoader(Node* node, YACS::StatesForNode state);
53 class InputDataStreamPort;
54 class OutputDataStreamPort;
63 class YACSLIBENGINE_EXPORT NodeStateNameMap : public std::map<YACS::StatesForNode, std::string>
69 class YACSLIBENGINE_EXPORT Node
74 friend class InputPort;
75 friend class OutputPort;
76 friend class InPropertyPort;
77 friend class DynParaLoop;
78 friend class ForEachLoop;
79 friend class ComposedNode;
80 friend class ElementaryNode;
82 friend void StateLoader(Node* node, YACS::StatesForNode state);
84 mutable YACS::Colour _colour;
88 InPropertyPort * _inPropertyPort;
90 ComposedNode *_father;
91 YACS::StatesForNode _state;
93 std::string _errorDetails;
94 static const char SEP_CHAR_IN_PORT[];
97 std::string _implementation;
98 std::map<std::string,std::string> _propertyMap;
100 Node(const std::string& name);
101 Node(const Node& other, ComposedNode *father);
102 //! performs a duplication of placement using clone method of containers and components. clone behaviour is driven by attachOnCloning attribute.
103 virtual void performDuplicationOfPlacement(const Node& other) = 0;
104 //! performs a also duplication of placement but here containers and components are not copied at all whatever the value of attachedOnCloning.
105 virtual void performShallowDuplicationOfPlacement(const Node& other) = 0;
106 virtual Node *simpleClone(ComposedNode *father, bool editionOnly=true) const = 0;
109 virtual void init(bool start=true);
110 virtual void shutdown(int level);
111 virtual void resetState(int level);
112 //! \b This method \b MUST \b NEVER \b BE \b VIRTUAL
113 Node *clone(ComposedNode *father, bool editionOnly=true) const;
114 //! \b This method \b MUST \b NEVER \b BE \b VIRTUAL
115 Node *cloneWithoutCompAndContDeepCpy(ComposedNode *father, bool editionOnly=true) const;
116 void setState(YACS::StatesForNode theState); // To centralize state changes
117 virtual YACS::StatesForNode getState() const { return _state; }
118 virtual YACS::StatesForNode getEffectiveState() const;
119 virtual YACS::StatesForNode getEffectiveState(const Node*) const;
120 std::string getColorState(YACS::StatesForNode state) const;
121 static std::string getStateName(YACS::StatesForNode state);
122 InGate *getInGate() { return &_inGate; }
123 OutGate *getOutGate() { return &_outGate; }
124 const std::string& getName() const { return _name; }
125 void setName(const std::string& name);
126 ComposedNode * getFather() const { return _father; }
127 const std::string getId() const;
128 bool exIsControlReady() const;
129 std::list<Node *> getOutNodes() const;
130 virtual void writeDot(std::ostream &os) const;
131 virtual void exUpdateState();
132 virtual void exFailedState();
133 virtual void exDisabledState();
134 virtual void getReadyTasks(std::vector<Task *>& tasks) = 0;
135 virtual std::list<ElementaryNode *> getRecursiveConstituents() const = 0;
136 virtual std::list<ProgressWeight> getProgressWeight() const = 0;
137 virtual int getNumberOfInputPorts() const = 0;
138 virtual int getNumberOfOutputPorts() const = 0;
139 std::list<InPort *> getSetOfInPort() const;
140 std::list<OutPort *> getSetOfOutPort() const;
141 virtual std::list<InputPort *> getSetOfInputPort() const = 0;
142 virtual std::list<OutputPort *> getSetOfOutputPort() const = 0;
143 virtual std::list<InputPort *> getLocalInputPorts() const = 0;
144 virtual std::list<OutputPort *> getLocalOutputPorts() const = 0;
145 virtual std::set<InputPort *> edGetSetOfUnitializedInputPort() const;
146 virtual bool edAreAllInputPortInitialized() const;
147 virtual std::string getInPortName(const InPort *) const throw (Exception) = 0;
148 virtual std::string getOutPortName(const OutPort *) const throw (Exception) = 0;
149 virtual std::list<InputDataStreamPort *> getSetOfInputDataStreamPort() const = 0;
150 virtual std::list<OutputDataStreamPort *> getSetOfOutputDataStreamPort() const = 0;
151 InPort *getInPort(const std::string& name) const throw(Exception);
152 InPropertyPort *getInPropertyPort() const throw(Exception);
153 virtual OutPort *getOutPort(const std::string& name) const throw(Exception);
154 virtual std::set<OutPort *> getAllOutPortsLeavingCurrentScope() const = 0;
155 virtual std::set<InPort *> getAllInPortsComingFromOutsideOfCurrentScope() const = 0;
156 virtual std::vector< std::pair<OutPort *, InPort *> > getSetOfLinksLeavingCurrentScope() const = 0;
157 virtual std::vector< std::pair<InPort *, OutPort *> > getSetOfLinksComingInCurrentScope() const =0;
158 virtual InputPort *getInputPort(const std::string& name) const throw(Exception);
159 virtual OutputPort *getOutputPort(const std::string& name) const throw(Exception) = 0;
160 virtual InputDataStreamPort *getInputDataStreamPort(const std::string& name) const throw(Exception) = 0;
161 virtual OutputDataStreamPort *getOutputDataStreamPort(const std::string& name) const throw(Exception) = 0;
162 std::list<ComposedNode *> getAllAscendanceOf(ComposedNode *levelToStop = 0) const;
163 bool operator>(const Node& other) const;
164 bool operator<(const Node& other) const;
165 std::string getImplementation() const;
166 DynParaLoop *getClosestDPLAmongAncestors() const;
167 virtual ComposedNode *getRootNode() const throw(Exception);
168 virtual void setProperty(const std::string& name,const std::string& value);
169 virtual std::string getProperty(const std::string& name);
170 std::map<std::string,std::string> getProperties() ;
171 std::map<std::string,std::string> getPropertyMap() { return _propertyMap; }
172 virtual void setProperties(std::map<std::string,std::string> properties);
173 virtual Node *getChildByName(const std::string& name) const throw(Exception) = 0;
174 virtual Proc *getProc();
175 virtual const Proc *getProc() const;
176 virtual void accept(Visitor *visitor) = 0;
177 virtual int getMaxLevelOfParallelism() const = 0;
178 virtual double getWeightRegardingDPL() const = 0;
179 virtual void partitionRegardingDPL(const PartDefinition *pd, std::map<ComposedNode *, YACS::BASES::AutoRefCnt<PartDefinition> >& zeMap) = 0;
180 std::string getQualifiedName() const;
182 std::vector<std::pair<std::string,int> > getDPLScopeInfo(ComposedNode *gfn);
183 virtual void applyDPLScope(ComposedNode *gfn);
184 virtual void sendEvent(const std::string& event);
185 virtual void sendEvent2(const std::string& event, void *something);
186 static std::map<int,Node *> idMap;
187 virtual std::string typeName() { return "YACS__ENGINE__Node"; }
188 virtual std::string getErrorDetails() const { return _errorDetails; }
189 virtual void setErrorDetails(const std::string& error) { _errorDetails=error; }
190 virtual void modified();
191 virtual int isModified() { return _modified; }
192 virtual int isValid();
193 virtual void edUpdateState();
194 virtual std::string getErrorReport();
195 virtual std::string getContainerLog();
196 virtual void ensureLoading();
197 virtual void getCoupledNodes(std::set<Task*>& coupledNodes) { }
198 virtual void cleanNodes();
200 virtual void exForwardFailed();
201 virtual void exForwardFinished();
202 virtual void edDisconnectAllLinksWithMe();
203 static void checkValidityOfPortName(const std::string& name) throw(Exception);
204 static ComposedNode *checkHavingCommonFather(Node *node1, Node *node2) throw(Exception);