producer-base.hpp

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2014-2024,  The University of Memphis
 *
 * This file is part of PSync.
 * See AUTHORS.md for complete list of PSync authors and contributors.
 *
 * PSync is free software: you can redistribute it and/or modify it under the terms
 * of the GNU Lesser General Public License as published by the Free Software Foundation,
 * either version 3 of the License, or (at your option) any later version.
 *
 * PSync is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE.  See the GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License along with
 * PSync, e.g., in COPYING.md file.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef PSYNC_PRODUCER_BASE_HPP
#define PSYNC_PRODUCER_BASE_HPP
 
#include "PSync/common.hpp"
#include "PSync/detail/access-specifiers.hpp"
#include "PSync/detail/iblt.hpp"
#include "PSync/segment-publisher.hpp"
 
#include <ndn-cxx/face.hpp>
#include <ndn-cxx/security/key-chain.hpp>
#include <ndn-cxx/util/random.hpp>
#include <ndn-cxx/util/scheduler.hpp>
 
#include <boost/bimap/bimap.hpp>
#include <boost/bimap/unordered_set_of.hpp>
 
#include <map>
 
namespace psync {
 
namespace bm = boost::bimaps;
 
class ProducerBase
{
public:
  class Error : public std::runtime_error
  {
  public:
    using std::runtime_error::runtime_error;
  };
 
PSYNC_PUBLIC_WITH_TESTS_ELSE_PROTECTED:
  ProducerBase(ndn::Face& face,
               ndn::KeyChain& keyChain,
               size_t expectedNumEntries,
               const ndn::Name& syncPrefix,
               ndn::time::milliseconds syncReplyFreshness = SYNC_REPLY_FRESHNESS,
               CompressionScheme ibltCompression = CompressionScheme::NONE,
               CompressionScheme contentCompression = CompressionScheme::NONE);
 
public:
  std::optional<uint64_t>
  getSeqNo(const ndn::Name& prefix) const
  {
    auto it = m_prefixes.find(prefix);
    if (it == m_prefixes.end()) {
      return std::nullopt;
    }
    return it->second;
  }
 
  bool
  addUserNode(const ndn::Name& prefix);
 
  void
  removeUserNode(const ndn::Name& prefix);
 
PSYNC_PUBLIC_WITH_TESTS_ELSE_PROTECTED:
  void
  updateSeqNo(const ndn::Name& prefix, uint64_t seq);
 
  bool
  isUserNode(const ndn::Name& prefix) const
  {
    return m_prefixes.find(prefix) != m_prefixes.end();
  }
 
  void
  sendApplicationNack(const ndn::Name& name);
 
  [[noreturn]] static void
  onRegisterFailed(const ndn::Name& prefix, const std::string& msg);
 
PSYNC_PUBLIC_WITH_TESTS_ELSE_PROTECTED:
  ndn::Face& m_face;
  ndn::KeyChain& m_keyChain;
  ndn::Scheduler m_scheduler;
  ndn::random::RandomNumberEngine& m_rng;
 
  detail::IBLT m_iblt;
 
  // prefix and sequence number
  std::map<ndn::Name, uint64_t> m_prefixes;
 
  using HashNameBiMap = bm::bimap<bm::unordered_set_of<uint32_t>,
                                  bm::unordered_set_of<ndn::Name, std::hash<ndn::Name>>>;
  HashNameBiMap m_biMap;
 
  SegmentPublisher m_segmentPublisher;
 
  const size_t m_expectedNumEntries;
  // Threshold is used check if the differences are greater
  // than it and whether we need to update the other side.
  const size_t m_threshold;
  const ndn::Name m_syncPrefix;
  const ndn::time::milliseconds m_syncReplyFreshness;
  const CompressionScheme m_ibltCompression;
  const CompressionScheme m_contentCompression;
  uint64_t m_numOwnElements = 0;
};
 
} // namespace psync
 
#endif // PSYNC_PRODUCER_BASE_HPP