/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef INCLUDED_MESSAGEQUEUE_HPP #define INCLUDED_MESSAGEQUEUE_HPP #include #include #include #include #include #include #include /// Thread-safe message queue (FIFO). template class MessageQueueBase { public: typedef T Payload; MessageQueueBase() { } virtual ~MessageQueueBase() { clear(); } MessageQueueBase(const MessageQueueBase&) = delete; MessageQueueBase& operator=(const MessageQueueBase&) = delete; /// Thread safe insert the message. void put(const Payload& value) { if (value.empty()) { throw std::runtime_error("Cannot queue empty item."); } std::unique_lock lock(_mutex); put_impl(value); lock.unlock(); _cv.notify_one(); } void put(const std::string& value) { put(Payload(value.data(), value.data() + value.size())); } /// Thread safe obtaining of the message. /// timeoutMs can be 0 to signify infinity. /// Returns an empty payload on timeout. Payload get(const unsigned timeoutMs = 0) { std::unique_lock lock(_mutex); if (timeoutMs > 0) { if (!_cv.wait_for(lock, std::chrono::milliseconds(timeoutMs), [this] { return wait_impl(); })) { return Payload(); } } else { _cv.wait(lock, [this] { return wait_impl(); }); } return get_impl(); } /// Get a message without waiting Payload pop() { std::unique_lock lock(_mutex); if (_queue.empty()) return Payload(); return get_impl(); } /// Anything in the queue ? bool isEmpty() { std::unique_lock lock(_mutex); return _queue.empty(); } /// Thread safe removal of all the pending messages. void clear() { std::unique_lock lock(_mutex); clear_impl(); } /// Thread safe remove_if. void remove_if(const std::function& pred) { std::unique_lock lock(_mutex); std::remove_if(_queue.begin(), _queue.end(), pred); } protected: virtual void put_impl(const Payload& value) { _queue.push_back(value); } bool wait_impl() const { return _queue.size() > 0; } virtual Payload get_impl() { Payload result = _queue.front(); _queue.erase(_queue.begin()); return result; } void clear_impl() { _queue.clear(); } /// Get the queue lock when accessing members of derived classes. std::unique_lock getLock() { return std::unique_lock(_mutex); } std::vector& getQueue() { return _queue; } private: std::vector _queue; mutable std::mutex _mutex; std::condition_variable _cv; }; typedef MessageQueueBase> MessageQueue; /// MessageQueue specialized for priority handling of tiles. class TileQueue : public MessageQueue { friend class TileQueueTests; private: class CursorPosition { public: CursorPosition() {} CursorPosition(int part, int x, int y, int width, int height) : _part(part) , _x(x) , _y(y) , _width(width) , _height(height) { } int getPart() const { return _part; } int getX() const { return _x; } int getY() const { return _y; } int getWidth() const { return _width; } int getHeight() const { return _height; } private: int _part = 0; int _x = 0; int _y = 0; int _width = 0; int _height = 0; }; public: void updateCursorPosition(int viewId, int part, int x, int y, int width, int height) { const TileQueue::CursorPosition cursorPosition = CursorPosition(part, x, y, width, height); std::unique_lock lock = getLock(); auto it = _cursorPositions.lower_bound(viewId); if (it != _cursorPositions.end() && it->first == viewId) { it->second = cursorPosition; } else { _cursorPositions.insert(it, std::make_pair(viewId, cursorPosition)); } // Move to front, so the current front view // becomes the second. const auto view = std::find(_viewOrder.begin(), _viewOrder.end(), viewId); if (view != _viewOrder.end()) { _viewOrder.erase(view); } _viewOrder.push_back(viewId); } void removeCursorPosition(int viewId) { std::unique_lock lock = getLock(); const auto view = std::find(_viewOrder.begin(), _viewOrder.end(), viewId); if (view != _viewOrder.end()) { _viewOrder.erase(view); } _cursorPositions.erase(viewId); } protected: virtual void put_impl(const Payload& value) override; virtual Payload get_impl() override; private: /// Search the queue for a duplicate tile and remove it (if present). void removeTileDuplicate(const std::string& tileMsg); /// Search the queue for a duplicate callback and remove it (if present). /// /// This removes also callbacks that are made invalid by the current /// message, like the new cursor position invalidates the old one etc. /// /// @return New message to put into the queue. If empty, use what was in callbackMsg. std::string removeCallbackDuplicate(const std::string& callbackMsg); /// De-prioritize the previews (tiles with 'id') - move them to the end of /// the queue. void deprioritizePreviews(); /// Priority of the given tile message. /// -1 means the lowest prio (the tile does not intersect any of the cursors), /// the higher the number, the bigger is priority [up to _viewOrder.size()-1]. int priority(const std::string& tileMsg); private: std::map _cursorPositions; /// Check the views in the order of how the editing (cursor movement) has /// been happening (0 == oldest, size() - 1 == newest). std::vector _viewOrder; }; #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */