Salome HOME
Impl of mechanism into SDS of switcher hold/reactive requests
[modules/kernel.git] / 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 RequestSwitcher
76   {
77     void holdRequests();
78     void activeRequests();
79   };
80
81   interface DataScopeServerBase
82   {
83     void ping();
84     string getScopeName();
85     StringVec listVars();
86     boolean existVar(in string varName) raises (SALOME::SALOME_Exception);
87     void deleteVar(in string varName) raises (SALOME::SALOME_Exception);
88     boolean shutdownIfNotHostedByDSM(out DataScopeKiller killer) raises (SALOME::SALOME_Exception);
89     ByteVec fetchSerializedContent(in string varName) raises (SALOME::SALOME_Exception);
90     SeqOfByteVec getAllKeysOfVarWithTypeDict(in string varName) raises (SALOME::SALOME_Exception);
91     RequestSwitcher getRequestSwitcher();
92   };
93
94   interface DataScopeServer : DataScopeServerBase
95   {
96     BasicDataServer retrieveVar(in string varName) raises (SALOME::SALOME_Exception);
97     PickelizedPyObjRdOnlyServer createRdOnlyVar(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
98     PickelizedPyObjRdExtServer createRdExtVar(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
99   };
100
101   interface Transaction
102   {
103   };
104
105   interface TransactionRdWrAccess : Transaction
106   {
107     PickelizedPyObjRdWrServer getVar() raises (SALOME::SALOME_Exception);
108   };
109
110   interface TransactionMultiKeyAddSession : Transaction
111   {
112     void addKeyValueInVarErrorIfAlreadyExistingNow(in SALOME::ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
113   };
114
115   typedef sequence<Transaction> ListOfTransaction;
116
117   interface KeyWaiter
118   {
119     void waitFor() raises (SALOME::SALOME_Exception);
120   };
121
122   interface DataScopeServerTransaction : DataScopeServerBase
123   {
124     string getAccessOfVar(in string varName) raises (SALOME::SALOME_Exception);
125     void fetchAndGetAccessOfVar(in string varName, out string access, out ByteVec data) raises (SALOME::SALOME_Exception);
126     Transaction createRdOnlyVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
127     Transaction createRdExtVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
128     Transaction createRdExtInitVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
129     Transaction createRdWrVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
130     Transaction addKeyValueInVarHard(in string varName, in ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
131     Transaction addKeyValueInVarErrorIfAlreadyExisting(in string varName, in ByteVec keyValue, in ByteVec constValue) raises (SALOME::SALOME_Exception);
132     TransactionMultiKeyAddSession addMultiKeyValueSession(in string varName) raises (SALOME::SALOME_Exception);
133     Transaction removeKeyInVarErrorIfNotAlreadyExisting(in string varName, in ByteVec keyValue) raises (SALOME::SALOME_Exception);
134     TransactionRdWrAccess createWorkingVarTransac(in string varName, in ByteVec constValue) raises (SALOME::SALOME_Exception);
135     Transaction killVarTransac(in string varName) raises (SALOME::SALOME_Exception);
136     KeyWaiter waitForKeyInVar(in string varName, in ByteVec keyVal) raises (SALOME::SALOME_Exception);
137     KeyWaiter waitForKeyInVarAndKillIt(in string varName, in ByteVec keyVal, out Transaction transac) raises (SALOME::SALOME_Exception);
138     void atomicApply(in ListOfTransaction transactions) raises (SALOME::SALOME_Exception);
139     ByteVec waitForMonoThrRev(in KeyWaiter kw) raises (SALOME::SALOME_Exception);
140     ByteVec waitForAndKill(in KeyWaiter kw) raises (SALOME::SALOME_Exception);
141   };
142
143   interface DataServerManager
144   {
145     StringVec listScopes();
146     StringVec listAliveAndKickingScopes() raises (SALOME::SALOME_Exception);
147     DataScopeServer getDefaultScope() raises (SALOME::SALOME_Exception);
148     boolean isAliveAndKicking(in string scopeName) raises (SALOME::SALOME_Exception);
149     //
150     DataScopeServer createDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
151     DataScopeServer giveADataScopeCalled(in string scopeName, out boolean isCreated) raises (SALOME::SALOME_Exception);
152     //
153     DataScopeServerTransaction createDataScopeTransaction(in string scopeName) raises (SALOME::SALOME_Exception);
154     DataScopeServerTransaction giveADataScopeTransactionCalled(in string scopeName, out boolean isCreated) raises (SALOME::SALOME_Exception);
155     //
156     DataScopeServerBase retriveDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
157     void removeDataScope(in string scopeName) raises (SALOME::SALOME_Exception);
158     void cleanScopesInNS();
159     void shutdownScopes() raises (SALOME::SALOME_Exception);
160   };
161 };