You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
101 lines
3.4 KiB
101 lines
3.4 KiB
/*
|
|
* 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 <memory>
|
|
#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
|