blob: 129022f97ae32d43690b7056f39fc70127c050cf (
plain)
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
134
135
136
137
138
139
140
|
/* -*- C++ -*- */
// $Id$
// ============================================================================
//
// = LIBRARY
// TAO/orbsvcs/Concurrency_Service
//
// = FILENAME
// CC_Lock.h
//
// = DESCRIPTION
// This class implements a lock used by the lock set from the
// concurrency control service
//
// = AUTHORS
// Torben Worm <tworm@cs.wustl.edu>
//
// ============================================================================
#ifndef _CC_LOCK_H
#define _CC_LOCK_H
#include "ace/Synch.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
#include "orbsvcs/CosConcurrencyControlC.h"
#define NUMBER_OF_LOCK_MODES 5
// This constant defines the number of lock modes. There is really no
// way to set this constant dynamically because the nuber of lock
// modes are not stated as part of the IDL.
class TAO_ORBSVCS_Export CC_Lock
{
// = TITLE
// CC_Lock
//
// = DESCRIPTION
// This class implements the lock concept from the concurrency
// control service. The lock holds its mode - this might later
// be changed to subclasses depending on the differences of the
// locks. At present the is only a lock-pr-thread/client-type
// which is essentially a write lock since it is not allowed to
// have more than one lock pr. servant in this implementation.
public:
CC_Lock (void);
// Creates the lock with mode = intention_read (weakest)
CC_Lock (CosConcurrencyControl::lock_mode mode);
// Creates the lock with the desired mode
~CC_Lock (void);
// Deletes the lock
void lock (CORBA::Environment &env);
// Acquires this lock. Blocks until lock is obtained
CORBA::Boolean try_lock (CORBA::Environment &env);
// Tries to acquire this lock. If it is not possible to acquire the
// lock, false is returned
void unlock (CORBA::Environment &env);
// Releases this lock.
void change_mode (CosConcurrencyControl::lock_mode new_mode,
CORBA::Environment &env);
// Changes the mode of this lock.
void set_mode (CosConcurrencyControl::lock_mode mode);
// Sets the mode_ of the lock. Used in initialization
CORBA::Boolean Compatible (const CC_Lock &other);
// returns true if this lock is compatible with the other lock.
CORBA::Boolean Compatible (CosConcurrencyControl::lock_mode mode);
// Returns true is this lock is compatible with the referenced mode.
CosConcurrencyControl::lock_mode GetMode (void);
// Returns the mode of the lock.
int GetLocksHeld(void);
// Returns the number of times this lock have been locked
void DecLocksHeld(void);
// Decrements the number of locks held in this mode. Used by change_mode.
void dump(void);
// Dumps the state of the object to stdout
protected:
CosConcurrencyControl::lock_mode mode_;
// Holds the lock's mode.
private:
int lock_held_;
// If greater than zero the lock is held (that number of times).
static CORBA::Boolean compatible_[NUMBER_OF_LOCK_MODES][NUMBER_OF_LOCK_MODES];
// Defines the compatibility of the locks.
};
class TAO_ORBSVCS_Export CC_LockModeIterator
{
// = TITLE
// CC_LockModeIterator
//
// = DESCRIPTION
// This class implements an iterator over the lock modes in
// order to make an ordered traversal over the locks from the
// weakest (intention read) to the strongest (write).
// Ordering: IR -> R -> U -> IW -> W
public:
CC_LockModeIterator(void);
// Default constructor
~CC_LockModeIterator(void);
// Destructor
void First(void);
// Reset the iterator to the first element
void Next(CORBA::Environment &_env);
// Advance the iterator to the next element
// Throws exception if out of range
CORBA::Boolean IsDone(void);
// Returns true if the iterator has reached the last element
CosConcurrencyControl::lock_mode GetLockMode(void);
// Get the current element
private:
CosConcurrencyControl::lock_mode current_;
};
#endif /* !defined (_CC_LOCK_H) */
|
