Ichthyostega
aec700f1b1
TODO - is this actually a sensible idea, from a design viewpoint? - in which way to bind GuiNotification for receiving diff messages? - Problem with disconnnecting from Nexus on shutdown
99 lines
3.4 KiB
C++
99 lines
3.4 KiB
C++
/*
|
|
NOTIFICATION-SERVICE.hpp - public service allowing to push information into the GUI
|
|
|
|
Copyright (C) Lumiera.org
|
|
2008, 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 notification-service.hpp
|
|
** A public service provided by the GUI, implementing the gui::GuiNotification facade interface.
|
|
** The purpose of this service is to push state update and notification of events from the lower
|
|
** layers into the Lumiera GUI. Typically, this happens asynchronously and triggered either by
|
|
** events within the lower layers, or as result of invoking commands on the session.
|
|
**
|
|
** This service is the implementation of a layer separation facade interface. Clients should use
|
|
** gui::GuiNotification#facade to access this service. This header defines the interface used
|
|
** to \em provide this service, not to access it.
|
|
**
|
|
** @see gui::GuiFacade
|
|
** @see core-sevice.hpp starting this service
|
|
*/
|
|
|
|
|
|
#ifndef GUI_NOTIFICATION_SERVICE_H
|
|
#define GUI_NOTIFICATION_SERVICE_H
|
|
|
|
|
|
#include "include/gui-notification-facade.h"
|
|
#include "common/instancehandle.hpp"
|
|
#include "gui/model/controller.hpp"
|
|
#include "lib/singleton-ref.hpp"
|
|
|
|
|
|
|
|
namespace gui {
|
|
|
|
|
|
|
|
/**************************************************//**
|
|
* Actual implementation of the GuiNotification service
|
|
* within the Lumiera GTK GUI. Creating an instance of
|
|
* this class automatically registers the interface
|
|
* with the Lumiera Interface/Plugin system and creates
|
|
* a forwarding proxy within the application core to
|
|
* route calls through this interface.
|
|
*
|
|
* @todo the ctor of this class should take references
|
|
* to any internal service providers within the
|
|
* GUI which are needed to implement the service.
|
|
*/
|
|
class NotificationService
|
|
: public GuiNotification
|
|
, public model::Controller
|
|
{
|
|
|
|
/* === Implementation of the Facade Interface === */
|
|
|
|
void displayInfo (string const& text) override;
|
|
void triggerGuiShutdown (string const& cause) override;
|
|
|
|
|
|
/* === Interface Lifecycle === */
|
|
|
|
using ServiceInstanceHandle = lumiera::InstanceHandle< LUMIERA_INTERFACE_INAME(lumieraorg_GuiNotification, 0)
|
|
, GuiNotification
|
|
> ;
|
|
|
|
lib::SingletonRef<GuiNotification> implInstance_;
|
|
ServiceInstanceHandle serviceInstance_;
|
|
|
|
|
|
/* === Control Interface === */
|
|
|
|
/** set up a binding to respond to mutation messages via UiBus */
|
|
virtual void buildMutator (lib::diff::TreeMutator::Handle) override;
|
|
|
|
public:
|
|
NotificationService(ctrl::BusTerm& nexus);
|
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace gui
|
|
#endif
|