new classes; yajl library

[chaz/yoink] / src / dispatcher.hh

diff --git a/src/dispatcher.hh b/src/dispatcher.hh
new file mode 100644 (file)
index 0000000..e45e88e
--- /dev/null
+++ b/src/dispatcher.hh
@@ -0,0 +1,84 @@
+
+/*******************************************************************************
+
+ Copyright (c) 2009, Charles McGarvey
+ All rights reserved.
+ 
+ Redistribution   and   use  in  source  and  binary  forms,  with  or  without
+ modification, are permitted provided that the following conditions are met:
+ 
+   * Redistributions  of  source  code  must retain the above copyright notice,
+     this list of conditions and the following disclaimer.
+   * Redistributions  in binary form must reproduce the above copyright notice,
+     this  list of conditions and the following disclaimer in the documentation
+     and/or other materials provided with the distribution.
+ 
+ THIS  SOFTWARE  IS  PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ AND  ANY  EXPRESS  OR  IMPLIED  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ DISCLAIMED.  IN  NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ FOR  ANY  DIRECT,  INDIRECT,  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ DAMAGES  (INCLUDING,  BUT  NOT  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES;  LOSS  OF  USE,  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ CAUSED  AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+*******************************************************************************/
+
+#ifndef _DISPATCHER_HH_
+#define _DISPATCHER_HH_
+
+/**
+ * @file dispatcher.hh
+ * Dispatching of information.
+ */
+
+#include <string>
+
+#include <boost/shared_ptr.hpp>
+#include <boost/function.hpp>
+
+#include "singleton.hh"
+
+
+namespace dc {
+
+
+// Subclass this to create more specific notes to dispatch.
+class notification
+{
+public:
+       virtual ~notification();
+};
+
+
+class dispatcher_impl;
+
+class dispatcher : public singleton<dispatcher>
+{
+public:
+       typedef void* handler;
+
+       dispatcher();
+
+       typedef boost::function<void(const notification&)> function;
+
+       handler addHandler(const std::string& message, const function& callback);
+       handler addHandler(const std::string& message, const function& callback,
+                       handler id);
+
+       void removeHandler(handler id);
+
+       void dispatch(const std::string& message);
+       void dispatch(const std::string& message, const notification& param);
+
+private:
+       boost::shared_ptr<dispatcher_impl> impl;
+};
+
+
+} // namespace dc
+
+#endif // _DISPATCHER_HH_
+