Ichthyostega
37802fd699
since, by definition, the Nexus is "the" up-link, all we need is clever overriding of the relevant handling functions, so the nexus will care for the routing, while the CoreService cares for command and presentation state handling
118 lines
3.3 KiB
C++
118 lines
3.3 KiB
C++
/*
|
|
NEXUS.hpp - UI-Bus central hub and routing table
|
|
|
|
Copyright (C) Lumiera.org
|
|
2015, Hermann Vosseler <Ichthyostega@web.de>
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation; either version 2 of
|
|
the License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
|
|
*/
|
|
|
|
|
|
/** @file nexus.hpp
|
|
** Core hub and routing table of the UI-Bus.
|
|
** Any relevant element within the Lumiera GTK UI is connected to the [UI-Bus][ui-bus.hpp]
|
|
** through some [bus terminal][bus-term.hpp]. Actually, there is one special BustTerm
|
|
** implementation, which acts as router and messaging hub.
|
|
**
|
|
** @todo initial draft and WIP-WIP-WIP as of 11/2015
|
|
**
|
|
** @see TODO_abstract-tangible-test.cpp
|
|
**
|
|
*/
|
|
|
|
|
|
#ifndef GUI_CTRL_NEXUS_H
|
|
#define GUI_CTRL_NEXUS_H
|
|
|
|
|
|
#include "lib/error.hpp"
|
|
//#include "lib/idi/entry-id.hpp"
|
|
#include "gui/ctrl/bus-term.hpp"
|
|
//#include "lib/util.hpp"
|
|
//#include "gui/model/tangible.hpp"
|
|
//#include "lib/diff/record.hpp"
|
|
#include "lib/idi/entry-id.hpp"
|
|
|
|
#include <boost/noncopyable.hpp>
|
|
//#include <string>
|
|
|
|
|
|
namespace gui {
|
|
namespace ctrl{
|
|
|
|
// using lib::HashVal;
|
|
// using util::isnil;
|
|
// using lib::idi::EntryID;
|
|
// using lib::diff::Record;
|
|
// using std::string;
|
|
|
|
|
|
/**
|
|
* Central hub of the UI-Bus.
|
|
* This special implementation of the [BusTerm] interface maintains
|
|
* a routing table and manages the connections to individual UI-Elements.
|
|
* The nexus relies on a dedicated (up)link to the [CoreService] to handle
|
|
* command invocation and presentation state. This is implemented by wiring
|
|
* the aforementioned CoreService terminal as "up-link", while actually
|
|
* defining special handling overrides for _all other kinds of messages_.
|
|
* The purpose of the Nexus is to route all these _other kinds of messages._
|
|
*
|
|
* @todo write type comment
|
|
*/
|
|
class Nexus
|
|
: public BusTerm
|
|
, boost::noncopyable
|
|
{
|
|
|
|
|
|
virtual void
|
|
note (ID subject, GenNode const& mark) override
|
|
{
|
|
UNIMPLEMENTED ("forward note messages to the presentation state manager");
|
|
}
|
|
|
|
|
|
virtual void
|
|
mark (ID subject, GenNode const& mark) override
|
|
{
|
|
UNIMPLEMENTED ("route mark messages down to the individual Tangible");
|
|
}
|
|
|
|
|
|
virtual BusTerm&
|
|
routeAdd(Tangible newNode) override
|
|
{
|
|
UNIMPLEMENTED ("add a new down-link connection to the routing table");
|
|
}
|
|
|
|
|
|
virtual void
|
|
routeDetach(ID node) noexcept override
|
|
{
|
|
UNIMPLEMENTED ("deactivate and remove a down-link route");
|
|
}
|
|
|
|
public:
|
|
explicit
|
|
Nexus (BusTerm& uplink_to_CoreService, ID identity =lib::idi::EntryID<Nexus>())
|
|
: BusTerm(identity, uplink_to_CoreService)
|
|
{ }
|
|
};
|
|
|
|
|
|
|
|
}} // namespace gui::ctrl
|
|
#endif /*GUI_CTRL_NEXUS_H*/
|