2001-09-29 00:14:13 +04:00
|
|
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
|
|
|
* Version: NPL 1.1/GPL 2.0/LGPL 2.1
|
1999-02-04 01:44:14 +03:00
|
|
|
*
|
2001-09-29 00:14:13 +04:00
|
|
|
* The contents of this file are subject to the Netscape Public License
|
|
|
|
* Version 1.1 (the "License"); you may not use this file except in
|
|
|
|
* compliance with the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/NPL/
|
1999-02-04 01:44:14 +03:00
|
|
|
*
|
2001-09-29 00:14:13 +04:00
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
1999-02-04 01:44:14 +03:00
|
|
|
*
|
1999-11-06 06:43:54 +03:00
|
|
|
* The Original Code is mozilla.org code.
|
|
|
|
*
|
2001-09-29 00:14:13 +04:00
|
|
|
* The Initial Developer of the Original Code is
|
|
|
|
* Netscape Communications Corporation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 1998
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
1999-11-06 06:43:54 +03:00
|
|
|
*
|
2001-09-29 00:14:13 +04:00
|
|
|
* Contributor(s):
|
|
|
|
*
|
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
|
|
* either the GNU General Public License Version 2 or later (the "GPL"), or
|
|
|
|
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
|
|
* use your version of this file under the terms of the NPL, indicate your
|
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
|
|
|
* the terms of any one of the NPL, the GPL or the LGPL.
|
|
|
|
*
|
|
|
|
* ***** END LICENSE BLOCK ***** */
|
1999-02-04 01:44:14 +03:00
|
|
|
|
|
|
|
|
|
|
|
/*
|
1999-02-05 02:20:30 +03:00
|
|
|
A stack-based lock object that makes using PRLock a bit more
|
1999-02-04 01:44:14 +03:00
|
|
|
convenient. It acquires the monitor when constructed, and releases
|
|
|
|
it when it goes out of scope.
|
|
|
|
|
|
|
|
For example,
|
|
|
|
|
|
|
|
class Foo {
|
|
|
|
private:
|
|
|
|
PRLock* mLock;
|
|
|
|
|
|
|
|
public:
|
|
|
|
Foo(void) {
|
|
|
|
mLock = PR_NewLock();
|
|
|
|
}
|
|
|
|
|
|
|
|
virtual ~Foo(void) {
|
|
|
|
PR_DestroyLock(mLock);
|
|
|
|
}
|
|
|
|
|
|
|
|
void ThreadSafeMethod(void) {
|
1999-02-05 02:20:30 +03:00
|
|
|
// we're don't hold the lock yet...
|
1999-02-04 01:44:14 +03:00
|
|
|
|
|
|
|
nsAutoLock lock(mLock);
|
|
|
|
// ...but now we do.
|
|
|
|
|
|
|
|
// we even can do wacky stuff like return from arbitrary places w/o
|
1999-02-05 02:20:30 +03:00
|
|
|
// worrying about forgetting to release the lock
|
1999-02-04 01:44:14 +03:00
|
|
|
if (some_weird_condition)
|
|
|
|
return;
|
|
|
|
|
|
|
|
// otherwise do some other stuff
|
|
|
|
}
|
|
|
|
|
|
|
|
void ThreadSafeBlockScope(void) {
|
1999-02-05 02:20:30 +03:00
|
|
|
// we're not in the lock here...
|
1999-02-04 01:44:14 +03:00
|
|
|
|
|
|
|
{
|
|
|
|
nsAutoLock lock(mLock);
|
|
|
|
// but we are now, at least until the block scope closes
|
|
|
|
}
|
|
|
|
|
1999-02-05 02:20:30 +03:00
|
|
|
// ...now we're not in the lock anymore
|
1999-02-04 01:44:14 +03:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
A similar stack-based locking object is available for PRMonitor. The
|
|
|
|
major difference is that the PRMonitor must be created and destroyed
|
|
|
|
via the static methods on nsAutoMonitor.
|
|
|
|
|
|
|
|
For example:
|
|
|
|
Foo::Foo() {
|
|
|
|
mMon = nsAutoMonitor::NewMonitor("FooMonitor");
|
|
|
|
}
|
|
|
|
nsresult Foo::MyMethod(...) {
|
|
|
|
nsAutoMonitor mon(mMon);
|
|
|
|
...
|
|
|
|
// go ahead and do deeply nested returns...
|
|
|
|
return NS_ERROR_FAILURE;
|
|
|
|
...
|
|
|
|
// or call Wait or Notify...
|
|
|
|
mon.Wait();
|
|
|
|
...
|
|
|
|
// cleanup is automatic
|
|
|
|
}
|
1999-02-04 01:44:14 +03:00
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef nsAutoLock_h__
|
|
|
|
#define nsAutoLock_h__
|
|
|
|
|
1999-02-04 03:39:49 +03:00
|
|
|
#include "nscore.h"
|
1999-02-04 01:44:14 +03:00
|
|
|
#include "prlock.h"
|
1999-02-04 03:39:49 +03:00
|
|
|
#include "prlog.h"
|
1999-02-04 01:44:14 +03:00
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* nsAutoLockBase
|
|
|
|
* This is the base class for the stack-based locking objects.
|
|
|
|
* Clients of derived classes need not play with this superclass.
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
class NS_COM nsAutoLockBase {
|
|
|
|
protected:
|
|
|
|
nsAutoLockBase() {}
|
|
|
|
enum nsAutoLockType {eAutoLock, eAutoMonitor, eAutoCMonitor};
|
|
|
|
|
|
|
|
#ifdef DEBUG
|
|
|
|
nsAutoLockBase(void* addr, nsAutoLockType type);
|
|
|
|
~nsAutoLockBase();
|
|
|
|
|
1999-09-07 03:00:17 +04:00
|
|
|
void* mAddr;
|
|
|
|
nsAutoLockBase* mDown;
|
|
|
|
nsAutoLockType mType;
|
1999-09-06 23:28:56 +04:00
|
|
|
#else
|
|
|
|
nsAutoLockBase(void* addr, nsAutoLockType type) {}
|
|
|
|
~nsAutoLockBase() {}
|
|
|
|
#endif
|
|
|
|
};
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* nsAutoLock
|
|
|
|
* Stack-based locking object for PRLock.
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
class NS_COM nsAutoLock : public nsAutoLockBase {
|
1999-02-04 01:44:14 +03:00
|
|
|
private:
|
|
|
|
PRLock* mLock;
|
1999-11-16 01:15:27 +03:00
|
|
|
PRBool mLocked;
|
1999-02-04 01:44:14 +03:00
|
|
|
|
1999-02-04 03:25:56 +03:00
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// construct or assign an nsAutoLock object incorrectly.
|
1999-02-04 01:44:14 +03:00
|
|
|
nsAutoLock(void) {}
|
1999-07-07 08:17:45 +04:00
|
|
|
nsAutoLock(nsAutoLock& /*aLock*/) {}
|
|
|
|
nsAutoLock& operator =(nsAutoLock& /*aLock*/) {
|
1999-02-04 03:25:56 +03:00
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// attempt to create an nsAutoLock object on the heap.
|
2002-07-03 00:25:30 +04:00
|
|
|
static void* operator new(size_t /*size*/) CPP_THROW_NEW {
|
1999-02-04 03:25:56 +03:00
|
|
|
return nsnull;
|
|
|
|
}
|
1999-07-07 08:17:45 +04:00
|
|
|
static void operator delete(void* /*memory*/) {}
|
1999-02-04 01:44:14 +03:00
|
|
|
|
|
|
|
public:
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* Constructor
|
|
|
|
* The constructor aquires the given lock. The destructor
|
|
|
|
* releases the lock.
|
|
|
|
*
|
|
|
|
* @param aLock A valid PRLock* returned from the NSPR's
|
|
|
|
* PR_NewLock() function.
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
nsAutoLock(PRLock* aLock)
|
|
|
|
: nsAutoLockBase(aLock, eAutoLock),
|
1999-11-16 01:15:27 +03:00
|
|
|
mLock(aLock),
|
|
|
|
mLocked(PR_TRUE) {
|
1999-02-04 01:44:14 +03:00
|
|
|
PR_ASSERT(mLock);
|
|
|
|
|
|
|
|
// This will assert deep in the bowels of NSPR if you attempt
|
|
|
|
// to re-enter the lock.
|
|
|
|
PR_Lock(mLock);
|
|
|
|
}
|
2002-04-05 03:04:53 +04:00
|
|
|
|
1999-02-04 01:44:14 +03:00
|
|
|
~nsAutoLock(void) {
|
1999-11-16 01:15:27 +03:00
|
|
|
if (mLocked)
|
|
|
|
PR_Unlock(mLock);
|
|
|
|
}
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* lock
|
|
|
|
* Client may call this to reaquire the given lock. Take special
|
|
|
|
* note that attempting to aquire a locked lock will hang or crash.
|
|
|
|
**/
|
1999-11-16 01:15:27 +03:00
|
|
|
void lock() {
|
|
|
|
PR_ASSERT(!mLocked);
|
|
|
|
PR_Lock(mLock);
|
|
|
|
mLocked = PR_TRUE;
|
|
|
|
}
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* unlock
|
|
|
|
* Client may call this to release the given lock. Take special
|
|
|
|
* note unlocking an unlocked lock has undefined results.
|
|
|
|
**/
|
|
|
|
void unlock() {
|
1999-11-16 01:15:27 +03:00
|
|
|
PR_ASSERT(mLocked);
|
1999-02-04 01:44:14 +03:00
|
|
|
PR_Unlock(mLock);
|
1999-11-16 01:15:27 +03:00
|
|
|
mLocked = PR_FALSE;
|
1999-02-04 01:44:14 +03:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
1999-04-22 08:12:08 +04:00
|
|
|
#include "prcmon.h"
|
1999-05-01 03:49:30 +04:00
|
|
|
#include "nsError.h"
|
2002-09-07 21:13:19 +04:00
|
|
|
#include "nsDebug.h"
|
1999-04-22 08:12:08 +04:00
|
|
|
|
1999-09-06 23:28:56 +04:00
|
|
|
class NS_COM nsAutoMonitor : public nsAutoLockBase {
|
1999-04-22 08:12:08 +04:00
|
|
|
public:
|
2002-04-05 03:04:53 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* NewMonitor
|
|
|
|
* Allocates a new PRMonitor for use with nsAutoMonitor.
|
|
|
|
* @param name A (unique /be?) name which can reference this monitor
|
|
|
|
* @returns nsnull if failure
|
|
|
|
* A valid PRMonitor* is successful while must be destroyed
|
|
|
|
* by nsAutoMonitor::DestroyMonitor()
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
static PRMonitor* NewMonitor(const char* name);
|
|
|
|
static void DestroyMonitor(PRMonitor* mon);
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor
|
|
|
|
* The constructor locks the given monitor. During destruction
|
|
|
|
* the monitor will be unlocked.
|
|
|
|
*
|
|
|
|
* @param mon A valid PRMonitor* returned from
|
|
|
|
* nsAutoMonitor::NewMonitor().
|
|
|
|
**/
|
1999-06-16 08:15:08 +04:00
|
|
|
nsAutoMonitor(PRMonitor* mon)
|
1999-09-06 23:28:56 +04:00
|
|
|
: nsAutoLockBase((void*)mon, eAutoMonitor),
|
2001-07-17 01:26:04 +04:00
|
|
|
mMonitor(mon), mLockCount(0)
|
1999-06-16 08:15:08 +04:00
|
|
|
{
|
1999-09-06 23:28:56 +04:00
|
|
|
NS_ASSERTION(mMonitor, "null monitor");
|
2001-07-17 01:26:04 +04:00
|
|
|
if (mMonitor) {
|
|
|
|
PR_EnterMonitor(mMonitor);
|
|
|
|
mLockCount = 1;
|
|
|
|
}
|
1999-06-16 08:15:08 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
~nsAutoMonitor() {
|
2001-07-17 01:26:04 +04:00
|
|
|
NS_ASSERTION(mMonitor, "null monitor");
|
|
|
|
if (mMonitor && mLockCount) {
|
2001-03-20 01:14:07 +03:00
|
|
|
#ifdef DEBUG
|
2001-07-17 01:26:04 +04:00
|
|
|
PRStatus status =
|
2001-03-20 01:14:07 +03:00
|
|
|
#endif
|
2001-07-17 01:26:04 +04:00
|
|
|
PR_ExitMonitor(mMonitor);
|
|
|
|
NS_ASSERTION(status == PR_SUCCESS, "PR_ExitMonitor failed");
|
|
|
|
}
|
1999-06-16 08:15:08 +04:00
|
|
|
}
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* Enter
|
|
|
|
* Client may call this to reenter the given monitor.
|
|
|
|
* @see prmon.h
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
void Enter();
|
2002-04-05 03:04:53 +04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Exit
|
|
|
|
* Client may call this to exit the given monitor.
|
|
|
|
* @see prmon.h
|
|
|
|
**/
|
1999-09-06 23:28:56 +04:00
|
|
|
void Exit();
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* Wait
|
|
|
|
* @see prmon.h
|
|
|
|
**/
|
1999-06-16 08:15:08 +04:00
|
|
|
nsresult Wait(PRIntervalTime interval = PR_INTERVAL_NO_TIMEOUT) {
|
|
|
|
return PR_Wait(mMonitor, interval) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
|
|
|
}
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* Notify
|
|
|
|
* @see prmon.h
|
|
|
|
**/
|
1999-06-16 08:15:08 +04:00
|
|
|
nsresult Notify() {
|
|
|
|
return PR_Notify(mMonitor) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
|
|
|
}
|
|
|
|
|
2002-04-05 03:04:53 +04:00
|
|
|
/**
|
|
|
|
* NotifyAll
|
|
|
|
* @see prmon.h
|
|
|
|
**/
|
1999-06-16 08:15:08 +04:00
|
|
|
nsresult NotifyAll() {
|
|
|
|
return PR_NotifyAll(mMonitor) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
1999-09-06 23:28:56 +04:00
|
|
|
PRMonitor* mMonitor;
|
2001-07-17 01:26:04 +04:00
|
|
|
PRInt32 mLockCount;
|
1999-06-16 08:15:08 +04:00
|
|
|
|
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// construct or assign an nsAutoLock object incorrectly.
|
|
|
|
nsAutoMonitor(void) {}
|
1999-07-07 08:17:45 +04:00
|
|
|
nsAutoMonitor(nsAutoMonitor& /*aMon*/) {}
|
|
|
|
nsAutoMonitor& operator =(nsAutoMonitor& /*aMon*/) {
|
1999-06-16 08:15:08 +04:00
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// attempt to create an nsAutoLock object on the heap.
|
2002-07-03 00:25:30 +04:00
|
|
|
static void* operator new(size_t /*size*/) CPP_THROW_NEW {
|
1999-06-16 08:15:08 +04:00
|
|
|
return nsnull;
|
|
|
|
}
|
1999-07-07 08:17:45 +04:00
|
|
|
static void operator delete(void* /*memory*/) {}
|
1999-06-16 08:15:08 +04:00
|
|
|
};
|
|
|
|
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Once again, this time with a cache...
|
|
|
|
// (Using this avoids the need to allocate a PRMonitor, which may be useful when
|
|
|
|
// a large number of objects of the same class need associated monitors.)
|
|
|
|
|
|
|
|
#include "prcmon.h"
|
|
|
|
#include "nsError.h"
|
|
|
|
|
1999-09-06 23:28:56 +04:00
|
|
|
class NS_COM nsAutoCMonitor : public nsAutoLockBase {
|
1999-06-16 08:15:08 +04:00
|
|
|
public:
|
|
|
|
nsAutoCMonitor(void* lockObject)
|
1999-09-06 23:28:56 +04:00
|
|
|
: nsAutoLockBase(lockObject, eAutoCMonitor),
|
2001-07-17 01:26:04 +04:00
|
|
|
mLockObject(lockObject), mLockCount(0)
|
1999-04-22 08:12:08 +04:00
|
|
|
{
|
|
|
|
NS_ASSERTION(lockObject, "null lock object");
|
|
|
|
PR_CEnterMonitor(mLockObject);
|
2001-07-17 01:26:04 +04:00
|
|
|
mLockCount = 1;
|
1999-04-22 08:12:08 +04:00
|
|
|
}
|
|
|
|
|
1999-06-16 08:15:08 +04:00
|
|
|
~nsAutoCMonitor() {
|
2001-07-17 01:26:04 +04:00
|
|
|
if (mLockCount) {
|
2001-03-20 01:14:07 +03:00
|
|
|
#ifdef DEBUG
|
2001-07-17 01:26:04 +04:00
|
|
|
PRStatus status =
|
2001-03-20 01:14:07 +03:00
|
|
|
#endif
|
2001-07-17 01:26:04 +04:00
|
|
|
PR_CExitMonitor(mLockObject);
|
|
|
|
NS_ASSERTION(status == PR_SUCCESS, "PR_CExitMonitor failed");
|
|
|
|
}
|
1999-04-22 08:12:08 +04:00
|
|
|
}
|
|
|
|
|
1999-09-06 23:28:56 +04:00
|
|
|
void Enter();
|
|
|
|
void Exit();
|
|
|
|
|
1999-05-01 02:55:16 +04:00
|
|
|
nsresult Wait(PRIntervalTime interval = PR_INTERVAL_NO_TIMEOUT) {
|
|
|
|
return PR_CWait(mLockObject, interval) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
1999-04-22 08:12:08 +04:00
|
|
|
}
|
|
|
|
|
1999-05-01 02:55:16 +04:00
|
|
|
nsresult Notify() {
|
|
|
|
return PR_CNotify(mLockObject) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
1999-04-22 08:12:08 +04:00
|
|
|
}
|
|
|
|
|
1999-05-01 02:55:16 +04:00
|
|
|
nsresult NotifyAll() {
|
|
|
|
return PR_CNotifyAll(mLockObject) == PR_SUCCESS
|
|
|
|
? NS_OK : NS_ERROR_FAILURE;
|
1999-04-22 08:12:08 +04:00
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
2001-07-17 01:26:04 +04:00
|
|
|
void* mLockObject;
|
|
|
|
PRInt32 mLockCount;
|
1999-04-22 08:12:08 +04:00
|
|
|
|
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// construct or assign an nsAutoLock object incorrectly.
|
1999-06-16 08:15:08 +04:00
|
|
|
nsAutoCMonitor(void) {}
|
1999-07-07 08:17:45 +04:00
|
|
|
nsAutoCMonitor(nsAutoCMonitor& /*aMon*/) {}
|
|
|
|
nsAutoCMonitor& operator =(nsAutoCMonitor& /*aMon*/) {
|
1999-04-22 08:12:08 +04:00
|
|
|
return *this;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Not meant to be implemented. This makes it a compiler error to
|
|
|
|
// attempt to create an nsAutoLock object on the heap.
|
2002-07-03 00:25:30 +04:00
|
|
|
static void* operator new(size_t /*size*/) CPP_THROW_NEW {
|
1999-04-22 08:12:08 +04:00
|
|
|
return nsnull;
|
|
|
|
}
|
1999-07-07 08:17:45 +04:00
|
|
|
static void operator delete(void* /*memory*/) {}
|
1999-04-22 08:12:08 +04:00
|
|
|
};
|
1999-02-04 01:44:14 +03:00
|
|
|
|
|
|
|
#endif // nsAutoLock_h__
|
2002-04-05 03:04:53 +04:00
|
|
|
|