rdr.hpp

Go to the documentation of this file.

#ifndef NDNPH_APP_RDR_HPP
#define NDNPH_APP_RDR_HPP
 
#include "../face/packet-handler.hpp"
#include "../keychain/digest.hpp"
#include "../keychain/null.hpp"
 
namespace ndnph {
namespace rdr {
 
inline Component
getMetadataComponent() {
  static const uint8_t tlv[]{0x20, 0x08, 'm', 'e', 't', 'a', 'd', 'a', 't', 'a'};
  static Component comp = Component::constant(tlv, sizeof(tlv));
  return comp;
}
getMetadataComponent() {…}
 
inline Name
parseMetadata(Data data) {
  if (!data) {
    return Name();
  }
 
  Name datasetPrefix;
  bool ok = data.getContent().makeDecoder().decode(datasetPrefix);
  if (!ok) {
    return Name();
  }
  return datasetPrefix;
}
parseMetadata(Data data) {…}
 
namespace detail {
 
inline Name
stripMetadataComponent(Name rdrPrefix) {
  return rdrPrefix[-1] == getMetadataComponent() ? rdrPrefix.getPrefix(-1) : rdrPrefix;
}
stripMetadataComponent(Name rdrPrefix) {…}
 
} // namespace detail
namespace detail {…}
 
class RdrMetadataProducer : public PacketHandler {
public:
  struct Options {
    uint64_t initialVersion;
 
    uint32_t freshnessPeriod;
 
    const PrivateKey& signer;
  };
  struct Options {…};
 
  explicit RdrMetadataProducer(const Name& rdrPrefix, Face& face, const Options& opts)
    : PacketHandler(face)
    , m_rdrPrefix(detail::stripMetadataComponent(rdrPrefix))
    , m_signer(opts.signer)
    , m_version(opts.initialVersion)
    , m_freshness(std::max<uint32_t>(opts.freshnessPeriod, 1)) {
    if (m_version + 1 == 0) {
      port::RandomSource::generate(reinterpret_cast<uint8_t*>(&m_version), sizeof(m_version));
      m_version = m_version & ~0xFFFFFFFF;
    }
  }
  explicit RdrMetadataProducer(const Name& rdrPrefix, Face& face, const Options& opts) {…}
 
  explicit RdrMetadataProducer(const Name& rdrPrefix, Face& face)
    : RdrMetadataProducer(rdrPrefix, face,
                          Options{
                            .initialVersion = std::numeric_limits<uint64_t>::max(),
                            .freshnessPeriod = 1,
                            .signer = DigestKey::get(),
                          }) {}
  explicit RdrMetadataProducer(const Name& rdrPrefix, Face& face) {…}
 
  void setDatasetPrefix(Name datasetPrefix) {
    m_datasetPrefix = datasetPrefix;
    ++m_version;
  }
  void setDatasetPrefix(Name datasetPrefix) {…}
 
private:
  bool processInterest(Interest interest) final {
    const Name& interestName = interest.getName();
    if (!m_datasetPrefix || interestName.getPrefix(-1) != m_rdrPrefix ||
        interestName[-1] != getMetadataComponent() || !interest.getCanBePrefix() ||
        !interest.getMustBeFresh()) {
      return false;
    }
 
    StaticRegion<1024> region;
    Data data = region.create<Data>();
    NDNPH_ASSERT(!!data);
    data.setName(m_rdrPrefix.append(region, getMetadataComponent(), convention::Version(),
                                    m_version, convention::Segment(), 0));
    data.setFreshnessPeriod(m_freshness);
    data.setIsFinalBlock(true);
 
    Encoder contentEncoder(region);
    prepareRdrContent(contentEncoder, m_datasetPrefix);
    contentEncoder.trim();
    data.setContent(tlv::Value(contentEncoder));
 
    reply(data.sign(m_signer));
    return true;
  }
  bool processInterest(Interest interest) final {…}
 
  virtual void prepareRdrContent(Encoder& encoder, const Name& datasetPrefix) {
    encoder.prepend(datasetPrefix);
  }
  virtual void prepareRdrContent(Encoder& encoder, const Name& datasetPrefix) {…}
 
private:
  Name m_rdrPrefix;
  const PrivateKey& m_signer;
  uint64_t m_version = 0;
  uint32_t m_freshness = 1;
  Name m_datasetPrefix;
};
class RdrMetadataProducer : public PacketHandler {…};
 
class RdrMetadataConsumer : public PacketHandler {
public:
  using Callback = void (*)(void* ctx, Data data);
 
  struct Options {
    const PublicKey& verifier;
    uint16_t interestLifetime;
  };
  struct Options {…};
 
  explicit RdrMetadataConsumer(Face& face, const Options& opts)
    : PacketHandler(face, 0x60)
    , m_pending(this)
    , m_verifier(opts.verifier)
    , m_interestLifetime(opts.interestLifetime) {}
  explicit RdrMetadataConsumer(Face& face, const Options& opts) {…}
 
  explicit RdrMetadataConsumer(Face& face)
    : RdrMetadataConsumer(face, Options{
                                  .verifier = NullKey::get(),
                                  .interestLifetime = 1000,
                                }) {}
  explicit RdrMetadataConsumer(Face& face) {…}
 
  void start(Name rdrPrefix, Callback cb, void* ctx = nullptr) {
    invokeCallback(Data());
 
    m_rdrPrefix = detail::stripMetadataComponent(rdrPrefix);
    m_cb = cb;
    m_ctx = ctx;
 
    StaticRegion<1024> region;
    auto interest = region.create<Interest>();
    NDNPH_ASSERT(!!interest);
    interest.setName(m_rdrPrefix.append(region, getMetadataComponent()));
    interest.setCanBePrefix(true);
    interest.setMustBeFresh(true);
    interest.setLifetime(m_interestLifetime);
    bool ok = m_pending.send(interest);
    if (!ok) {
      invokeCallback(Data());
    }
  }
  void start(Name rdrPrefix, Callback cb, void* ctx = nullptr) {…}
 
private:
  void invokeCallback(Data data) {
    if (m_cb != nullptr) {
      m_cb(m_ctx, std::move(data));
      m_cb = nullptr;
    }
  }
 
  void loop() final {
    if (m_pending.expired()) {
      invokeCallback(Data());
    }
  }
  void loop() final {…}
 
  bool processData(Data data) final {
    if (!m_pending.match(data, m_rdrPrefix) || data.getName().size() != m_rdrPrefix.size() + 3 ||
        data.getName()[m_rdrPrefix.size()] != getMetadataComponent()) {
      return false;
    }
 
    if (!data.verify(m_verifier)) {
      invokeCallback(Data());
    } else {
      invokeCallback(data);
    }
    return true;
  }
  bool processData(Data data) final {…}
 
private:
  OutgoingPendingInterest m_pending;
  const PublicKey& m_verifier;
  uint16_t m_interestLifetime = 0;
  Name m_rdrPrefix;
  Callback m_cb = nullptr;
  void* m_ctx = nullptr;
};
class RdrMetadataConsumer : public PacketHandler {…};
 
} // namespace rdr
namespace rdr {…}
 
using rdr::RdrMetadataConsumer;
using rdr::RdrMetadataProducer;
 
} // namespace ndnph
 
#endif // NDNPH_APP_RDR_HPP