NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
strategy-choice-manager.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2019, Regents of the University of California,
4  * Arizona Board of Regents,
5  * Colorado State University,
6  * University Pierre & Marie Curie, Sorbonne University,
7  * Washington University in St. Louis,
8  * Beijing Institute of Technology,
9  * The University of Memphis.
10  *
11  * This file is part of NFD (Named Data Networking Forwarding Daemon).
12  * See AUTHORS.md for complete list of NFD authors and contributors.
13  *
14  * NFD is free software: you can redistribute it and/or modify it under the terms
15  * of the GNU General Public License as published by the Free Software Foundation,
16  * either version 3 of the License, or (at your option) any later version.
17  *
18  * NFD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
19  * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
20  * PURPOSE. See the GNU General Public License for more details.
21  *
22  * You should have received a copy of the GNU General Public License along with
23  * NFD, e.g., in COPYING.md file. If not, see <http://www.gnu.org/licenses/>.
24  */
25 
27 
28 #include "common/logger.hpp"
30 
32 
33 namespace nfd {
34 
36 
38  Dispatcher& dispatcher,
39  CommandAuthenticator& authenticator)
40  : ManagerBase("strategy-choice", dispatcher, authenticator)
41  , m_table(strategyChoice)
42 {
43  registerCommandHandler<ndn::nfd::StrategyChoiceSetCommand>("set",
44  bind(&StrategyChoiceManager::setStrategy, this, _4, _5));
45  registerCommandHandler<ndn::nfd::StrategyChoiceUnsetCommand>("unset",
46  bind(&StrategyChoiceManager::unsetStrategy, this, _4, _5));
47 
49  bind(&StrategyChoiceManager::listChoices, this, _3));
50 }
51 
52 void
53 StrategyChoiceManager::setStrategy(ControlParameters parameters,
55 {
56  const Name& prefix = parameters.getName();
57  const Name& strategy = parameters.getStrategy();
58 
59  StrategyChoice::InsertResult res = m_table.insert(prefix, strategy);
60  if (!res) {
61  NFD_LOG_DEBUG("strategy-choice/set(" << prefix << "," << strategy << "): cannot-create " << res);
62  return done(ControlResponse(res.getStatusCode(), boost::lexical_cast<std::string>(res)));
63  }
64 
65  NFD_LOG_DEBUG("strategy-choice/set(" << prefix << "," << strategy << "): OK");
66  bool hasEntry = false;
67  Name instanceName;
68  std::tie(hasEntry, instanceName) = m_table.get(prefix);
69  BOOST_ASSERT_MSG(hasEntry, "StrategyChoice entry must exist after StrategyChoice::insert");
70  parameters.setStrategy(instanceName);
71  return done(ControlResponse(200, "OK").setBody(parameters.wireEncode()));
72 }
73 
74 void
75 StrategyChoiceManager::unsetStrategy(ControlParameters parameters,
77 {
78  const Name& prefix = parameters.getName();
79  // no need to test for ndn:/ , parameter validation takes care of that
80 
81  m_table.erase(parameters.getName());
82 
83  NFD_LOG_DEBUG("strategy-choice/unset(" << prefix << "): OK");
84  done(ControlResponse(200, "OK").setBody(parameters.wireEncode()));
85 }
86 
87 void
88 StrategyChoiceManager::listChoices(ndn::mgmt::StatusDatasetContext& context)
89 {
90  for (const auto& i : m_table) {
92  entry.setName(i.getPrefix())
93  .setStrategy(i.getStrategyInstanceName());
94  context.append(entry.wireEncode());
95  }
96  context.end();
97 }
98 
99 } // namespace nfd
ndn::nfd::StrategyChoice::setStrategy
StrategyChoice & setStrategy(const Name &strategy)
Definition: strategy-choice.cpp:115
strategy-choice-manager.hpp
ndn::mgmt::StatusDatasetContext::append
void append(const Block &block)
append a Block to the response
Definition: status-dataset-context.cpp:69
ndn::nfd::StrategyChoice::wireEncode
size_t wireEncode(EncodingImpl< TAG > &encoder) const
Definition: strategy-choice.cpp:42
nfd::strategy_choice::StrategyChoice::InsertResult
Definition: strategy-choice.hpp:72
ndn::mgmt::CommandContinuation
std::function< void(const ControlResponse &resp)> CommandContinuation
a function to be called after ControlCommandHandler completes
Definition: dispatcher.hpp:95
nfd::StrategyChoiceManager
Implements the Strategy Choice Management of NFD Management Protocol.
Definition: strategy-choice-manager.hpp:42
ndn::nfd::ControlResponse
mgmt::ControlResponse ControlResponse
Definition: control-response.hpp:30
nfd::ManagerBase::registerStatusDatasetHandler
void registerStatusDatasetHandler(const std::string &verb, const ndn::mgmt::StatusDatasetHandler &handler)
Definition: manager-base.cpp:47
ndn::nfd::StrategyChoice::setName
StrategyChoice & setName(const Name &name)
Definition: strategy-choice.cpp:107
ndn::Name
Represents an absolute name.
Definition: name.hpp:44
ns3::ndn::Name
Name
Definition: ndn-common.cpp:25
nfd
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:40
strategy-choice.hpp
ndn::mgmt::StatusDatasetContext
provides a context for generating response to a StatusDataset request
Definition: status-dataset-context.hpp:37
nfd::StrategyChoiceManager::StrategyChoiceManager
StrategyChoiceManager(strategy_choice::StrategyChoice &table, Dispatcher &dispatcher, CommandAuthenticator &authenticator)
Definition: strategy-choice-manager.cpp:37
ndn::tlv::nfd::ControlParameters
@ ControlParameters
Definition: tlv-nfd.hpp:35
ndn::nfd::ControlParameters::setStrategy
ControlParameters & setStrategy(const Name &strategy)
Definition: control-parameters.hpp:420
ndn::nfd::ControlParameters::wireEncode
size_t wireEncode(EncodingImpl< TAG > &encoder) const
Definition: control-parameters.cpp:50
nfd::strategy_choice::StrategyChoice::erase
void erase(const Name &prefix)
Make prefix to inherit strategy from its parent.
Definition: strategy-choice.cpp:141
NFD_LOG_DEBUG
#define NFD_LOG_DEBUG
Definition: logger.hpp:38
ndn::nfd::StrategyChoice
represents an item in NFD StrategyChoice dataset
Definition: strategy-choice.hpp:37
nfd::ManagerBase
A collection of common functions shared by all NFD managers, such as communicating with the dispatche...
Definition: manager-base.hpp:48
ndn::nfd::ControlParameters
represents parameters in a ControlCommand request or response
Definition: control-parameters.hpp:82
nfd::strategy_choice::StrategyChoice::InsertResult::getStatusCode
int getStatusCode() const
Get a status code for use in management command response.
Definition: strategy-choice.hpp:89
ndn::nfd::ControlParameters::getName
const Name & getName() const
Definition: control-parameters.hpp:113
ndn::mgmt::Dispatcher
represents a dispatcher on server side of NFD Management protocol
Definition: dispatcher.hpp:131
ndn::mgmt::StatusDatasetContext::end
void end()
end the response successfully after appending zero or more blocks
Definition: status-dataset-context.cpp:95
nfd::strategy_choice::StrategyChoice
Represents the Strategy Choice table.
Definition: strategy-choice.hpp:52
strategy-choice.hpp
nfd::strategy_choice::StrategyChoice::get
std::pair< bool, Name > get(const Name &prefix) const
Get strategy Name of prefix.
Definition: strategy-choice.cpp:166
nfd::CommandAuthenticator
Provides ControlCommand authorization according to NFD configuration file.
Definition: command-authenticator.hpp:46
nfd::strategy_choice::StrategyChoice::insert
InsertResult insert(const Name &prefix, const Name &strategyName)
Set strategy of prefix to be strategyName.
Definition: strategy-choice.cpp:71
NFD_LOG_INIT
#define NFD_LOG_INIT(name)
Definition: logger.hpp:31
logger.hpp
ndn::nfd::ControlParameters::getStrategy
const Name & getStrategy() const
Definition: control-parameters.hpp:413