// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #ifndef CORE_PAYLOAD_H_ #define CORE_PAYLOAD_H_ #include #include #include #include #include "absl/types/variant.h" #include "platform/base/byte_array.h" #include "platform/base/core_config.h" #include "platform/base/input_stream.h" #include "platform/base/payload_id.h" #include "platform/base/prng.h" #include "platform/public/file.h" #include "platform/public/logging.h" namespace location { namespace nearby { namespace connections { // Payload is default-constructible, and moveable, but not copyable container // that holds at most one instance of one of: // ByteArray, InputStream, or InputFile. class DLL_API Payload { public: using Id = PayloadId; // Order of types in variant, and values in Type enum is important. // Enum values must match respective variant types. using Content = absl::variant, InputFile>; enum class Type { kUnknown = 0, kBytes = 1, kStream = 2, kFile = 3 }; Payload(Payload&& other) noexcept; ~Payload(); Payload& operator=(Payload&& other) noexcept; // Default (invalid) payload. Payload(); // Constructors for outgoing payloads. explicit Payload(ByteArray&& bytes); explicit Payload(const ByteArray& bytes); explicit Payload(const char* parent_folder, const char* file_name, InputFile&& file); explicit Payload(std::function stream); // Constructors for incoming payloads. Payload(Id id, ByteArray&& bytes); Payload(Id id, const ByteArray& bytes); Payload(Id id, InputFile&& file); Payload(Id id, std::function stream); // Returns ByteArray payload, if it has been defined, or empty ByteArray. const ByteArray& AsBytes() const&; ByteArray&& AsBytes() &&; // Returns InputStream* payload, if it has been defined, or nullptr. InputStream* AsStream(); // Returns InputFile* payload, if it has been defined, or nullptr. const InputFile* AsFile() const; // Returns Payload unique ID. Id GetId() const; // Returns Payload type. Type GetType() const; // Sets the payload offset in bytes void SetOffset(size_t offset); size_t GetOffset(); // Generate Payload Id; to be passed to outgoing file constructor. static Id GenerateId(); const std::string GetFileName() const; const std::string GetParentFolder() const; private: Type FindType() const; Content content_; Id id_{GenerateId()}; Type type_{FindType()}; size_t offset_{0}; const char* parent_folder_; const char* file_name_; }; } // namespace connections } // namespace nearby } // namespace location #endif // CORE_PAYLOAD_H_