2012-04-29 20:52:25 +02:00
|
|
|
//
|
|
|
|
// Mutex.h
|
|
|
|
//
|
|
|
|
// $Id: //poco/1.4/Foundation/include/Poco/Mutex.h#2 $
|
|
|
|
//
|
|
|
|
// Library: Foundation
|
|
|
|
// Package: Threading
|
|
|
|
// Module: Mutex
|
|
|
|
//
|
|
|
|
// Definition of the Mutex and FastMutex classes.
|
|
|
|
//
|
|
|
|
// Copyright (c) 2004-2008, Applied Informatics Software Engineering GmbH.
|
|
|
|
// and Contributors.
|
|
|
|
//
|
2014-05-04 21:02:42 +02:00
|
|
|
// SPDX-License-Identifier: BSL-1.0
|
2012-04-29 20:52:25 +02:00
|
|
|
//
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef Foundation_Mutex_INCLUDED
|
|
|
|
#define Foundation_Mutex_INCLUDED
|
|
|
|
|
|
|
|
|
|
|
|
#include "Poco/Foundation.h"
|
|
|
|
#include "Poco/Exception.h"
|
|
|
|
#include "Poco/ScopedLock.h"
|
|
|
|
|
|
|
|
|
|
|
|
#if defined(POCO_OS_FAMILY_WINDOWS)
|
|
|
|
#if defined(_WIN32_WCE)
|
|
|
|
#include "Poco/Mutex_WINCE.h"
|
|
|
|
#else
|
|
|
|
#include "Poco/Mutex_WIN32.h"
|
|
|
|
#endif
|
|
|
|
#elif defined(POCO_VXWORKS)
|
|
|
|
#include "Poco/Mutex_VX.h"
|
|
|
|
#else
|
|
|
|
#include "Poco/Mutex_POSIX.h"
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
namespace Poco {
|
|
|
|
|
|
|
|
|
|
|
|
class Foundation_API Mutex: private MutexImpl
|
|
|
|
/// A Mutex (mutual exclusion) is a synchronization
|
|
|
|
/// mechanism used to control access to a shared resource
|
|
|
|
/// in a concurrent (multithreaded) scenario.
|
|
|
|
/// Using the ScopedLock class is the preferred way to automatically
|
|
|
|
/// lock and unlock a mutex.
|
|
|
|
{
|
|
|
|
public:
|
2015-01-14 11:48:22 +01:00
|
|
|
enum MutexType
|
|
|
|
/// The type of a mutex.
|
|
|
|
{
|
|
|
|
MUTEX_RECURSIVE = MUTEX_RECURSIVE_IMPL, /// A recursive mutex
|
|
|
|
MUTEX_NONRECURSIVE = MUTEX_NONRECURSIVE_IMPL, /// A non-recursive mutex
|
|
|
|
};
|
|
|
|
|
2012-04-29 20:52:25 +02:00
|
|
|
typedef Poco::ScopedLock<Mutex> ScopedLock;
|
|
|
|
|
2015-01-14 11:48:22 +01:00
|
|
|
explicit Mutex(MutexType type = MUTEX_RECURSIVE);
|
2015-01-17 12:58:01 +01:00
|
|
|
/// Creates the Mutex.
|
2012-04-29 20:52:25 +02:00
|
|
|
|
|
|
|
~Mutex();
|
2015-01-17 12:58:01 +01:00
|
|
|
/// Destroys the Mutex.
|
2012-04-29 20:52:25 +02:00
|
|
|
|
|
|
|
void lock();
|
|
|
|
/// Locks the mutex. Blocks if the mutex
|
|
|
|
/// is held by another thread.
|
|
|
|
|
|
|
|
void lock(long milliseconds);
|
|
|
|
/// Locks the mutex. Blocks up to the given number of milliseconds
|
|
|
|
/// if the mutex is held by another thread. Throws a TimeoutException
|
|
|
|
/// if the mutex can not be locked within the given timeout.
|
|
|
|
///
|
|
|
|
/// Performance Note: On most platforms (including Windows), this member function is
|
|
|
|
/// implemented using a loop calling (the equivalent of) tryLock() and Thread::sleep().
|
|
|
|
/// On POSIX platforms that support pthread_mutex_timedlock(), this is used.
|
|
|
|
|
|
|
|
bool tryLock();
|
|
|
|
/// Tries to lock the mutex. Returns false immediately
|
|
|
|
/// if the mutex is already held by another thread.
|
|
|
|
/// Returns true if the mutex was successfully locked.
|
|
|
|
|
|
|
|
bool tryLock(long milliseconds);
|
|
|
|
/// Locks the mutex. Blocks up to the given number of milliseconds
|
|
|
|
/// if the mutex is held by another thread.
|
|
|
|
/// Returns true if the mutex was successfully locked.
|
|
|
|
///
|
|
|
|
/// Performance Note: On most platforms (including Windows), this member function is
|
|
|
|
/// implemented using a loop calling (the equivalent of) tryLock() and Thread::sleep().
|
|
|
|
/// On POSIX platforms that support pthread_mutex_timedlock(), this is used.
|
|
|
|
|
|
|
|
void unlock();
|
|
|
|
/// Unlocks the mutex so that it can be acquired by
|
|
|
|
/// other threads.
|
|
|
|
|
|
|
|
private:
|
|
|
|
Mutex(const Mutex&);
|
|
|
|
Mutex& operator = (const Mutex&);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
class Foundation_API FastMutex: private FastMutexImpl
|
|
|
|
/// A FastMutex (mutual exclusion) is similar to a Mutex.
|
2014-11-01 10:38:56 +01:00
|
|
|
/// Locking a FastMutex is guaranteed to be at least as
|
|
|
|
/// fast as locking a Mutex. However, a FastMutex is not
|
|
|
|
/// guaranteed to be either recursive or non-recursive.
|
|
|
|
/// It is best suited to thread safe components like pools,
|
|
|
|
/// caches and queues where locking is internal to the component.
|
2012-04-29 20:52:25 +02:00
|
|
|
/// Using the ScopedLock class is the preferred way to automatically
|
|
|
|
/// lock and unlock a mutex.
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
typedef Poco::ScopedLock<FastMutex> ScopedLock;
|
|
|
|
|
|
|
|
FastMutex();
|
|
|
|
/// creates the Mutex.
|
|
|
|
|
|
|
|
~FastMutex();
|
|
|
|
/// destroys the Mutex.
|
|
|
|
|
|
|
|
void lock();
|
|
|
|
/// Locks the mutex. Blocks if the mutex
|
|
|
|
/// is held by another thread.
|
|
|
|
|
|
|
|
void lock(long milliseconds);
|
|
|
|
/// Locks the mutex. Blocks up to the given number of milliseconds
|
|
|
|
/// if the mutex is held by another thread. Throws a TimeoutException
|
|
|
|
/// if the mutex can not be locked within the given timeout.
|
|
|
|
///
|
|
|
|
/// Performance Note: On most platforms (including Windows), this member function is
|
|
|
|
/// implemented using a loop calling (the equivalent of) tryLock() and Thread::sleep().
|
|
|
|
/// On POSIX platforms that support pthread_mutex_timedlock(), this is used.
|
|
|
|
|
|
|
|
bool tryLock();
|
|
|
|
/// Tries to lock the mutex. Returns false immediately
|
|
|
|
/// if the mutex is already held by another thread.
|
|
|
|
/// Returns true if the mutex was successfully locked.
|
|
|
|
|
|
|
|
bool tryLock(long milliseconds);
|
|
|
|
/// Locks the mutex. Blocks up to the given number of milliseconds
|
|
|
|
/// if the mutex is held by another thread.
|
|
|
|
/// Returns true if the mutex was successfully locked.
|
|
|
|
///
|
|
|
|
/// Performance Note: On most platforms (including Windows), this member function is
|
|
|
|
/// implemented using a loop calling (the equivalent of) tryLock() and Thread::sleep().
|
|
|
|
/// On POSIX platforms that support pthread_mutex_timedlock(), this is used.
|
|
|
|
|
|
|
|
void unlock();
|
|
|
|
/// Unlocks the mutex so that it can be acquired by
|
|
|
|
/// other threads.
|
|
|
|
|
|
|
|
private:
|
|
|
|
FastMutex(const FastMutex&);
|
|
|
|
FastMutex& operator = (const FastMutex&);
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
class Foundation_API NullMutex
|
|
|
|
/// A NullMutex is an empty mutex implementation
|
|
|
|
/// which performs no locking at all. Useful in policy driven design
|
|
|
|
/// where the type of mutex used can be now a template parameter allowing the user to switch
|
|
|
|
/// between thread-safe and not thread-safe depending on his need
|
|
|
|
/// Works with the ScopedLock class
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
typedef Poco::ScopedLock<NullMutex> ScopedLock;
|
|
|
|
|
|
|
|
NullMutex()
|
|
|
|
/// Creates the NullMutex.
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
~NullMutex()
|
|
|
|
/// Destroys the NullMutex.
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
void lock()
|
|
|
|
/// Does nothing.
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
void lock(long)
|
|
|
|
/// Does nothing.
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
bool tryLock()
|
|
|
|
/// Does nothing and always returns true.
|
|
|
|
{
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool tryLock(long)
|
|
|
|
/// Does nothing and always returns true.
|
|
|
|
{
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
void unlock()
|
|
|
|
/// Does nothing.
|
|
|
|
{
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
//
|
|
|
|
// inlines
|
|
|
|
//
|
|
|
|
inline void Mutex::lock()
|
|
|
|
{
|
|
|
|
lockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline void Mutex::lock(long milliseconds)
|
|
|
|
{
|
|
|
|
if (!tryLockImpl(milliseconds))
|
|
|
|
throw TimeoutException();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline bool Mutex::tryLock()
|
|
|
|
{
|
|
|
|
return tryLockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline bool Mutex::tryLock(long milliseconds)
|
|
|
|
{
|
|
|
|
return tryLockImpl(milliseconds);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline void Mutex::unlock()
|
|
|
|
{
|
|
|
|
unlockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline void FastMutex::lock()
|
|
|
|
{
|
|
|
|
lockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline void FastMutex::lock(long milliseconds)
|
|
|
|
{
|
|
|
|
if (!tryLockImpl(milliseconds))
|
|
|
|
throw TimeoutException();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline bool FastMutex::tryLock()
|
|
|
|
{
|
|
|
|
return tryLockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline bool FastMutex::tryLock(long milliseconds)
|
|
|
|
{
|
|
|
|
return tryLockImpl(milliseconds);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
inline void FastMutex::unlock()
|
|
|
|
{
|
|
|
|
unlockImpl();
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
} // namespace Poco
|
|
|
|
|
|
|
|
|
|
|
|
#endif // Foundation_Mutex_INCLUDED
|