idl/SALOME_SDS.idl

   1 // Copyright (C) 2007-2016  CEA/DEN, EDF R&D, OPEN CASCADE
   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 // Author : Anthony GEAY (EDF R&D)
  20
  21 #include "SALOME_GenericObj.idl"
  22 #include "SALOME_Exception.idl"
  23
  24 module SALOME
  25 {
  26   typedef sequence<string> StringVec;
  27   typedef sequence<octet> ByteVec;
  28   typedef sequence<ByteVec> SeqOfByteVec;
  29
  30   interface DataScopeServer;
  31
  32   interface BasicDataServer : GenericObj
  33   {
  34     DataScopeServer getMyDataScopeServer();
  35     string getVarName();
  36     string getScopeName();
  37     long getRCValue();
  38   };
  39
  40   interface PickelizedPyObjServer : BasicDataServer
  41   {
  42     ByteVec fetchSerializedContent() raises (SALOME::SALOME_Exception);
  43   };
  44
  45   interface PickelizedPyObjRdOnlyServer : PickelizedPyObjServer
  46   {
  47   };
  48
  49   interface PickelizedPyObjRdExtBaseServer : PickelizedPyObjServer
  50   {
  51   };
  52
  53   interface PickelizedPyObjRdExtServer : PickelizedPyObjRdExtBaseServer
  54   {
  55     PickelizedPyObjRdExtServer invokePythonMethodOn(in string method, in ByteVec args) raises (SALOME::SALOME_Exception);
  56   };
  57
  58   interface PickelizedPyObjRdExtInitServer : PickelizedPyObjRdExtBaseServer
  59   {
  60   };
  61
  62   interface PickelizedPyObjRdWrServer : PickelizedPyObjServer
  63   {
  64     void setSerializedContent(in ByteVec newValue) raises (SALOME::SALOME_Exception);
  65     PickelizedPyObjRdWrServer invokePythonMethodOn(in string method, in ByteVec args) raises (SALOME::SALOME_Exception);
  66   };
  67
  68   interface DataServerManager;
  69
  70   interface DataScopeKiller
  71   {
  72     void shutdown();
  73   };
  74
  75   interface RequestSwitcherBase
  76   {
  77     void holdRequests();
  78     void activeRequests();
  79   };
  80
  81   interface RequestSwitcher : RequestSwitcherBase
  82   {
  83     StringVec listVars();
  84     ByteVec fetchSerializedContent(in string varName) raises (SALOME::SALOME_Exception);
  85     void fetchAndGetAccessOfVar(in string varName, out string access, out ByteVec data) raises (SALOME::SALOME_Exception);
  86   };
  87
  88   interface DataScopeServerTransaction;
  89
  90   interface RequestSwitcherDSM : RequestSwitcherBase
  91   {
  92     StringVec listScopes();
  93     DataScopeServerTransaction giveADataScopeTransactionCalled(in string scopeName, out boolean isCreated) raises (SALOME::SALOME_Exception);
  94   };
  95
  96   interface DataScopeServerBase
  97   {
  98     void ping();
  99     string getScopeName();
 100     StringVec listVars();
 101     boolean existVar(in string varName) raises (SALOME::SALOME_Exception);
 102     void deleteVar(in string varName) raises (SALOME::SALOME_Exception);
 103     boolean shutdownIfNotHostedByDSM(out DataScopeKiller killer) raises (SALOME::SALOME_Exception);
 104     ByteVec fetchSerializedContent(in string varName) raises (SALOME::SALOME_Exception);
 105     SeqOfByteVec getAllKeysOfVarWithTypeDict(in string varName) raises (SALOME::SALOME_Exception);
 106     void takeANap(in double napDurationInSec) raises (SALOME::SALOME_Exception);
 107   };
 108
 109   interface DataScopeServer : DataScopeServerBase
 110   {
 111     BasicDataServer retrieveVar(in string varName) raises (SALOME::SALOME_Exception);
 112     PickelizedPyObjRdOnlyServer createRdOnlyVar(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 113     PickelizedPyObjRdExtServer createRdExtVar(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 114   };
 115
 116   interface Transaction
 117   {
 118   };
 119
 120   interface TransactionRdWrAccess : Transaction
 121   {
 122     PickelizedPyObjRdWrServer getVar() raises (SALOME::SALOME_Exception);
 123   };
 124
 125   interface TransactionMultiKeyAddSession : Transaction
 126   {
 127     void addKeyValueInVarErrorIfAlreadyExistingNow(in SALOME::ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 128   };
 129
 130   typedef sequence<Transaction> ListOfTransaction;
 131
 132   interface KeyWaiter
 133   {
 134     void waitFor() raises (SALOME::SALOME_Exception);
 135   };
 136
 137   interface DataScopeServerTransaction : DataScopeServerBase
 138   {
 139     string getAccessOfVar(in string varName) raises (SALOME::SALOME_Exception);
 140     void fetchAndGetAccessOfVar(in string varName, out string access, out ByteVec data) raises (SALOME::SALOME_Exception);
 141     Transaction createRdOnlyVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 142     Transaction createRdExtVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 143     Transaction createRdExtVarFreeStyleTransac(in string varName, in ByteVec constValue, in ByteVec sha1) raises (SALOME::SALOME_Exception);
 144     Transaction createRdExtInitVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 145     Transaction createRdWrVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 146     Transaction addKeyValueInVarHard(in string varName, in ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 147     Transaction addKeyValueInVarErrorIfAlreadyExisting(in string varName, in ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 148     TransactionMultiKeyAddSession addMultiKeyValueSession(in string varName) raises (SALOME::SALOME_Exception);
 149     Transaction removeKeyInVarErrorIfNotAlreadyExisting(in string varName, in ByteVec keyValue) raises (SALOME::SALOME_Exception);
 150     TransactionRdWrAccess createWorkingVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
 151     Transaction killVarTransac(in string varName) raises (SALOME::SALOME_Exception);
 152     KeyWaiter waitForKeyInVar(in string varName, in ByteVec keyVal) raises (SALOME::SALOME_Exception);
 153     KeyWaiter waitForKeyInVarAndKillIt(in string varName, in ByteVec keyVal, out Transaction transac) raises (SALOME::SALOME_Exception);
 154     void atomicApply(in ListOfTransaction transactions) raises (SALOME::SALOME_Exception);
 155     ByteVec waitForMonoThrRev(in KeyWaiter kw) raises (SALOME::SALOME_Exception);
 156     ByteVec waitForAndKill(in KeyWaiter kw) raises (SALOME::SALOME_Exception);
 157     RequestSwitcher getRequestSwitcher();
 158   };
 159
 160   interface DataServerManager
 161   {
 162     StringVec listScopes();
 163     StringVec listAliveAndKickingScopes() raises (SALOME::SALOME_Exception);
 164     DataScopeServer getDefaultScope() raises (SALOME::SALOME_Exception);
 165     boolean isAliveAndKicking(in string scopeName) raises (SALOME::SALOME_Exception);
 166     //
 167     DataScopeServer createDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
 168     DataScopeServer giveADataScopeCalled(in string scopeName, out boolean isCreated) raises (SALOME::SALOME_Exception);
 169     //
 170     DataScopeServerTransaction createDataScopeTransaction(in string scopeName) raises (SALOME::SALOME_Exception);
 171     DataScopeServerTransaction giveADataScopeTransactionCalled(in string scopeName, out boolean isCreated) raises (SALOME::SALOME_Exception);
 172     //
 173     DataScopeServerBase retriveDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
 174     void removeDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
 175     void cleanScopesInNS();
 176     void shutdownScopes() raises (SALOME::SALOME_Exception);
 177     RequestSwitcherDSM getRequestSwitcher();
 178   };
 179 };