webrtc/net/dcsctp/packet/parameter/parameter.h
Victor Boivie b87746b155 dcsctp: Add parameters, error causes and chunks
Quite a large commit, but mostly trivial. It adds all the (in dcSCTP)
supported parameters, error causes and chunks as an object model, with
serializers and deserializers. They are verified with packet captures
where available, that have been captured with Wireshark against a
reference implementation.

This _could_ be split in parameter/ as one commit, error_cause/ in the
following, and chunk/ as the third, but as each chunk/parameter is
completely isolated from the other, reviewing it should be linear with
the number of chunks/parameters and having them in more commits wouldn't
change that, taken all those three commits into account.

Bug: webrtc:12614
Change-Id: Ie83c9a22cae6e3a39e35ef26fd532837a6387a08
Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/213347
Commit-Queue: Victor Boivie <boivie@webrtc.org>
Reviewed-by: Tommi <tommi@webrtc.org>
Cr-Commit-Position: refs/heads/master@{#33625}
2021-04-06 10:28:18 +00:00

96 lines
2.5 KiB
C++

/*
* Copyright (c) 2021 The WebRTC project authors. All Rights Reserved.
*
* Use of this source code is governed by a BSD-style license
* that can be found in the LICENSE file in the root of the source
* tree. An additional intellectual property rights grant can be found
* in the file PATENTS. All contributing project authors may
* be found in the AUTHORS file in the root of the source tree.
*/
#ifndef NET_DCSCTP_PACKET_PARAMETER_PARAMETER_H_
#define NET_DCSCTP_PACKET_PARAMETER_PARAMETER_H_
#include <stddef.h>
#include <algorithm>
#include <cstdint>
#include <iterator>
#include <memory>
#include <string>
#include <type_traits>
#include <utility>
#include <vector>
#include "absl/algorithm/container.h"
#include "absl/strings/string_view.h"
#include "absl/types/optional.h"
#include "api/array_view.h"
#include "net/dcsctp/packet/tlv_trait.h"
#include "rtc_base/strings/string_builder.h"
namespace dcsctp {
class Parameter {
public:
Parameter() {}
virtual ~Parameter() = default;
Parameter(const Parameter& other) = default;
Parameter& operator=(const Parameter& other) = default;
virtual void SerializeTo(std::vector<uint8_t>& out) const = 0;
virtual std::string ToString() const = 0;
};
struct ParameterDescriptor {
ParameterDescriptor(uint16_t type, rtc::ArrayView<const uint8_t> data)
: type(type), data(data) {}
uint16_t type;
rtc::ArrayView<const uint8_t> data;
};
class Parameters {
public:
class Builder {
public:
Builder() {}
Builder& Add(const Parameter& p);
Parameters Build() { return Parameters(std::move(data_)); }
private:
std::vector<uint8_t> data_;
};
static absl::optional<Parameters> Parse(rtc::ArrayView<const uint8_t> data);
Parameters() {}
Parameters(Parameters&& other) = default;
Parameters& operator=(Parameters&& other) = default;
rtc::ArrayView<const uint8_t> data() const { return data_; }
std::vector<ParameterDescriptor> descriptors() const;
template <typename P>
absl::optional<P> get() const {
static_assert(std::is_base_of<Parameter, P>::value,
"Template parameter not derived from Parameter");
for (const auto& p : descriptors()) {
if (p.type == P::kType) {
return P::Parse(p.data);
}
}
return absl::nullopt;
}
private:
explicit Parameters(std::vector<uint8_t> data) : data_(std::move(data)) {}
std::vector<uint8_t> data_;
};
struct ParameterConfig {
static constexpr int kTypeSizeInBytes = 2;
};
} // namespace dcsctp
#endif // NET_DCSCTP_PACKET_PARAMETER_PARAMETER_H_