/* * Copyright 2018 The Android Open Source Project * * 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 * * http://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. */ #pragma once #include <cstdint> #include <type_traits> #include <utility> #include <vector> namespace bluetooth { // Abstract base class that is subclassed to provide type-specifc accessors on // data. Manages said data's memory and guarantees the data's persistence. Once // created the underlying data is immutable. class Packet : public std::enable_shared_from_this<Packet> { friend class Iterator; friend class PacketBuilder; public: virtual ~Packet() = default; protected: Packet() : packet_start_index_(0), packet_end_index_(0), data_(std::make_shared<std::vector<uint8_t>>(0)){}; Packet(std::shared_ptr<const Packet> pkt, size_t start, size_t end) : packet_start_index_(start), packet_end_index_(end), data_(pkt->data_){}; Packet(std::shared_ptr<const Packet> pkt) : data_(pkt->data_) { auto indices = pkt->GetPayloadIndecies(); packet_start_index_ = indices.first; packet_end_index_ = indices.second; }; public: size_t size() const; class Iterator begin() const; class Iterator end() const; uint8_t operator[](size_t i); // Check to see if the packet is structured correctly and have the correct // lengths. Data access on an invalid packet may cause a crash. virtual bool IsValid() const = 0; // Debug string representation of the packet virtual std::string ToString() const = 0; // Convert a packet horizontally in a layer, you may only specialize // into a more specific type and doing otherwise will cause a compiler error // // Example: // std::shared_ptr<AvrcpPacket> base; // std::shared_ptr<AvrcpVendorPacket> p = // Packet::Specialize<AvrcpVendorPacket>(base); template <class T, class U> static std::shared_ptr<T> Specialize(const std::shared_ptr<U>& pkt) { static_assert(std::is_convertible<U*, Packet*>::value, "Unable to specialize a non-packet object."); static_assert(std::is_convertible<T*, Packet*>::value, "Unable to specialize to something that isn't a packet"); static_assert(std::is_convertible<T*, U*>::value, "Can not convert between the two packet types."); return std::shared_ptr<T>( new T(pkt, pkt->packet_start_index_, pkt->packet_end_index_)); }; protected: // Packet should be immutable other than when building size_t packet_start_index_; size_t packet_end_index_; std::shared_ptr<std::vector<uint8_t>> data_; private: // Only Available to the iterators virtual size_t get_length() const; virtual uint8_t get_at_index(size_t index) const; // Returns the begining and end indicies of the payload of the packet. // Used when constructing a packet from another packet when moving // between layers. virtual std::pair<size_t, size_t> GetPayloadIndecies() const = 0; }; } // namespace bluetooth