blob: 866616d1bb17fac29e559c8d161a7d8904ebe733 (
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
|
// -*- C++ -*-
//==========================================================================
/**
* @file Lock_Adapter_T.h
*
* $Id$
*
* Moved from Synch.h.
*
* @author Douglas C. Schmidt <schmidt@cs.wustl.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 (void);
/// Destructor. If <lock_> was not passed in by the user, it will be
/// deleted.
virtual ~ACE_Lock_Adapter (void);
// = Lock accessors.
/// Block the thread until the lock is acquired.
virtual int acquire (void);
/// Conditionally acquire the lock (i.e., won't block).
virtual int tryacquire (void);
/// Release the lock.
virtual int release (void);
/**
* 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 (void);
/**
* 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 (void);
/// Conditionally acquire a read lock. If the locking mechanism
/// doesn't support read locks then this just calls <acquire>.
virtual int tryacquire_read (void);
/// Conditionally acquire a write lock. If the locking mechanism
/// doesn't support read locks then this just calls <acquire>.
virtual int tryacquire_write (void);
/**
* 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 (void);
/// Explicitly destroy the lock.
virtual int remove (void);
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__ */
#if defined (ACE_TEMPLATES_REQUIRE_SOURCE)
#include "ace/Lock_Adapter_T.cpp"
#endif /* ACE_TEMPLATES_REQUIRE_SOURCE */
#if defined (ACE_TEMPLATES_REQUIRE_PRAGMA)
#pragma implementation ("Lock_Adapter_T.cpp")
#endif /* ACE_TEMPLATES_REQUIRE_PRAGMA */
#include /**/ "ace/post.h"
#endif /* ACE_LOCK_ADAPTER_T_H */
|