blob: dbc02adb6bba1ef2ddc2fd740836578eb784aed1 (
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
|
// -*- C++ -*-
//==========================================================================
/**
* @file Lock_Adapter_T.h
*
* @author Douglas C. Schmidt <d.schmidt@vanderbilt.edu>
*/
//==========================================================================
#ifndef ACE_LOCK_ADAPTER_T_H
#define ACE_LOCK_ADAPTER_T_H
#include /**/ "ace/pre.h"
#include "ace/Lock.h"
#if !defined (ACE_LACKS_PRAGMA_ONCE)
# pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */
ACE_BEGIN_VERSIONED_NAMESPACE_DECL
/**
* @class ACE_Lock_Adapter
*
* @brief This is an adapter that allows applications to transparently
* combine the ACE_Lock abstract base class (which contains
* pure virtual methods) with any of the other concrete ACE
* synchronization classes (e.g., ACE_Mutex, ACE_Semaphore,
* ACE_RW_Mutex, etc.).
*
* This class uses a form of the Adapter pattern.
*/
template <class ACE_LOCKING_MECHANISM>
class ACE_Lock_Adapter : public ACE_Lock
{
public:
typedef ACE_LOCKING_MECHANISM ACE_LOCK;
// = Initialization/Finalization methods.
/// Constructor. All locking requests will be forwarded to @a lock.
ACE_Lock_Adapter (ACE_LOCKING_MECHANISM &lock);
/// Constructor. Since no lock is provided by the user, one will be
/// created internally.
ACE_Lock_Adapter ();
/// Destructor. If @c lock_ was not passed in by the user, it will be
/// deleted.
virtual ~ACE_Lock_Adapter ();
// = Lock accessors.
/// Block the thread until the lock is acquired.
virtual int acquire ();
/// Conditionally acquire the lock (i.e., won't block).
virtual int tryacquire ();
/// Release the lock.
virtual int release ();
/**
* Block until the thread acquires a read lock. If the locking
* mechanism doesn't support read locks then this just calls
* acquire().
*/
virtual int acquire_read ();
/**
* Block until the thread acquires a write lock. If the locking
* mechanism doesn't support read locks then this just calls
* acquire().
*/
virtual int acquire_write ();
/// Conditionally acquire a read lock. If the locking mechanism
/// doesn't support read locks then this just calls acquire().
virtual int tryacquire_read ();
/// Conditionally acquire a write lock. If the locking mechanism
/// doesn't support read locks then this just calls acquire().
virtual int tryacquire_write ();
/**
* Conditionally try to upgrade a lock held for read to a write lock.
* If the locking mechanism doesn't support read locks then this just
* calls acquire(). Returns 0 on success, -1 on failure.
*/
virtual int tryacquire_write_upgrade ();
/// Explicitly destroy the lock.
virtual int remove ();
private:
/// The concrete locking mechanism that all the methods delegate to.
ACE_LOCKING_MECHANISM *lock_;
/// This flag keep track of whether we are responsible for deleting
/// the lock
bool delete_lock_;
};
ACE_END_VERSIONED_NAMESPACE_DECL
#if defined (__ACE_INLINE__)
#include "ace/Lock_Adapter_T.inl"
#endif /* __ACE_INLINE__ */
#include "ace/Lock_Adapter_T.cpp"
#include /**/ "ace/post.h"
#endif /* ACE_LOCK_ADAPTER_T_H */
|
