BeeeOn::Joiner Class Reference

Joiner implements join() on a thread that can be called multiple times from different threads. The point is that the Poco::Thread::join() MUST NOT be called twice (unless its timeout exceeds). More...

#include <Joiner.h>

Public Member Functions
	Joiner (Poco::Thread &thread)
void	join (const Poco::Timespan &timeout=-1)
	Join the underlying thread. The timeout controls whether we are waiting indefinitely (when negative) or we can be interrupted by timeout. More...
bool	tryJoin (const Poco::Timespan &timeout=-1)
	Join the underlying thread. The timeout controls whether we are waiting indefinitely (when negative) or we can be interrupted by timeout. More...

Protected Member Functions
void	joinFromMany (long ms)
	Implement locking to allow exactly 1 thread to call the join(). The lock respects the given timeout.
void	doJoin (long ms)
	Call the actual join based on the timeout.

Detailed Description

Joiner implements join() on a thread that can be called multiple times from different threads. The point is that the Poco::Thread::join() MUST NOT be called twice (unless its timeout exceeds).

The Joiner creates a queue of joining threads via FastMutex. All the threads are waiting on the mutex except one (in FIFO order) that performs the actual join(). If this single join succeeds, all other threads would return successfully. If the single one join does not succeeds (due to timeout), the next thread in the queue performs the actual join(), etc.

Member Function Documentation

void Joiner::join

(

const Poco::Timespan &

timeout = -1

)

Join the underlying thread. The timeout controls whether we are waiting indefinitely (when negative) or we can be interrupted by timeout.

Exceptions

Poco::TimeoutException

when the timeout exceeds

bool Joiner::tryJoin

(

const Poco::Timespan &

timeout = -1

)

Join the underlying thread. The timeout controls whether we are waiting indefinitely (when negative) or we can be interrupted by timeout.

Returns

true if the join has succeeded, false on timeout

---

The documentation for this class was generated from the following files:

• /var/lib/jenkins/workspace/beeeon-gateway-master/base/src/util/Joiner.h
• /var/lib/jenkins/workspace/beeeon-gateway-master/base/src/util/Joiner.cpp