A reverse (or anti) lock. More...
#include <Reverse_Lock_T.h>
Public Types | |
typedef ACE_LOCKING_MECHANISM | ACE_LOCK |
Public Member Functions | |
ACE_Reverse_Lock (ACE_LOCKING_MECHANISM &lock, ACE_Acquire_Method::METHOD_TYPE acquire_method=ACE_Acquire_Method::ACE_REGULAR) | |
Constructor. All locking requests will be forwarded to lock. | |
virtual | ~ACE_Reverse_Lock (void) |
virtual int | acquire (void) |
Release the lock. | |
virtual int | tryacquire (void) |
Release the lock. | |
virtual int | release (void) |
Acquire the lock. | |
virtual int | acquire_read (void) |
Release the lock. | |
virtual int | acquire_write (void) |
Release the lock. | |
virtual int | tryacquire_read (void) |
Release the lock. | |
virtual int | tryacquire_write (void) |
Release the lock. | |
virtual int | tryacquire_write_upgrade (void) |
Release the lock. | |
virtual int | remove (void) |
Explicitly destroy the lock. | |
Private Attributes | |
ACE_LOCKING_MECHANISM & | lock_ |
The concrete locking mechanism that all the methods delegate to. | |
ACE_Acquire_Method::METHOD_TYPE | acquire_method_ |
This indicates what kind of acquire method will be called. |
A reverse (or anti) lock.
This is an interesting adapter class that changes a lock into a reverse lock, i.e., <acquire> on this class calls <release> on the lock, and <release> on this class calls <acquire> on the lock. One motivation for this class is when we temporarily want to release a lock (which we have already acquired) but then reacquire it soon after. An alternative design would be to add a Anti_Guard or Reverse_Guard class which would <release> on construction and <acquire> destruction. However, there are *many* varieties of the Guard class and this design choice would lead to at least 6 new classes. One new ACE_Reverse_Lock class seemed more reasonable.
typedef ACE_LOCKING_MECHANISM ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::ACE_LOCK |
ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::ACE_Reverse_Lock | ( | ACE_LOCKING_MECHANISM & | lock, |
ACE_Acquire_Method::METHOD_TYPE | acquire_method = ACE_Acquire_Method::ACE_REGULAR |
||
) |
Constructor. All locking requests will be forwarded to lock.
ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::~ACE_Reverse_Lock | ( | void | ) | [virtual] |
Destructor. If <lock_> was not passed in by the user, it will be deleted.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::acquire | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::acquire_read | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::acquire_write | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::release | ( | void | ) | [virtual] |
Acquire the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::remove | ( | void | ) | [virtual] |
Explicitly destroy the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::tryacquire | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::tryacquire_read | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::tryacquire_write | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
int ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::tryacquire_write_upgrade | ( | void | ) | [virtual] |
Release the lock.
Implements ACE_Lock.
ACE_Acquire_Method::METHOD_TYPE ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::acquire_method_ [private] |
This indicates what kind of acquire method will be called.
ACE_LOCKING_MECHANISM& ACE_Reverse_Lock< ACE_LOCKING_MECHANISM >::lock_ [private] |
The concrete locking mechanism that all the methods delegate to.