1*b1cdbd2cSJim Jagielski /**************************************************************
2*b1cdbd2cSJim Jagielski *
3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one
4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file
5*b1cdbd2cSJim Jagielski * distributed with this work for additional information
6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file
7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the
8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance
9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at
10*b1cdbd2cSJim Jagielski *
11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0
12*b1cdbd2cSJim Jagielski *
13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing,
14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an
15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the
17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations
18*b1cdbd2cSJim Jagielski * under the License.
19*b1cdbd2cSJim Jagielski *
20*b1cdbd2cSJim Jagielski *************************************************************/
21*b1cdbd2cSJim Jagielski
22*b1cdbd2cSJim Jagielski
23*b1cdbd2cSJim Jagielski
24*b1cdbd2cSJim Jagielski // MARKER(update_precomp.py): autogen include statement, do not remove
25*b1cdbd2cSJim Jagielski #include "precompiled_framework.hxx"
26*b1cdbd2cSJim Jagielski
27*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
28*b1cdbd2cSJim Jagielski // my own includes
29*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
30*b1cdbd2cSJim Jagielski #include <threadhelp/transactionmanager.hxx>
31*b1cdbd2cSJim Jagielski #include <threadhelp/resetableguard.hxx>
32*b1cdbd2cSJim Jagielski #include <macros/debug.hxx>
33*b1cdbd2cSJim Jagielski
34*b1cdbd2cSJim Jagielski #include <macros/generic.hxx>
35*b1cdbd2cSJim Jagielski #include <fwidllapi.h>
36*b1cdbd2cSJim Jagielski
37*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
38*b1cdbd2cSJim Jagielski // interface includes
39*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
40*b1cdbd2cSJim Jagielski #include <com/sun/star/lang/DisposedException.hpp>
41*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
42*b1cdbd2cSJim Jagielski // other includes
43*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
44*b1cdbd2cSJim Jagielski
45*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
46*b1cdbd2cSJim Jagielski // const
47*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
48*b1cdbd2cSJim Jagielski
49*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
50*b1cdbd2cSJim Jagielski // namespace
51*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
52*b1cdbd2cSJim Jagielski
53*b1cdbd2cSJim Jagielski namespace framework{
54*b1cdbd2cSJim Jagielski
55*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
56*b1cdbd2cSJim Jagielski // non exported const
57*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
58*b1cdbd2cSJim Jagielski
59*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
60*b1cdbd2cSJim Jagielski // non exported declarations
61*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
62*b1cdbd2cSJim Jagielski
63*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
64*b1cdbd2cSJim Jagielski // definitions
65*b1cdbd2cSJim Jagielski //_________________________________________________________________________________________________________________
66*b1cdbd2cSJim Jagielski
67*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//**
68*b1cdbd2cSJim Jagielski @short standard ctor
69*b1cdbd2cSJim Jagielski @descr Initialize instance with right start values for correct working.
70*b1cdbd2cSJim Jagielski
71*b1cdbd2cSJim Jagielski @seealso -
72*b1cdbd2cSJim Jagielski
73*b1cdbd2cSJim Jagielski @param -
74*b1cdbd2cSJim Jagielski @return -
75*b1cdbd2cSJim Jagielski
76*b1cdbd2cSJim Jagielski @onerror -
77*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/
TransactionManager()78*b1cdbd2cSJim Jagielski TransactionManager::TransactionManager()
79*b1cdbd2cSJim Jagielski : m_eWorkingMode ( E_INIT )
80*b1cdbd2cSJim Jagielski , m_nTransactionCount ( 0 )
81*b1cdbd2cSJim Jagielski {
82*b1cdbd2cSJim Jagielski m_aBarrier.open();
83*b1cdbd2cSJim Jagielski }
84*b1cdbd2cSJim Jagielski
85*b1cdbd2cSJim Jagielski /*-************************************************************************************************************//**
86*b1cdbd2cSJim Jagielski @short standard dtor
87*b1cdbd2cSJim Jagielski @descr -
88*b1cdbd2cSJim Jagielski
89*b1cdbd2cSJim Jagielski @seealso -
90*b1cdbd2cSJim Jagielski
91*b1cdbd2cSJim Jagielski @param -
92*b1cdbd2cSJim Jagielski @return -
93*b1cdbd2cSJim Jagielski
94*b1cdbd2cSJim Jagielski @onerror -
95*b1cdbd2cSJim Jagielski *//*-*************************************************************************************************************/
~TransactionManager()96*b1cdbd2cSJim Jagielski TransactionManager::~TransactionManager()
97*b1cdbd2cSJim Jagielski {
98*b1cdbd2cSJim Jagielski }
99*b1cdbd2cSJim Jagielski
100*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
101*b1cdbd2cSJim Jagielski @interface ITransactionManager
102*b1cdbd2cSJim Jagielski @short set new working mode
103*b1cdbd2cSJim Jagielski @descr These implementation knows for states of working: E_INIT, E_WORK, E_CLOSING, E_CLOSE
104*b1cdbd2cSJim Jagielski You can step during this ones only from the left to the right side and start at left side again!
105*b1cdbd2cSJim Jagielski (This is neccessary e.g. for refcounted objects!)
106*b1cdbd2cSJim Jagielski This call will block till all current existing transactions was finished.
107*b1cdbd2cSJim Jagielski Follow results occure:
108*b1cdbd2cSJim Jagielski E_INIT : All requests on this implementation are refused.
109*b1cdbd2cSJim Jagielski It's your decision to react in a right way.
110*b1cdbd2cSJim Jagielski
111*b1cdbd2cSJim Jagielski E_WORK : The object can work now. The full functionality is available.
112*b1cdbd2cSJim Jagielski
113*b1cdbd2cSJim Jagielski E_BEFORECLOSE : The object start the closing mechanism ... but sometimes
114*b1cdbd2cSJim Jagielski e.g. the dispose() method need to call some private methods.
115*b1cdbd2cSJim Jagielski These some special methods should use E_SOFTEXCEPTIONS or ignore
116*b1cdbd2cSJim Jagielski E_INCLOSE as returned reason for E_NOEXCEPTIONS to detect this special case!
117*b1cdbd2cSJim Jagielski
118*b1cdbd2cSJim Jagielski E_CLOSE : Object is already dead! All further requests will be refused.
119*b1cdbd2cSJim Jagielski It's your decision to react in a right way.
120*b1cdbd2cSJim Jagielski
121*b1cdbd2cSJim Jagielski @seealso -
122*b1cdbd2cSJim Jagielski
123*b1cdbd2cSJim Jagielski @param "eMode", is the new mode - but we don't accept setting mode in wrong order!
124*b1cdbd2cSJim Jagielski @return -
125*b1cdbd2cSJim Jagielski
126*b1cdbd2cSJim Jagielski @onerror We do nothing.
127*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
setWorkingMode(EWorkingMode eMode)128*b1cdbd2cSJim Jagielski void TransactionManager::setWorkingMode( EWorkingMode eMode )
129*b1cdbd2cSJim Jagielski {
130*b1cdbd2cSJim Jagielski // Safe member access.
131*b1cdbd2cSJim Jagielski ::osl::ClearableMutexGuard aAccessGuard( m_aAccessLock );
132*b1cdbd2cSJim Jagielski sal_Bool bWaitFor = sal_False ;
133*b1cdbd2cSJim Jagielski // Change working mode first!
134*b1cdbd2cSJim Jagielski if (
135*b1cdbd2cSJim Jagielski ( m_eWorkingMode == E_INIT && eMode == E_WORK ) ||
136*b1cdbd2cSJim Jagielski ( m_eWorkingMode == E_WORK && eMode == E_BEFORECLOSE ) ||
137*b1cdbd2cSJim Jagielski ( m_eWorkingMode == E_BEFORECLOSE && eMode == E_CLOSE ) ||
138*b1cdbd2cSJim Jagielski ( m_eWorkingMode == E_CLOSE && eMode == E_INIT )
139*b1cdbd2cSJim Jagielski )
140*b1cdbd2cSJim Jagielski {
141*b1cdbd2cSJim Jagielski m_eWorkingMode = eMode;
142*b1cdbd2cSJim Jagielski if( m_eWorkingMode == E_BEFORECLOSE || m_eWorkingMode == E_CLOSE )
143*b1cdbd2cSJim Jagielski {
144*b1cdbd2cSJim Jagielski bWaitFor = sal_True;
145*b1cdbd2cSJim Jagielski }
146*b1cdbd2cSJim Jagielski }
147*b1cdbd2cSJim Jagielski
148*b1cdbd2cSJim Jagielski // Wait for current existing transactions then!
149*b1cdbd2cSJim Jagielski // (Only neccessary for changing to E_BEFORECLOSE or E_CLOSE! ...
150*b1cdbd2cSJim Jagielski // otherwise; if you wait at setting E_WORK another thrad could finish a acquire-call during our unlock() and wait() call
151*b1cdbd2cSJim Jagielski // ... and we will wait forever here!!!)
152*b1cdbd2cSJim Jagielski // Don't forget to release access mutex before.
153*b1cdbd2cSJim Jagielski aAccessGuard.clear();
154*b1cdbd2cSJim Jagielski if( bWaitFor == sal_True )
155*b1cdbd2cSJim Jagielski {
156*b1cdbd2cSJim Jagielski m_aBarrier.wait();
157*b1cdbd2cSJim Jagielski }
158*b1cdbd2cSJim Jagielski }
159*b1cdbd2cSJim Jagielski
160*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
161*b1cdbd2cSJim Jagielski @interface ITransactionManager
162*b1cdbd2cSJim Jagielski @short get current working mode
163*b1cdbd2cSJim Jagielski @descr If you stand in your close() or init() method ... but don't know
164*b1cdbd2cSJim Jagielski if you called more then ones(!) ... you can use this function to get
165*b1cdbd2cSJim Jagielski right information.
166*b1cdbd2cSJim Jagielski e.g: You have a method init() which is used to change working mode from
167*b1cdbd2cSJim Jagielski E_INIT to E_WORK and should be used to initialize some member too ...
168*b1cdbd2cSJim Jagielski What should you do:
169*b1cdbd2cSJim Jagielski
170*b1cdbd2cSJim Jagielski void init( sal_Int32 nValue )
171*b1cdbd2cSJim Jagielski {
172*b1cdbd2cSJim Jagielski // Reject this call if our transaction manager say: "Object already initialized!"
173*b1cdbd2cSJim Jagielski // Otherwise initialize your member.
174*b1cdbd2cSJim Jagielski if( m_aTransactionManager.getWorkingMode() == E_INIT )
175*b1cdbd2cSJim Jagielski {
176*b1cdbd2cSJim Jagielski // Object is uninitialized ...
177*b1cdbd2cSJim Jagielski // Make member access threadsafe!
178*b1cdbd2cSJim Jagielski ResetableGuard aGuard( m_aMutex );
179*b1cdbd2cSJim Jagielski
180*b1cdbd2cSJim Jagielski // Check working mode again .. because anozï¿œther instance could be faster.
181*b1cdbd2cSJim Jagielski // (It's possible to set this guard at first of this method too!)
182*b1cdbd2cSJim Jagielski if( m_aTransactionManager.getWorkingMode() == E_INIT )
183*b1cdbd2cSJim Jagielski {
184*b1cdbd2cSJim Jagielski m_aMember = nValue;
185*b1cdbd2cSJim Jagielski
186*b1cdbd2cSJim Jagielski // Object is initialized now ... set working mode to E_WORK!
187*b1cdbd2cSJim Jagielski m_aTransactionManager.setWorkingMode( E_WORK );
188*b1cdbd2cSJim Jagielski }
189*b1cdbd2cSJim Jagielski }
190*b1cdbd2cSJim Jagielski }
191*b1cdbd2cSJim Jagielski
192*b1cdbd2cSJim Jagielski @seealso method setWorkingMode()
193*b1cdbd2cSJim Jagielski
194*b1cdbd2cSJim Jagielski @param -
195*b1cdbd2cSJim Jagielski @return Current set mode.
196*b1cdbd2cSJim Jagielski
197*b1cdbd2cSJim Jagielski @onerror No error should occure.
198*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
getWorkingMode() const199*b1cdbd2cSJim Jagielski EWorkingMode TransactionManager::getWorkingMode() const
200*b1cdbd2cSJim Jagielski {
201*b1cdbd2cSJim Jagielski // Synchronize access to internal member!
202*b1cdbd2cSJim Jagielski ::osl::MutexGuard aAccessLock( m_aAccessLock );
203*b1cdbd2cSJim Jagielski return m_eWorkingMode;
204*b1cdbd2cSJim Jagielski }
205*b1cdbd2cSJim Jagielski
206*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
207*b1cdbd2cSJim Jagielski @interface ITransactionManager
208*b1cdbd2cSJim Jagielski @short start new transaction
209*b1cdbd2cSJim Jagielski @descr A guard should use this method to start a new transaction. He should looks for rejected
210*b1cdbd2cSJim Jagielski calls to by using parameter eMode and eReason.
211*b1cdbd2cSJim Jagielski If call was not rejected your transaction will be non breakable during releasing your transaction
212*b1cdbd2cSJim Jagielski guard! BUT ... your code isn't threadsafe then! It's a transaction manager only ....
213*b1cdbd2cSJim Jagielski
214*b1cdbd2cSJim Jagielski @seealso method unregisterTransaction()
215*b1cdbd2cSJim Jagielski
216*b1cdbd2cSJim Jagielski @param "eMode" ,used to enable/disable throwing exceptions automaticly for rejected calls
217*b1cdbd2cSJim Jagielski @param "eReason" ,reason for rejected calls if eMode=E_NOEXCEPTIONS
218*b1cdbd2cSJim Jagielski @return -
219*b1cdbd2cSJim Jagielski
220*b1cdbd2cSJim Jagielski @onerror -
221*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
registerTransaction(EExceptionMode eMode,ERejectReason & eReason)222*b1cdbd2cSJim Jagielski void TransactionManager::registerTransaction( EExceptionMode eMode, ERejectReason& eReason ) throw( css::uno::RuntimeException, css::lang::DisposedException )
223*b1cdbd2cSJim Jagielski {
224*b1cdbd2cSJim Jagielski // Look for rejected calls first.
225*b1cdbd2cSJim Jagielski // If call was refused we throw some exceptions or do nothing!
226*b1cdbd2cSJim Jagielski // It depends from given parameter eMode.
227*b1cdbd2cSJim Jagielski if( isCallRejected( eReason ) == sal_True )
228*b1cdbd2cSJim Jagielski {
229*b1cdbd2cSJim Jagielski impl_throwExceptions( eMode, eReason );
230*b1cdbd2cSJim Jagielski }
231*b1cdbd2cSJim Jagielski
232*b1cdbd2cSJim Jagielski // BUT if no exception was thrown ... (may be eMode = E_SOFTEXCEPTIONS!)
233*b1cdbd2cSJim Jagielski // we must register this transaction too!
234*b1cdbd2cSJim Jagielski // Don't use "else" or a new scope here!!!
235*b1cdbd2cSJim Jagielski
236*b1cdbd2cSJim Jagielski // Safe access to internal member.
237*b1cdbd2cSJim Jagielski ::osl::MutexGuard aAccessGuard( m_aAccessLock );
238*b1cdbd2cSJim Jagielski
239*b1cdbd2cSJim Jagielski #ifdef ENABLE_MUTEXDEBUG
240*b1cdbd2cSJim Jagielski LOG_ASSERT2( m_nTransactionCount<0, "TransactionManager::acquire()", "Wrong ref count detected!" )
241*b1cdbd2cSJim Jagielski #endif
242*b1cdbd2cSJim Jagielski
243*b1cdbd2cSJim Jagielski // Register this new transaction.
244*b1cdbd2cSJim Jagielski // If it is the first one .. close gate to disable changing of working mode.
245*b1cdbd2cSJim Jagielski ++m_nTransactionCount;
246*b1cdbd2cSJim Jagielski if( m_nTransactionCount == 1 )
247*b1cdbd2cSJim Jagielski {
248*b1cdbd2cSJim Jagielski m_aBarrier.close();
249*b1cdbd2cSJim Jagielski }
250*b1cdbd2cSJim Jagielski }
251*b1cdbd2cSJim Jagielski
252*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
253*b1cdbd2cSJim Jagielski @interface ITransactionManager
254*b1cdbd2cSJim Jagielski @short finish transaction
255*b1cdbd2cSJim Jagielski @descr A guard should call this method to release current transaction.
256*b1cdbd2cSJim Jagielski
257*b1cdbd2cSJim Jagielski @seealso method registerTransaction()
258*b1cdbd2cSJim Jagielski
259*b1cdbd2cSJim Jagielski @param -
260*b1cdbd2cSJim Jagielski @return -
261*b1cdbd2cSJim Jagielski
262*b1cdbd2cSJim Jagielski @onerror -
263*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
unregisterTransaction()264*b1cdbd2cSJim Jagielski void TransactionManager::unregisterTransaction() throw( css::uno::RuntimeException, css::lang::DisposedException )
265*b1cdbd2cSJim Jagielski {
266*b1cdbd2cSJim Jagielski // This call could not rejected!
267*b1cdbd2cSJim Jagielski // Safe access to internal member.
268*b1cdbd2cSJim Jagielski ::osl::MutexGuard aAccessGuard( m_aAccessLock );
269*b1cdbd2cSJim Jagielski
270*b1cdbd2cSJim Jagielski #ifdef ENABLE_MUTEXDEBUG
271*b1cdbd2cSJim Jagielski LOG_ASSERT2( m_nTransactionCount<=0, "TransactionManager::release()", "Wrong ref count detected!" )
272*b1cdbd2cSJim Jagielski #endif
273*b1cdbd2cSJim Jagielski
274*b1cdbd2cSJim Jagielski // Deregister this transaction.
275*b1cdbd2cSJim Jagielski // If it was the last one ... open gate to enable changing of working mode!
276*b1cdbd2cSJim Jagielski // (see setWorkingMode())
277*b1cdbd2cSJim Jagielski
278*b1cdbd2cSJim Jagielski --m_nTransactionCount;
279*b1cdbd2cSJim Jagielski if( m_nTransactionCount == 0 )
280*b1cdbd2cSJim Jagielski {
281*b1cdbd2cSJim Jagielski m_aBarrier.open();
282*b1cdbd2cSJim Jagielski }
283*b1cdbd2cSJim Jagielski }
284*b1cdbd2cSJim Jagielski
285*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
286*b1cdbd2cSJim Jagielski @interface ITransactionManager
287*b1cdbd2cSJim Jagielski @short look for rejected calls
288*b1cdbd2cSJim Jagielski @descr Sometimes user need a possibility to get information about rejected calls
289*b1cdbd2cSJim Jagielski without starting a transaction!
290*b1cdbd2cSJim Jagielski
291*b1cdbd2cSJim Jagielski @seealso -
292*b1cdbd2cSJim Jagielski
293*b1cdbd2cSJim Jagielski @param "eReason" returns reason of a rejected call
294*b1cdbd2cSJim Jagielski @return true if call was rejected, false otherwise
295*b1cdbd2cSJim Jagielski
296*b1cdbd2cSJim Jagielski @onerror We return false.
297*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
isCallRejected(ERejectReason & eReason) const298*b1cdbd2cSJim Jagielski sal_Bool TransactionManager::isCallRejected( ERejectReason& eReason ) const
299*b1cdbd2cSJim Jagielski {
300*b1cdbd2cSJim Jagielski // This call must safe access to internal member only.
301*b1cdbd2cSJim Jagielski // Set "possible reason" for return and check reject-state then!
302*b1cdbd2cSJim Jagielski // User should look for return value first - reason then ...
303*b1cdbd2cSJim Jagielski ::osl::MutexGuard aAccessGuard( m_aAccessLock );
304*b1cdbd2cSJim Jagielski switch( m_eWorkingMode )
305*b1cdbd2cSJim Jagielski {
306*b1cdbd2cSJim Jagielski case E_INIT : eReason = E_UNINITIALIZED ;
307*b1cdbd2cSJim Jagielski break;
308*b1cdbd2cSJim Jagielski case E_WORK : eReason = E_NOREASON ;
309*b1cdbd2cSJim Jagielski break;
310*b1cdbd2cSJim Jagielski case E_BEFORECLOSE : eReason = E_INCLOSE ;
311*b1cdbd2cSJim Jagielski break;
312*b1cdbd2cSJim Jagielski case E_CLOSE : eReason = E_CLOSED ;
313*b1cdbd2cSJim Jagielski break;
314*b1cdbd2cSJim Jagielski }
315*b1cdbd2cSJim Jagielski return( eReason!=E_NOREASON );
316*b1cdbd2cSJim Jagielski }
317*b1cdbd2cSJim Jagielski
318*b1cdbd2cSJim Jagielski /*-****************************************************************************************************//**
319*b1cdbd2cSJim Jagielski @short throw any exceptions for rejected calls
320*b1cdbd2cSJim Jagielski @descr If user whish to use our automaticly exception mode we use this impl-method.
321*b1cdbd2cSJim Jagielski We check all combinations of eReason and eExceptionMode and throw right exception with some
322*b1cdbd2cSJim Jagielski descriptions for recipient of it.
323*b1cdbd2cSJim Jagielski
324*b1cdbd2cSJim Jagielski @seealso method registerTransaction()
325*b1cdbd2cSJim Jagielski @seealso enum ERejectReason
326*b1cdbd2cSJim Jagielski @seealso enum EExceptionMode
327*b1cdbd2cSJim Jagielski
328*b1cdbd2cSJim Jagielski @param "eReason" , reason for rejected call
329*b1cdbd2cSJim Jagielski @param "eMode" , exception mode - set by user
330*b1cdbd2cSJim Jagielski @return -
331*b1cdbd2cSJim Jagielski
332*b1cdbd2cSJim Jagielski @onerror -
333*b1cdbd2cSJim Jagielski *//*-*****************************************************************************************************/
impl_throwExceptions(EExceptionMode eMode,ERejectReason eReason) const334*b1cdbd2cSJim Jagielski void TransactionManager::impl_throwExceptions( EExceptionMode eMode, ERejectReason eReason ) const throw( css::uno::RuntimeException, css::lang::DisposedException )
335*b1cdbd2cSJim Jagielski {
336*b1cdbd2cSJim Jagielski if( eMode != E_NOEXCEPTIONS )
337*b1cdbd2cSJim Jagielski {
338*b1cdbd2cSJim Jagielski switch( eReason )
339*b1cdbd2cSJim Jagielski {
340*b1cdbd2cSJim Jagielski case E_UNINITIALIZED : if( eMode == E_HARDEXCEPTIONS )
341*b1cdbd2cSJim Jagielski {
342*b1cdbd2cSJim Jagielski // Help programmer to find out, why this exception is thrown!
343*b1cdbd2cSJim Jagielski LOG_ERROR( "TransactionManager...", "Owner instance not right initialized yet. Call was rejected! Normaly it's an algorithm error ... wrong usin of class!" )
344*b1cdbd2cSJim Jagielski //ATTENTION: temp. disabled - till all bad code positions are detected and changed! */
345*b1cdbd2cSJim Jagielski // throw css::uno::RuntimeException( DECLARE_ASCII("TransactionManager...\nOwner instance not right initialized yet. Call was rejected! Normaly it's an algorithm error ... wrong usin of class!\n" ), css::uno::Reference< css::uno::XInterface >() );
346*b1cdbd2cSJim Jagielski }
347*b1cdbd2cSJim Jagielski break;
348*b1cdbd2cSJim Jagielski case E_INCLOSE : if( eMode == E_HARDEXCEPTIONS )
349*b1cdbd2cSJim Jagielski {
350*b1cdbd2cSJim Jagielski // Help programmer to find out, why this exception is thrown!
351*b1cdbd2cSJim Jagielski LOG_ERROR( "TransactionManager...", "Owner instance stand in close method. Call was rejected!" )
352*b1cdbd2cSJim Jagielski throw css::lang::DisposedException( DECLARE_ASCII("TransactionManager...\nOwner instance stand in close method. Call was rejected!\n" ), css::uno::Reference< css::uno::XInterface >() );
353*b1cdbd2cSJim Jagielski }
354*b1cdbd2cSJim Jagielski break;
355*b1cdbd2cSJim Jagielski case E_CLOSED : {
356*b1cdbd2cSJim Jagielski // Help programmer to find out, why this exception is thrown!
357*b1cdbd2cSJim Jagielski LOG_ERROR( "TransactionManager...", "Owner instance already closed. Call was rejected!" )
358*b1cdbd2cSJim Jagielski throw css::lang::DisposedException( DECLARE_ASCII("TransactionManager...\nOwner instance already closed. Call was rejected!\n" ), css::uno::Reference< css::uno::XInterface >() );
359*b1cdbd2cSJim Jagielski }
360*b1cdbd2cSJim Jagielski case E_NOREASON : {
361*b1cdbd2cSJim Jagielski // Help programmer to find out
362*b1cdbd2cSJim Jagielski LOG_ERROR( "TransactionManager...", "Impossible case E_NOREASON!" )
363*b1cdbd2cSJim Jagielski }
364*b1cdbd2cSJim Jagielski break;
365*b1cdbd2cSJim Jagielski default: break; // nothing to do
366*b1cdbd2cSJim Jagielski }
367*b1cdbd2cSJim Jagielski }
368*b1cdbd2cSJim Jagielski }
369*b1cdbd2cSJim Jagielski
370*b1cdbd2cSJim Jagielski } // namespace framework
371