Fawkes API  Fawkes Development Version
interface_dispatcher.h
1 
2 /***************************************************************************
3  * interface_dispatcher.cpp - BlackBoard listener and dispatcher
4  *
5  * Created: Thu Oct 09 23:04:59 2008
6  * Copyright 2008 Tim Niemueller [www.niemueller.de]
7  *
8  ****************************************************************************/
9 
10 /* This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version. A runtime exception applies to
14  * this software (see LICENSE.GPL_WRE file mentioned below for details).
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19  * GNU Library General Public License for more details.
20  *
21  * Read the full text in the LICENSE.GPL_WRE file in the doc directory.
22  */
23 
24 #ifndef _LIBS_GUI_UTILS_INTERFACE_DISPATCHER_H_
25 #define _LIBS_GUI_UTILS_INTERFACE_DISPATCHER_H_
26 
27 #include <blackboard/interface_listener.h>
28 #include <core/utils/lock_queue.h>
29 #include <glibmm/dispatcher.h>
30 
31 #include <cstddef>
32 
33 namespace fawkes {
34 class Interface;
35 
36 class InterfaceDispatcher : public BlackBoardInterfaceListener
37 {
38 public:
39  InterfaceDispatcher(const char * listener_name,
40  fawkes::Interface *iface,
41  bool message_enqueueing = true);
42 
43  InterfaceDispatcher(const char * listener_name_prefix,
44  std::list<fawkes::Interface *> ifaces,
45  bool message_enqueueing = true);
46 
47  void set_message_enqueueing(bool enqueue);
48 
49  sigc::signal<void, Interface *> signal_data_changed();
50  sigc::signal<void, Interface *, Message *> signal_message_received();
51  sigc::signal<void, Interface *> signal_writer_added();
52  sigc::signal<void, Interface *> signal_writer_removed();
53  sigc::signal<void, Interface *> signal_reader_added();
54  sigc::signal<void, Interface *> signal_reader_removed();
55 
56  virtual void bb_interface_data_changed(Interface *interface) throw();
57  virtual bool bb_interface_message_received(Interface *interface, Message *message) throw();
58  virtual void bb_interface_writer_added(Interface * interface,
59  unsigned int instance_serial) throw();
60  virtual void bb_interface_writer_removed(Interface * interface,
61  unsigned int instance_serial) throw();
62  virtual void bb_interface_reader_added(Interface * interface,
63  unsigned int instance_serial) throw();
64  virtual void bb_interface_reader_removed(Interface * interface,
65  unsigned int instance_serial) throw();
66 
67 protected:
68  virtual void on_data_changed();
69  virtual void on_message_received();
70  virtual void on_writer_added();
71  virtual void on_writer_removed();
72  virtual void on_reader_added();
73  virtual void on_reader_removed();
74 
75 private:
76  void setup_signals();
77 
78 private:
79  bool message_enqueueing_;
80 
81  Glib::Dispatcher dispatcher_data_changed_;
82  Glib::Dispatcher dispatcher_message_received_;
83  Glib::Dispatcher dispatcher_writer_added_;
84  Glib::Dispatcher dispatcher_writer_removed_;
85  Glib::Dispatcher dispatcher_reader_added_;
86  Glib::Dispatcher dispatcher_reader_removed_;
87 
88  sigc::signal<void, Interface *> signal_data_changed_;
89  sigc::signal<void, Interface *, Message *> signal_message_received_;
90  sigc::signal<void, Interface *> signal_writer_added_;
91  sigc::signal<void, Interface *> signal_writer_removed_;
92  sigc::signal<void, Interface *> signal_reader_added_;
93  sigc::signal<void, Interface *> signal_reader_removed_;
94 
95  LockQueue<Interface *> queue_data_changed_;
96  LockQueue<std::pair<Interface *, Message *>> queue_message_received_;
97  LockQueue<Interface *> queue_writer_added_;
98  LockQueue<Interface *> queue_writer_removed_;
99  LockQueue<Interface *> queue_reader_added_;
100  LockQueue<Interface *> queue_reader_removed_;
101 };
102 
103 } // namespace fawkes
104 
105 #endif
fawkes::InterfaceDispatcher::bb_interface_writer_added
virtual void bb_interface_writer_added(Interface *interface, unsigned int instance_serial)
A writing instance has been opened for a watched interface.
Definition: interface_dispatcher.cpp:229
fawkes::InterfaceDispatcher::bb_interface_reader_removed
virtual void bb_interface_reader_removed(Interface *interface, unsigned int instance_serial)
A reading instance has been closed for a watched interface.
Definition: interface_dispatcher.cpp:253
fawkes::InterfaceDispatcher::on_writer_removed
virtual void on_writer_removed()
Internal event handler.
Definition: interface_dispatcher.cpp:171
fawkes::InterfaceDispatcher::signal_writer_added
sigc::signal< void, Interface * > signal_writer_added()
Get "writer added" signal.
Definition: interface_dispatcher.cpp:287
fawkes::InterfaceDispatcher::on_reader_added
virtual void on_reader_added()
Internal event handler.
Definition: interface_dispatcher.cpp:186
fawkes::InterfaceDispatcher::bb_interface_message_received
virtual bool bb_interface_message_received(Interface *interface, Message *message)
BlackBoard message received notification.
Definition: interface_dispatcher.cpp:220
fawkes::InterfaceDispatcher::signal_writer_removed
sigc::signal< void, Interface * > signal_writer_removed()
Get "writer removed" signal.
Definition: interface_dispatcher.cpp:297
fawkes::InterfaceDispatcher::set_message_enqueueing
void set_message_enqueueing(bool enqueue)
Set if received messages should be enqueued or not.
Definition: interface_dispatcher.cpp:116
fawkes::Message
Definition: message.h:41
fawkes::InterfaceDispatcher::on_reader_removed
virtual void on_reader_removed()
Internal event handler.
Definition: interface_dispatcher.cpp:201
fawkes::InterfaceDispatcher::on_message_received
virtual void on_message_received()
Internal event handler.
Definition: interface_dispatcher.cpp:140
fawkes::InterfaceDispatcher::on_data_changed
virtual void on_data_changed()
Internal event handler.
Definition: interface_dispatcher.cpp:125
fawkes::InterfaceDispatcher::bb_interface_data_changed
virtual void bb_interface_data_changed(Interface *interface)
BlackBoard data changed notification.
Definition: interface_dispatcher.cpp:213
fawkes::InterfaceDispatcher::signal_reader_removed
sigc::signal< void, Interface * > signal_reader_removed()
Get "reader removed" signal.
Definition: interface_dispatcher.cpp:317
fawkes::InterfaceDispatcher::bb_interface_reader_added
virtual void bb_interface_reader_added(Interface *interface, unsigned int instance_serial)
A reading instance has been opened for a watched interface.
Definition: interface_dispatcher.cpp:245
fawkes
fawkes::InterfaceDispatcher::bb_interface_writer_removed
virtual void bb_interface_writer_removed(Interface *interface, unsigned int instance_serial)
A writing instance has been closed for a watched interface.
Definition: interface_dispatcher.cpp:237
fawkes::Interface
Definition: interface.h:78
fawkes::InterfaceDispatcher::on_writer_added
virtual void on_writer_added()
Internal event handler.
Definition: interface_dispatcher.cpp:156
fawkes::InterfaceDispatcher::InterfaceDispatcher
InterfaceDispatcher(const char *listener_name, fawkes::Interface *iface, bool message_enqueueing=true)
Constructor.
Definition: interface_dispatcher.cpp:52
fawkes::InterfaceDispatcher::signal_reader_added
sigc::signal< void, Interface * > signal_reader_added()
Get "reader added" signal.
Definition: interface_dispatcher.cpp:307
fawkes::LockQueue
Definition: lock_queue.h:50
fawkes::InterfaceDispatcher::signal_message_received
sigc::signal< void, Interface *, Message * > signal_message_received()
Get "message received" signal.
Definition: interface_dispatcher.cpp:277
fawkes::InterfaceDispatcher::signal_data_changed
sigc::signal< void, Interface * > signal_data_changed()
Get "data changed" signal.
Definition: interface_dispatcher.cpp:265