// // OctreeEditPacketSender.h // libraries/octree/src // // Created by Brad Hefta-Gaub on 8/12/13. // Copyright 2013 High Fidelity, Inc. // // Distributed under the Apache License, Version 2.0. // See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html // #ifndef hifi_OctreeEditPacketSender_h #define hifi_OctreeEditPacketSender_h #include #include #include #include "SentPacketHistory.h" /// Utility for processing, packing, queueing and sending of outbound edit messages. class OctreeEditPacketSender : public PacketSender { Q_OBJECT public: OctreeEditPacketSender(); ~OctreeEditPacketSender(); /// Queues a single edit message. Will potentially send a pending multi-command packet. Determines which server /// node or nodes the packet should be sent to. Can be called even before servers are known, in which case up to /// MaxPendingMessages will be buffered and processed when servers are known. void queueOctreeEditMessage(PacketType type, QByteArray& editMessage); /// Releases all queued messages even if those messages haven't filled an MTU packet. This will move the packed message /// packets onto the send queue. If running in threaded mode, the caller does not need to do any further processing to /// have these packets get sent. If running in non-threaded mode, the caller must still call process() on a regular /// interval to ensure that the packets are actually sent. Can be called even before servers are known, in /// which case up to MaxPendingMessages of the released messages will be buffered and actually released when /// servers are known. void releaseQueuedMessages(); /// are we in sending mode. If we're not in sending mode then all packets and messages will be ignored and /// not queued and not sent /// set sending mode. By default we are set to shouldSend=TRUE and packets will be sent. If shouldSend=FALSE, then we'll /// switch to not sending mode, and all packets and messages will be ignored, not queued, and not sent. This might be used /// in an application like interface when all octree features are disabled. /// if you're running in non-threaded mode, you must call this method regularly virtual bool process() override; /// Set the desired number of pending messages that the OctreeEditPacketSender should attempt to queue even if /// servers are not present. This only applies to how the OctreeEditPacketSender will manage messages when no /// servers are present. By default, this value is the same as the default packets that will be sent in one second. /// Which means the OctreeEditPacketSender will not buffer all messages given to it if no servers are present. /// This is the maximum number of queued messages and single messages. void setMaxPendingMessages(int maxPendingMessages) { _maxPendingMessages = maxPendingMessages; } // the default number of pending messages we will store if no servers are available static const int DEFAULT_MAX_PENDING_MESSAGES; // is there an octree server available to send packets to bool serversExist() const; // you must override these... virtual char getMyNodeType() const = 0; virtual void adjustEditPacketForClockSkew(PacketType type, QByteArray& buffer, qint64 clockSkew) { } void processNackPacket(ReceivedMessage& message, SharedNodePointer sendingNode); public slots: void nodeKilled(SharedNodePointer node); protected: using EditMessagePair = std::pair; void queuePacketToNode(const QUuid& nodeID, std::unique_ptr packet); void queuePacketListToNode(const QUuid& nodeUUID, std::unique_ptr packetList); void queuePendingPacketToNodes(std::unique_ptr packet); void queuePacketToNodes(std::unique_ptr packet); std::unique_ptr initializePacket(PacketType type, qint64 nodeClockSkew); void releaseQueuedPacket(const QUuid& nodeUUID, std::unique_ptr packetBuffer); // releases specific queued packet void releaseQueuedPacketList(const QUuid& nodeID, std::unique_ptr packetList); void processPreServerExistsPackets(); // These are packets which are destined from know servers but haven't been released because they're still too small std::unordered_map _pendingEditPackets; // These are packets that are waiting to be processed because we don't yet know if there are servers int _maxPendingMessages; bool _releaseQueuedMessagesPending; QMutex _pendingPacketsLock; QMutex _packetsQueueLock; // don't let different threads release the queue while another thread is writing to it std::list _preServerEdits; // these will get packed into other larger packets std::list> _preServerSingleMessagePackets; // these will go out as is QMutex _releaseQueuedPacketMutex; // TODO: add locks for this and _pendingEditPackets std::unordered_map _sentPacketHistories; std::unordered_map _outgoingSequenceNumbers; }; #endif // hifi_OctreeEditPacketSender_h