NS-3 based Named Data Networking (NDN) simulator
ndnSIM 2.5: NDN, CCN, CCNx, content centric networks
API Documentation
manager-base.cpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014-2021, 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 
26 #include "manager-base.hpp"
27 
28 namespace nfd {
29 
30 ManagerBase::ManagerBase(const std::string& module, Dispatcher& dispatcher)
31  : m_module(module)
32  , m_dispatcher(dispatcher)
33 {
34 }
35 
36 ManagerBase::ManagerBase(const std::string& module, Dispatcher& dispatcher,
37  CommandAuthenticator& authenticator)
38  : m_module(module)
39  , m_dispatcher(dispatcher)
40  , m_authenticator(&authenticator)
41 {
42 }
43 
44 ManagerBase::~ManagerBase() = default;
45 
46 void
48  const ndn::mgmt::StatusDatasetHandler& handler)
49 {
50  m_dispatcher.addStatusDataset(makeRelPrefix(verb),
52  handler);
53 }
54 
57 {
58  return m_dispatcher.addNotificationStream(makeRelPrefix(verb));
59 }
60 
61 void
62 ManagerBase::extractRequester(const Interest& interest,
64 {
65  const Name& interestName = interest.getName();
66 
67  try {
69  if (!sigInfo.hasKeyLocator() || sigInfo.getKeyLocator().getType() != tlv::Name) {
70  return accept("");
71  }
72 
73  accept(sigInfo.getKeyLocator().getName().toUri());
74  }
75  catch (const tlv::Error&) {
76  accept("");
77  }
78 }
79 
81 ManagerBase::makeAuthorization(const std::string& verb)
82 {
83  BOOST_ASSERT(m_authenticator != nullptr);
84  return m_authenticator->makeAuthorization(m_module, verb);
85 }
86 
87 bool
90 {
91  BOOST_ASSERT(dynamic_cast<const ControlParameters*>(&parameters) != nullptr);
92 
93  try {
94  command.validateRequest(static_cast<const ControlParameters&>(parameters));
95  }
96  catch (const ControlCommand::ArgumentError&) {
97  return false;
98  }
99  return true;
100 }
101 
102 void
103 ManagerBase::handleCommand(shared_ptr<ControlCommand> command,
104  const ControlCommandHandler& handler,
105  const Name& prefix, const Interest& interest,
106  const ndn::mgmt::ControlParameters& params,
108 {
109  BOOST_ASSERT(dynamic_cast<const ControlParameters*>(&params) != nullptr);
110 
111  ControlParameters parameters = static_cast<const ControlParameters&>(params);
112  command->applyDefaultsToRequest(parameters);
113  handler(*command, prefix, interest, parameters, done);
114 }
115 
116 } // namespace nfd
NFD_PUBLIC_WITH_TESTS_ELSE_PROTECTED const Name & prefix
NFD_PUBLIC_WITH_TESTS_ELSE_PROTECTED const Name const Interest & interest
Represents a SignatureInfo or InterestSignatureInfo TLV element.
NFD_PUBLIC_WITH_TESTS_ELSE_PROTECTED const Name const Interest const ControlParameters const ndn::mgmt::CommandContinuation done
represents parameters in a ControlCommand request or response
std::function< void(const Block &notification)> PostNotification
a function to post a notification
Definition: dispatcher.hpp:124
represents a dispatcher on server side of NFD Management protocol
Definition: dispatcher.hpp:130
base class of NFD ControlCommand
Represents an Interest packet.
Definition: interest.hpp:48
virtual void validateRequest(const ControlParameters &parameters) const
validate request parameters
std::function< void(const std::string &requester)> AcceptContinuation
a function to be called if authorization is successful
Definition: dispatcher.hpp:45
Authorization makeAcceptAllAuthorization()
return an Authorization that accepts all Interests, with empty string as requester ...
Definition: dispatcher.cpp:32
ManagerBase(const std::string &module, Dispatcher &dispatcher)
const Component & at(ssize_t i) const
Returns an immutable reference to the component at the specified index, with bounds checking...
Definition: name.cpp:171
static bool validateParameters(const ControlCommand &command, const ndn::mgmt::ControlParameters &parameters)
Validates the parameters for a given command.
Copyright (c) 2011-2015 Regents of the University of California.
Definition: ndn-common.hpp:39
ndn::mgmt::Authorization makeAuthorization(const std::string &module, const std::string &verb)
NFD_PUBLIC_WITH_TESTS_ELSE_PROTECTED const ndn::mgmt::AcceptContinuation & accept
virtual ~ManagerBase()
Represents an absolute name.
Definition: name.hpp:41
std::function< void(const ControlResponse &resp)> CommandContinuation
a function to be called after ControlCommandHandler completes
Definition: dispatcher.hpp:95
PartialName makeRelPrefix(const std::string &verb)
Generates the relative prefix for a handler by appending the verb name to the module name...
base class for a struct that contains ControlCommand parameters
Provides ControlCommand authorization according to NFD configuration file.
std::function< void(const Name &prefix, const Interest &interest, const ControlParameters &params, const CommandContinuation &done)> ControlCommandHandler
a function to handle an authorized ControlCommand
Definition: dispatcher.hpp:106
Block blockFromValue() const
Return a new Block constructed from the TLV-VALUE of this Block.
Definition: block.cpp:312
const ssize_t POS_SIG_INFO
const Name & getName() const noexcept
Definition: interest.hpp:172
NFD_PUBLIC_WITH_TESTS_ELSE_PROTECTED const Name const Interest const ControlParameters & parameters
void addStatusDataset(const PartialName &relPrefix, Authorization authorize, StatusDatasetHandler handle)
register a StatusDataset or a prefix under which StatusDatasets can be requested
Definition: dispatcher.cpp:223
ndn::mgmt::PostNotification registerNotificationStream(const std::string &verb)
represents an error in ControlParameters
std::function< void(const Name &prefix, const Interest &interest, const ControlParameters *params, const AcceptContinuation &accept, const RejectContinuation &reject)> Authorization
a function that performs authorization
Definition: dispatcher.hpp:77
void registerStatusDatasetHandler(const std::string &verb, const ndn::mgmt::StatusDatasetHandler &handler)
static void handleCommand(shared_ptr< ControlCommand > command, const ControlCommandHandler &handler, const Name &prefix, const Interest &interest, const ndn::mgmt::ControlParameters &params, const ndn::mgmt::CommandContinuation &done)
Handles a control command.
represents an error in TLV encoding or decoding
Definition: tlv.hpp:52
PostNotification addNotificationStream(const PartialName &relPrefix)
register a NotificationStream
Definition: dispatcher.cpp:303
std::function< void(const Name &prefix, const Interest &interest, StatusDatasetContext &context)> StatusDatasetHandler
a function to handle a StatusDataset request
Definition: dispatcher.hpp:118