blocxx

ThreadCounter.hpp

Go to the documentation of this file.
00001 /*******************************************************************************
00002 * Copyright (C) 2005, Vintela, Inc. All rights reserved.
00003 * Copyright (C) 2006, Novell, Inc. All rights reserved.
00004 * 
00005 * Redistribution and use in source and binary forms, with or without
00006 * modification, are permitted provided that the following conditions are met:
00007 * 
00008 *     * Redistributions of source code must retain the above copyright notice,
00009 *       this list of conditions and the following disclaimer.
00010 *     * Redistributions in binary form must reproduce the above copyright
00011 *       notice, this list of conditions and the following disclaimer in the
00012 *       documentation and/or other materials provided with the distribution.
00013 *     * Neither the name of 
00014 *       Vintela, Inc., 
00015 *       nor Novell, Inc., 
00016 *       nor the names of its contributors or employees may be used to 
00017 *       endorse or promote products derived from this software without 
00018 *       specific prior written permission.
00019 * 
00020 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00021 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00022 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00023 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00024 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00025 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00026 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00027 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00028 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00029 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00030 * POSSIBILITY OF SUCH DAMAGE.
00031 *******************************************************************************/
00032 
00033 
00038 #ifndef BLOCXX_THREAD_COUNTER_HPP_INCLUDE_GUARD_
00039 #define BLOCXX_THREAD_COUNTER_HPP_INCLUDE_GUARD_
00040 #include "blocxx/BLOCXX_config.h"
00041 #include "blocxx/Types.hpp"
00042 #include "blocxx/NonRecursiveMutex.hpp"
00043 #include "blocxx/Condition.hpp"
00044 #include "blocxx/IntrusiveReference.hpp"
00045 #include "blocxx/IntrusiveCountableBase.hpp"
00046 #include "blocxx/ThreadDoneCallback.hpp"
00047 
00048 namespace BLOCXX_NAMESPACE
00049 {
00050 
00051 // Note: Do not inline any functions in these classes, the code must
00052 // be contained in the main library, if a loadable library contains any,
00053 // it will cause a race-condition that may segfault the application.
00054 class BLOCXX_COMMON_API ThreadCounter : public IntrusiveCountableBase
00055 {
00056 public:
00057    ThreadCounter(Int32 maxThreads);
00058    ~ThreadCounter();
00059    // Throws TimeoutException in case of timeout
00060    void incThreadCount(const Timeout& timeout);
00061    BLOCXX_DEPRECATED void incThreadCount(UInt32 sTimeout, UInt32 usTimeout);
00062    void decThreadCount();
00063    Int32 getThreadCount();
00064    // Throws TimeoutException in case of timeout
00065    void waitForAll(const Timeout& timeout);
00066    BLOCXX_DEPRECATED void waitForAll(UInt32 sTimeout, UInt32 usTimeout);
00067    void setMax(Int32 maxThreads);
00068 private:
00069    Int32 m_maxThreads;
00070    Int32 m_runCount;
00071    NonRecursiveMutex m_runCountGuard;
00072    Condition m_runCountCondition;
00073    // noncopyable
00074    ThreadCounter(ThreadCounter const&);
00075    ThreadCounter& operator=(ThreadCounter const&);
00076 };
00077 
00078 class BLOCXX_COMMON_API ThreadCountDecrementer : public ThreadDoneCallback
00079 {
00080 public:
00081    ThreadCountDecrementer(ThreadCounterRef const& x);
00082    virtual ~ThreadCountDecrementer();
00083 private:
00084    virtual void doNotifyThreadDone(Thread *);
00085 
00086 #ifdef BLOCXX_WIN32
00087 #pragma warning (push)
00088 #pragma warning (disable: 4251)
00089 #endif
00090 
00091    ThreadCounterRef m_counter;
00092 
00093 #ifdef BLOCXX_WIN32
00094 #pragma warning (pop)
00095 #endif
00096 
00097    // noncopyable
00098    ThreadCountDecrementer(ThreadCountDecrementer const&);
00099    ThreadCountDecrementer& operator=(ThreadCountDecrementer const&);
00100 };
00101 BLOCXX_EXPORT_TEMPLATE(BLOCXX_COMMON_API, IntrusiveReference, ThreadCounter);
00102 
00103 } // end namespace BLOCXX_NAMESPACE
00104 
00105 #endif