TGo4Command.h

Go to the documentation of this file.

// $Id$
//-----------------------------------------------------------------------
//       The GSI Online Offline Object Oriented (Go4) Project
//         Experiment Data Processing at EE department, GSI
//-----------------------------------------------------------------------
// Copyright (C) 2000- GSI Helmholtzzentrum fuer Schwerionenforschung GmbH
//                     Planckstr. 1, 64291 Darmstadt, Germany
// Contact:            http://go4.gsi.de
//-----------------------------------------------------------------------
// This software can be used under the license agreements as stated
// in Go4License.txt file which is part of the distribution.
//-----------------------------------------------------------------------

#ifndef TGO4COMMAND_H
#define TGO4COMMAND_H

#include "TNamed.h"

class TGo4CommandReceiver;
class TGo4RemoteCommand;

enum Go4CommandMode_t {
   kGo4ComModeRefused,     // no rights
   kGo4ComModeObserver,    // client may only observe
   kGo4ComModeController,  // client has full control as user
   kGo4ComModeAdministrator // full control over everything
};

class TGo4Command  : public TNamed {
   public:

      TGo4Command();

      TGo4Command(const char *name, const char *description, Int_t id);

      virtual ~TGo4Command();

      virtual Int_t ExeCom();

      virtual Int_t RefuseCom();

      virtual Bool_t Log(Int_t mode = 0);

      Bool_t IsEnabled() const;

      Bool_t IsExclusive() const;

      Bool_t IsLocal() const;

      virtual void Help();

      Int_t GetCommandID() const;

      Bool_t IsSynchron() const;

      const char *GetReceiverName() const;
      void SetReceiverName(const char *);

      const char *GetTaskName() const;
      void SetTaskName(const char *);

      const char *What() const;
      void SetDescription(const char *);

      virtual void SetReceiver(TGo4CommandReceiver *rec);

      Go4CommandMode_t GetProtection() const { return fiProtection; }
      Go4CommandMode_t GetMode() const { return fiMode; }

       virtual void Set(TGo4RemoteCommand *remcon);

       void SetMode(Go4CommandMode_t m) { fiMode = m; }

       static const char *GetModeDescription(Go4CommandMode_t mode);

   protected:

      Bool_t fbIsEnabled{kFALSE};   // command can be executed
      Bool_t fbIsExclusive{kFALSE}; // command can be executed only by ReceiverName
      Bool_t fbIsSynchron{kFALSE};  // command is queued = synchronous
      Bool_t fbIsLocal{kFALSE};     // command is to be executed by local command thread

      Int_t fiCommandID{0};    // command number
      Int_t fiVersion{0};      // version number

      Go4CommandMode_t fiMode{kGo4ComModeRefused}; //
      Go4CommandMode_t fiProtection{kGo4ComModeRefused}; //

      void SetProtection(Go4CommandMode_t m) { fiProtection = m; }

       static const char *fgcMODEDESCRIPTION[];

   private:

      TString fxDescription;  // short description of command
      TString fxReceiverName; // name of receiver
      TString fxTaskName;     // name of task

   protected:
      TGo4CommandReceiver *fxReceiverBase{nullptr}; 

   ClassDefOverride(TGo4Command, 1)
};

#endif //TGO4COMMAND_H