/* This file is part of FlashMQ (https://www.flashmq.org) Copyright (C) 2021 Wiebe Cazemier FlashMQ is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3. FlashMQ 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 Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with FlashMQ. If not, see . */ #ifndef MQTTPACKET_H #define MQTTPACKET_H #include "unistd.h" #include #include #include #include "forward_declarations.h" #include "client.h" #include "exceptions.h" #include "types.h" #include "subscriptionstore.h" #include "cirbuf.h" #include "logger.h" #include "mainapp.h" #include "variablebyteint.h" #include "mqtt5properties.h" #include "packetdatatypes.h" /** * @brief The MqttPacket class represents incoming and outgonig packets. * * Be sure to understand the 'externallyReceived' member. See in-code documentation. * * TODO: I could perhaps make a subclass for the externally received one. */ class MqttPacket { #ifdef TESTING friend class MainTests; #endif std::vector bites; Publish publishData; size_t fixed_header_length = 0; // if 0, this packet does not contain the bytes of the fixed header. VariableByteInt remainingLength; std::shared_ptr sender; char first_byte = 0; size_t pos = 0; size_t packet_id_pos = 0; uint16_t packet_id = 0; ProtocolVersion protocolVersion = ProtocolVersion::None; size_t payloadStart = 0; size_t payloadLen = 0; bool hasTopicAlias = false; // It's important to understand that this class is used for incoming packets as well as new outgoing packets. When we create // new outgoing packets, we generally know exactly who it's for and the information is only stored in this->bites. So, the // publishData and fields like hasTopicAlias are invalid in those cases. bool externallyReceived = false; Logger *logger = Logger::getInstance(); char *readBytes(size_t length); char readByte(); void writeByte(char b); void writeUint16(uint16_t x); void writeBytes(const char *b, size_t len); void writeProperties(const std::shared_ptr &properties); void writeVariableByteInt(const VariableByteInt &v); void writeString(const std::string &s); uint16_t readTwoBytesToUInt16(); uint32_t readFourBytesToUint32(); size_t remainingAfterPos(); size_t decodeVariableByteIntAtPos(); void readUserProperty(); std::string readBytesToString(bool validateUtf8 = true, bool alsoCheckInvalidPublishChars = false); void calculateRemainingLength(); void setPosToDataStart(); bool atEnd() const; #ifndef TESTING // In production, I want to be sure I don't accidentally copy packets, because it's slow. MqttPacket(const MqttPacket &other) = delete; #endif public: #ifdef TESTING // In testing I need to copy packets for administrative purposes. MqttPacket(const MqttPacket &other) = default; #endif PacketType packetType = PacketType::Reserved; MqttPacket(CirBuf &buf, size_t packet_len, size_t fixed_header_length, std::shared_ptr &sender); // Constructor for parsing incoming packets. MqttPacket(MqttPacket &&other) = default; size_t setClientSpecificPropertiesAndGetRequiredSizeForPublish(const ProtocolVersion protocolVersion, Publish &publishData) const; // Constructor for outgoing packets. These may not allocate room for the fixed header, because we don't (always) know the length in advance. MqttPacket(const ConnAck &connAck); MqttPacket(const SubAck &subAck); MqttPacket(const UnsubAck &unsubAck); MqttPacket(const ProtocolVersion protocolVersion, Publish &_publish); MqttPacket(const PubResponse &pubAck); MqttPacket(const Disconnect &disconnect); MqttPacket(const Auth &auth); MqttPacket(const Connect &connect); MqttPacket(const Subscribe &subscribe); static void bufferToMqttPackets(CirBuf &buf, std::vector &packetQueueIn, std::shared_ptr &sender); void handle(); ConnectData parseConnectData(); void handleConnect(); void handleExtendedAuth(); DisconnectData parseDisconnectData(); void handleDisconnect(); void handleSubscribe(); void handleUnsubscribe(); void handlePing(); void parsePublishData(); void handlePublish(); void parsePubAckData(); void handlePubAck(); PubRecData parsePubRecData(); void handlePubRec(); void parsePubRelData(); void handlePubRel(); void parsePubComp(); void handlePubComp(); SubAckData parseSubAckData(); uint8_t getFixedHeaderLength() const; size_t getSizeIncludingNonPresentHeader() const; const std::vector &getBites() const { return bites; } char getQos() const { return publishData.qos; } void setQos(const char new_qos); ProtocolVersion getProtocolVersion() const { return protocolVersion;} const std::string &getTopic() const; const std::vector &getSubtopics(); std::shared_ptr getSender() const; void setSender(const std::shared_ptr &value); bool containsFixedHeader() const; void setPacketId(uint16_t packet_id); uint16_t getPacketId() const; void setDuplicate(); void readIntoBuf(CirBuf &buf) const; std::string getPayloadCopy() const; bool getRetain() const; void setRetain(); const Publish &getPublishData(); bool containsClientSpecificProperties() const; const std::vector> *getUserProperties() const; }; struct SubscriptionTuple { const std::string topic; const std::vector subtopics; const char qos; SubscriptionTuple(const std::string &topic, const std::vector &subtopics, char qos); }; #endif // MQTTPACKET_H