/Dispatcher

G.O.D - Grand Object-bound Dispatcher

Primary LanguageC++MIT LicenseMIT

G.O.D: Grand Object-bound Dispatcher

G.O.D is a high performance non-blocking task dispatcher which guarantees class member functions' execution sequence

FEATURES

  • Designed for multi-platform by using C++11 standard
  • Visual Studio Solutions for now, but you can easily use in *NIX environment (Just #include relevant files)
  • Lock-free algorithms (non-blocking)
  • Using custom STL allocator
  • Deferred task execution using Timer
  • Simple code-base for easy to understand (easy to adapt to other projects)

BRANCHES

  • base_version: this master branch (basic version)
  • bind_version: std::bind is adopted instead of a custom Job class interface
  • LB_version: load-balancing among worker-threads (new arrival!)

HOW TO USE

// for a basic version

// IMPORTANT: the beginning of a workerthread, you should put this:
LMemoryPool = new LocalMemoryPool;
LExecuterList = new ExecuterListType;
LTimer = new Timer;

// after that, in the loop of the workerthread, put this:
LTimer->DoTimerJob();

// And then you can attach G.O.D (AsyncExecutable) to an object like this:
class TestObject : public AsyncExecutable
{
public:

	void TestFunc(double a, int b)
	{
	  // do something...
	}
	
	// ... ...
};

// Now, you can call a member function like this:
TestObject* testobj = new TestObject;
// ... ...
testobject->DoAsync(&TestObject::TestFunc, 100.123, 456);

// or, deferred execution 1000ms later like this:
testobject->DoAsyncAfter(1000, &TestObject::TestFunc, 100.123, 456);

For more information, just see self-explaning DispatcherTest.cpp

WARNING!

  1. You should use x64 mode due to std::atomic variable alignment
  2. You should guarantee the lifetime (i.e. AsyncExecutable::mRefCount > 0) of an object inherited from AsyncExecutable
  3. Be careful to use DoAsync(...) in a blockable LOCK (critical section). It can cause deadlock...