| 1 | /*
 | 
|---|
| 2 |  * Reaction.hpp
 | 
|---|
| 3 |  *
 | 
|---|
| 4 |  *  Created on: Oct 13, 2011
 | 
|---|
| 5 |  *      Author: heber
 | 
|---|
| 6 |  */
 | 
|---|
| 7 | 
 | 
|---|
| 8 | #ifndef REACTION_HPP_
 | 
|---|
| 9 | #define REACTION_HPP_
 | 
|---|
| 10 | 
 | 
|---|
| 11 | // include config.h
 | 
|---|
| 12 | #ifdef HAVE_CONFIG_H
 | 
|---|
| 13 | #include <config.h>
 | 
|---|
| 14 | #endif
 | 
|---|
| 15 | 
 | 
|---|
| 16 | 
 | 
|---|
| 17 | #include "Actions/Action.hpp"
 | 
|---|
| 18 | 
 | 
|---|
| 19 | namespace MoleCuilder {
 | 
|---|
| 20 | 
 | 
|---|
| 21 | /**
 | 
|---|
| 22 |  * A Reaction is an Action with a return value that is set during the call and may be
 | 
|---|
| 23 |  * inspected afterwards.
 | 
|---|
| 24 |  *
 | 
|---|
| 25 |  * This class can be used in the same way as any other Action, but has some special methods
 | 
|---|
| 26 |  * for inspecting the result of the calculation.
 | 
|---|
| 27 |  */
 | 
|---|
| 28 | template<typename T>
 | 
|---|
| 29 | class Reaction : public Action
 | 
|---|
| 30 | {
 | 
|---|
| 31 | public:
 | 
|---|
| 32 |   Reaction(const ActionTrait &_trait);
 | 
|---|
| 33 |   virtual ~Reaction();
 | 
|---|
| 34 | 
 | 
|---|
| 35 |   /**
 | 
|---|
| 36 |    * Reimplemented call method for Action Base class.
 | 
|---|
| 37 |    * Resets the result and then redoes the calculation. Can be used to retrigger calculations
 | 
|---|
| 38 |    * from menu Items or other places.
 | 
|---|
| 39 |    */
 | 
|---|
| 40 |   virtual bool canUndo();
 | 
|---|
| 41 | 
 | 
|---|
| 42 |   virtual bool shouldUndo();
 | 
|---|
| 43 | 
 | 
|---|
| 44 |   virtual void outputAsCLI(std::ostream &ost) const;
 | 
|---|
| 45 |   virtual void outputAsPython(std::ostream &ost, const std::string &prefix) const;
 | 
|---|
| 46 | 
 | 
|---|
| 47 |   /**
 | 
|---|
| 48 |    * Does the actual calculation and returns the result.
 | 
|---|
| 49 |    * When the calculation has been done before it is not redone, but the previous cached result is returned.
 | 
|---|
| 50 |    * Call reset to delete the cached value.
 | 
|---|
| 51 |    */
 | 
|---|
| 52 |   virtual T operator()();
 | 
|---|
| 53 | 
 | 
|---|
| 54 |   /**
 | 
|---|
| 55 |    * Check if a cached result is available.
 | 
|---|
| 56 |    */
 | 
|---|
| 57 |   virtual bool hasResult() const;
 | 
|---|
| 58 | 
 | 
|---|
| 59 |   /**
 | 
|---|
| 60 |    * Get the cached result.
 | 
|---|
| 61 |    * Fails if there is no cached result.
 | 
|---|
| 62 |    */
 | 
|---|
| 63 |   virtual T getResult() const;
 | 
|---|
| 64 | 
 | 
|---|
| 65 |   /**
 | 
|---|
| 66 |    * Delete a previously calculated result from the cache.
 | 
|---|
| 67 |    */
 | 
|---|
| 68 |   virtual void reset();
 | 
|---|
| 69 | 
 | 
|---|
| 70 | protected:
 | 
|---|
| 71 |   virtual Dialog *fillDialog(Dialog *dialog)=0;
 | 
|---|
| 72 | 
 | 
|---|
| 73 | protected:
 | 
|---|
| 74 |   //!> result of the calculation
 | 
|---|
| 75 |   T* result;
 | 
|---|
| 76 | 
 | 
|---|
| 77 |   /**
 | 
|---|
| 78 |    * Pure virtual method for implementation of the actual calculation procedure.
 | 
|---|
| 79 |    */
 | 
|---|
| 80 |   virtual T* doCalc()=0;
 | 
|---|
| 81 | private:
 | 
|---|
| 82 |   virtual ActionState::ptr performCall();
 | 
|---|
| 83 |   virtual ActionState::ptr performUndo(ActionState::ptr);
 | 
|---|
| 84 |   virtual ActionState::ptr performRedo(ActionState::ptr);
 | 
|---|
| 85 | 
 | 
|---|
| 86 |   //!> states whether result is done or not (i.e. \a result contains valid result
 | 
|---|
| 87 |   bool done;
 | 
|---|
| 88 | };
 | 
|---|
| 89 | 
 | 
|---|
| 90 | }
 | 
|---|
| 91 | 
 | 
|---|
| 92 | #endif /* REACTION_HPP_ */
 | 
|---|