Fawkes API  Fawkes Development Version
ownership.h
1 
2 /***************************************************************************
3  * ownership.h - BlackBoard with traced ownership
4  *
5  * Created: Thu Jan 22 15:16:15 2015
6  * Copyright 2015 Tim Niemueller [www.niemueller.de]
7  ****************************************************************************/
8 
9 /* This program is free software; you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation; either version 2 of the License, or
12  * (at your option) any later version. A runtime exception applies to
13  * this software (see LICENSE.GPL_WRE file mentioned below for details).
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU Library General Public License for more details.
19  *
20  * Read the full text in the LICENSE.GPL_WRE file in the doc directory.
21  */
22 
23 #ifndef _BLACKBOARD_OWNERSHIP_H_
24 #define _BLACKBOARD_OWNERSHIP_H_
25 
26 #include <blackboard/blackboard.h>
27 
28 namespace fawkes {
29 
30 class BlackBoardWithOwnership : public BlackBoard
31 {
32 public:
33  BlackBoardWithOwnership(BlackBoard *parent, const char *owner);
34  virtual ~BlackBoardWithOwnership();
35 
36  virtual Interface *
37  open_for_reading(const char *interface_type, const char *identifier, const char *owner = NULL);
38  virtual Interface *
39  open_for_writing(const char *interface_type, const char *identifier, const char *owner = NULL);
40  virtual void close(Interface *interface);
41 
42  virtual InterfaceInfoList *list_all();
43  virtual InterfaceInfoList *list(const char *type_pattern, const char *id_pattern);
44  virtual bool is_alive() const throw();
45  virtual bool try_aliveness_restore() throw();
46 
47  virtual std::list<Interface *> open_multiple_for_reading(const char *type_pattern,
48  const char *id_pattern = "*",
49  const char *owner = NULL);
50 
51  virtual void register_listener(BlackBoardInterfaceListener *listener,
53  virtual void update_listener(BlackBoardInterfaceListener *listener,
55  virtual void unregister_listener(BlackBoardInterfaceListener *listener);
56 
57  virtual void register_observer(BlackBoardInterfaceObserver *observer);
58  virtual void unregister_observer(BlackBoardInterfaceObserver *observer);
59 
60 private: /* members */
61  BlackBoard *blackboard_;
62  std::string owner_;
63 };
64 
65 } // end namespace fawkes
66 
67 #endif
fawkes::BlackBoardWithOwnership::list_all
virtual InterfaceInfoList * list_all()
Definition: ownership.cpp:97
fawkes::BlackBoardWithOwnership::try_aliveness_restore
virtual bool try_aliveness_restore()
Definition: ownership.cpp:115
fawkes::BlackBoardWithOwnership::BlackBoardWithOwnership
BlackBoardWithOwnership(BlackBoard *parent, const char *owner)
Constructor.
Definition: ownership.cpp:48
fawkes::BlackBoardWithOwnership::open_for_reading
virtual Interface * open_for_reading(const char *interface_type, const char *identifier, const char *owner=NULL)
Definition: ownership.cpp:65
fawkes::BlackBoardWithOwnership::unregister_listener
virtual void unregister_listener(BlackBoardInterfaceListener *listener)
Unregister BB interface listener.
Definition: ownership.cpp:137
fawkes::BlackBoardInterfaceListener
Definition: interface_listener.h:47
fawkes::BlackBoard
Definition: blackboard.h:50
fawkes::BlackBoardWithOwnership::list
virtual InterfaceInfoList * list(const char *type_pattern, const char *id_pattern)
Definition: ownership.cpp:103
fawkes::BlackBoardWithOwnership::open_multiple_for_reading
virtual std::list< Interface * > open_multiple_for_reading(const char *type_pattern, const char *id_pattern="*", const char *owner=NULL)
Definition: ownership.cpp:81
fawkes::BlackBoardWithOwnership::register_observer
virtual void register_observer(BlackBoardInterfaceObserver *observer)
Register BB interface observer.
Definition: ownership.cpp:145
fawkes
fawkes::BlackBoardWithOwnership::close
virtual void close(Interface *interface)
Definition: ownership.cpp:91
fawkes::BlackBoard::ListenerRegisterFlag
ListenerRegisterFlag
Flags to constrain listener registration/updates.
Definition: blackboard.h:92
fawkes::BlackBoardWithOwnership::register_listener
virtual void register_listener(BlackBoardInterfaceListener *listener, ListenerRegisterFlag flag=BBIL_FLAG_ALL)
Register BB event listener.
Definition: ownership.cpp:121
fawkes::BlackBoardWithOwnership::~BlackBoardWithOwnership
virtual ~BlackBoardWithOwnership()
Destructor.
Definition: ownership.cpp:60
fawkes::InterfaceInfoList
Definition: interface_info.h:81
fawkes::BlackBoardInterfaceObserver
Definition: interface_observer.h:42
fawkes::Interface
Definition: interface.h:78
fawkes::BlackBoardWithOwnership::is_alive
virtual bool is_alive() const
Definition: ownership.cpp:109
fawkes::BlackBoard::BBIL_FLAG_ALL
@ BBIL_FLAG_ALL
consider all events
Definition: blackboard.h:97
fawkes::BlackBoard::BlackBoard
BlackBoard(bool create_notifier=true)
Constructor.
Definition: blackboard.cpp:170
fawkes::BlackBoardWithOwnership::unregister_observer
virtual void unregister_observer(BlackBoardInterfaceObserver *observer)
Unregister BB interface observer.
Definition: ownership.cpp:153
fawkes::BlackBoardWithOwnership::update_listener
virtual void update_listener(BlackBoardInterfaceListener *listener, ListenerRegisterFlag flag=BBIL_FLAG_ALL)
Update BB event listener.
Definition: ownership.cpp:128
fawkes::BlackBoardWithOwnership::open_for_writing
virtual Interface * open_for_writing(const char *interface_type, const char *identifier, const char *owner=NULL)
Definition: ownership.cpp:73