NotificationManager.h

Go to the documentation of this file.

/*
 *   ORXONOX - the hottest 3D action shooter ever to exist
 *                    > www.orxonox.net <
 *
 *
 *   License notice:
 *
 *   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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 *   Author:
 *      Damian 'Mozork' Frick
 *   Co-authors:
 *      ...
 *
 */

#ifndef _NotificationManager_H__
#define _NotificationManager_H__

#include "notifications/NotificationsPrereqs.h"

#include <ctime>
#include <map>
#include <string>

#include "util/Singleton.h"
#include "interfaces/NotificationListener.h"

namespace orxonox // tolua_export
{ // tolua_export

    class _NotificationsExport Notification
    {
        public:
            Notification(const std::string& message, const std::string& sender, NotificationMessageType type);
            virtual ~Notification();

            void destroy(void)
                { delete this; }

            inline const std::string & getMessage(void) const
                { return this->message_; }

            inline const std::string & getSender(void) const
                { return this->sender_; }

            inline NotificationMessageType getType(void) const
                { return this->type_; }

        private:
            std::string message_; 
            std::string sender_; 
            NotificationMessageType type_; 

            void initialize(void); 

    };

    class _NotificationsExport NotificationManager // tolua_export
        : public Singleton<NotificationManager>, public NotificationListener
    { // tolua_export
            friend class Singleton<NotificationManager>;
        public:
            NotificationManager();
            virtual ~NotificationManager();

            virtual void preDestroy(void) override; // Is called before the object is destroyed.

            static NotificationManager& getInstance() { return Singleton<NotificationManager>::getInstance(); } // tolua_export

            virtual bool registerNotification(const std::string& message, const std::string& sender, NotificationMessageType type) override;
            virtual bool executeCommand(NotificationCommand command, const std::string& sender) override;

            bool registerNotification(Notification* notification); // Registers a Notification within the NotificationManager.
            void unregisterNotification(Notification* notification, NotificationQueue* queue); // Unregisters a Notification within the NotificationManager for a given NotificationQueue.

            void getNotifications(NotificationQueue* queue, std::multimap<std::time_t, Notification*>* map, const std::time_t & timeFrameStart, const std::time_t & timeFrameEnd); // Fetches the Notifications for a specific NotificationQueue in a specified timeframe and stores them in the input map.

            void getNotifications(NotificationQueue* queue, std::multimap<std::time_t, Notification*>* map, int timeDelay)
                { this->getNotifications(queue, map, std::time(0)-timeDelay, std::time(0)); }

            void getNewestNotifications(NotificationQueue* queue, std::multimap<std::time_t, Notification*>* map, int numberOfNotifications); // Fetches the newest Notifications for a specific NotificationQueue and stores them in the input map.

            bool registerQueue(NotificationQueue* queue); // Registers a NotificationQueue.
            void unregisterQueue(NotificationQueue* queue); // Unregisters a NotificationQueue.

            void loadQueues(void); // tolua_export // Loads all the NotificationQueues that should exist.

            NotificationQueue* getQueue(const std::string & name); // Get the NotificationQueue with the input name.

        private:
            static NotificationManager* singletonPtr_s;

            std::multimap<std::time_t, Notification*> allNotificationsList_; 
            std::map<const std::string, std::multimap<std::time_t, Notification*>*> notificationLists_; 

            std::map<const std::string, NotificationQueue*> queues_; 

            bool removeNotification(Notification* notification, std::multimap<std::time_t, Notification*>& map); // Helper method that removes an input Notification form an input map.
            
            // Commands
            bool commandClear(const std::string& sender); // The clear command. Clears all NotificationQueues that have its sender as a target.

    }; // tolua_export

} // tolua_export

#endif /* _NotificationManager_H__ */