1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#ifndef __FRAMEWORK_THREADHELP_ITRANSACTIONMANAGER_H_
#define __FRAMEWORK_THREADHELP_ITRANSACTIONMANAGER_H_
#include <general.h>
#include <com/sun/star/uno/RuntimeException.hpp>
#include <com/sun/star/lang/DisposedException.hpp>
namespace framework{
/*-************************************************************************************************************//**
@descr Describe different states of a feature of following implementation.
During lifetime of an object different working states occur:
initialization - working - closing - closed
If you wish to implement thread safe classes you should use this feature to protect
your code against calls at wrong time. e.g. you are not full initialized but somewhere
call an interface method (initialize phase means startup time from creating object till
calling specified first method e.g. XInitialization::initialze()!) then you should refuse
this call. The same for closing/disposing the object!
*//*-*************************************************************************************************************/
enum EWorkingMode
{
E_INIT , // We stand in a init method -> some calls are accepted - some one are rejected
E_WORK , // Object is ready for working -> all calls are accepted
E_BEFORECLOSE, // We stand in a close method -> some calls are accepted - some one are rejected
E_CLOSE // Object is dead! -> all calls are rejected!
};
/*-************************************************************************************************************//**
@descr If a request was refused by a transaction manager (internal state different E_WORK ...)
user can check the reason by using this enum values.
*//*-*************************************************************************************************************/
enum ERejectReason
{
E_UNINITIALIZED ,
E_NOREASON ,
E_INCLOSE ,
E_CLOSED
};
/*-************************************************************************************************************//**
@descr A transaction object should support throwing exceptions if user used it at wrong working mode.
e.g. We can throw a DisposedException if user try to work and our mode is E_CLOSE!
But sometimes he dont need this feature - will handle it by himself.
Then we must differ between some exception-modi:
E_NOEXCEPTIONS We never throw any exceptions! User handle it private and looks for ERejectReason.
E_HARDEXCEPTIONS We throw exceptions for all working modes different from E_WORK!
E_SOFTEXCEPTIONS We throw exceptions for all working modes different from E_WORK AND E_INCLOSE!
This mode is useful for impl-methods which should be callable from dispose() method!
e.g. void dispose()
{
m_aTransactionManager.setWorkingMode( E_BEFORECLOSE );
...
impl_setA( 0 );
...
m_aTransactionManager.setWorkingMode( E_CLOSE );
}
void impl_setA( int nA )
{
ERejectReason EReason;
TransactionGuard aTransactionGuard( m_aTransactionManager, E_SOFTEXCEPTIONS, eReason );
m_nA = nA;
}
Normaly (if E_HARDEXCEPTIONS was used!) creation of guard
will throw an exception ... but using of E_SOFTEXCEPTIONS suppress it
and member "A" can be set.
*//*-*************************************************************************************************************/
enum EExceptionMode
{
E_NOEXCEPTIONS ,
E_HARDEXCEPTIONS,
E_SOFTEXCEPTIONS
};
/*-************************************************************************************************************//**
@descr How can you use the transaction manager?
Use it in combination with an TransactionGuard, which register your transaction in ctor
and release in dtor automaticly! Follow interface class can be used to make using
of different manager implmentations possible by using same guard.
*//*-*************************************************************************************************************/
class ITransactionManager
{
//-------------------------------------------------------------------------------------------------------------
// public methods
//-------------------------------------------------------------------------------------------------------------
public:
/*-****************************************************************************************************//**
@descr These functions must be supported by a derived class!
getWorkingMode() -return current set working mode
setWorkingMode() -change working mode
(This will block till all current transactions are finished!)
isCallRejected() -test method to check if a call will be rejected by wrong working mode or not
registerTransaction() -start new transaction (increase internal transaction count)
unregisterTransaction() -finish transaction (decrease internal transaction count)
*//*-*****************************************************************************************************/
virtual EWorkingMode getWorkingMode ( ) const = 0;
virtual void setWorkingMode ( EWorkingMode eMode ) = 0;
virtual sal_Bool isCallRejected ( ERejectReason& eReason ) const = 0;
virtual void registerTransaction ( EExceptionMode eMode , ERejectReason& eReason ) throw( css::uno::RuntimeException, css::lang::DisposedException ) = 0;
virtual void unregisterTransaction ( ) throw( css::uno::RuntimeException, css::lang::DisposedException ) = 0;
protected:
~ITransactionManager() {}
}; // class ITransactionManager
} // namespace framework
#endif // #ifndef __FRAMEWORK_THREADHELP_ITRANSACTIONMANAGER_H_
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|