2 * ModuleBase_Operation.h
4 * Created on: Apr 2, 2014
9 #ifndef MODULEBASE_OPERATION_H
10 #define MODULEBASE_OPERATION_H
12 #include <ModuleBase.h>
21 class ModelAPI_Feature;
22 class ModelAPI_Document;
25 \class ModuleBase_Operation
26 * \brief Base class for all operations
28 * Base class for all operations. If you perform an action it is reasonable to create
29 * operation intended for this. This is a base class for all operations which provides
30 * mechanism for correct starting operations, starting operations above already started
31 * ones, committing operations and so on. To create own operation it is reasonable to
32 * inherit it from this class and redefines virtual methods to provide own behavior
33 * Main virtual methods are
34 * - virtual bool isReadyToStart();
35 * - virtual void startOperation();
36 * - virtual void abortOperation();
37 * - virtual void commitOperation();
40 class MODULEBASE_EXPORT ModuleBase_Operation: public QObject
45 /*! Enum describes state of operation */
48 Waiting, //!< Operation is not used (it is not run or suspended)
49 Running, //!< Operation is started
53 * Enum describes execution status of operation. Execution status often used after
54 * ending work of operation which was started from this one. In this case this
55 * operation can ask previously started operation whether it finished successfully.
59 Rejected, //!< Operation has not performed any action (modification of data model for example)
60 Accepted //!< Operation has performed an actions and must be stopped
64 * Enum describes setting of the operation.
68 None = 0x00, //!< None options
69 Transaction = 0x01 //!< Automatically open (commit/abort) transaction during start (commit/abort).
73 ModuleBase_Operation(const QString& theId = "", QObject* parent = 0);
74 virtual ~ModuleBase_Operation();
76 // Operation processing.
77 virtual QString operationId() const;
79 OperationState state() const;
80 bool isRunning() const;
81 virtual bool isValid(ModuleBase_Operation* theOtherOp) const;
82 virtual bool isGranted() const;
84 bool setSlot(const QObject* theReceiver, const char* theSlot);
86 void setFlags(const int);
87 void clearFlags(const int);
88 bool testFlags(const int) const;
90 int execStatus() const;
93 const QString& xmlRepresentation() const;
94 void setXmlRepresentation(const QString& xmlRepr);
100 void stopped(); //!< operation aborted or committed
109 // Data model operations.
110 void storeReal(double);
113 virtual bool isReadyToStart() const;
115 virtual void startOperation();
116 virtual void stopOperation();
117 virtual void abortOperation();
118 virtual void commitOperation();
120 void setExecStatus(const int);
121 void setState(const OperationState);
123 std::shared_ptr<ModelAPI_Document> document() const;
126 int myFlags; //!< Operation flags
127 OperationState myState; //!< Operation state
128 ExecStatus myExecStatus; //!< Execution status
130 //!< Next fields could be extracted into a subclass;
131 QString myOperationId;
133 std::shared_ptr<ModelAPI_Feature> myFeature;