manager-base.hpp
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
26 #ifndef NFD_CORE_MANAGER_BASE_HPP
27 #define NFD_CORE_MANAGER_BASE_HPP
28 
29 #include "common.hpp"
30 
31 #include <ndn-cxx/mgmt/dispatcher.hpp>
32 #include <ndn-cxx/mgmt/nfd/control-command.hpp>
33 #include <ndn-cxx/mgmt/nfd/control-response.hpp>
34 #include <ndn-cxx/mgmt/nfd/control-parameters.hpp>
35 
36 namespace nfd {
37 
38 using ndn::mgmt::Dispatcher;
39 
40 using ndn::nfd::ControlCommand;
41 using ndn::nfd::ControlResponse;
42 using ndn::nfd::ControlParameters;
43 
48 class ManagerBase : noncopyable
49 {
50 public:
51  class Error : public std::runtime_error
52  {
53  public:
54  explicit
55  Error(const std::string& what)
56  : std::runtime_error(what)
57  {
58  }
59  };
60 
61 public:
62  ManagerBase(Dispatcher& dispatcher, const std::string& module);
63 
64  virtual
65  ~ManagerBase();
66 
67  const std::string&
68  getModule() const
69  {
70  return m_module;
71  }
72 
73 PUBLIC_WITH_TESTS_ELSE_PROTECTED: // registrations to the dispatcher
74  // difference from mgmt::ControlCommand: accepts nfd::ControlParameters
75  typedef function<void(const ControlCommand& command,
76  const Name& prefix, const Interest& interest,
77  const ControlParameters& parameters,
78  const ndn::mgmt::CommandContinuation done)> ControlCommandHandler;
79 
80  template<typename Command>
81  void
82  registerCommandHandler(const std::string& verb,
83  const ControlCommandHandler& handler);
84 
85  void
86  registerStatusDatasetHandler(const std::string& verb,
87  const ndn::mgmt::StatusDatasetHandler& handler);
88 
89  ndn::mgmt::PostNotification
90  registerNotificationStream(const std::string& verb);
91 
101  void
102  extractRequester(const Interest& interest,
103  ndn::mgmt::AcceptContinuation accept);
104 
109  virtual ndn::mgmt::Authorization
110  makeAuthorization(const std::string& verb) = 0;
111 
119  static bool
120  validateParameters(const nfd::ControlCommand& command,
121  const ndn::mgmt::ControlParameters& parameters);
122 
125  static void
126  handleCommand(shared_ptr<nfd::ControlCommand> command,
127  const ControlCommandHandler& handler,
128  const Name& prefix, const Interest& interest,
129  const ndn::mgmt::ControlParameters& params,
130  ndn::mgmt::CommandContinuation done);
131 
140  PartialName
141  makeRelPrefix(const std::string& verb);
142 
143 private:
144  Dispatcher& m_dispatcher;
145  std::string m_module;
146 };
147 
148 inline PartialName
149 ManagerBase::makeRelPrefix(const std::string& verb)
150 {
151  return PartialName(m_module).append(verb);
152 }
153 
154 template<typename Command>
155 inline void
156 ManagerBase::registerCommandHandler(const std::string& verb,
157  const ControlCommandHandler& handler)
158 {
159  auto command = make_shared<Command>();
160 
161  m_dispatcher.addControlCommand<ControlParameters>(
162  makeRelPrefix(verb),
163  makeAuthorization(verb),
164  bind(&ManagerBase::validateParameters, cref(*command), _1),
165  bind(&ManagerBase::handleCommand, command, handler, _1, _2, _3, _4));
166 }
167 
168 } // namespace nfd
169 
170 #endif // NFD_CORE_MANAGER_BASE_HPP
void registerStatusDatasetHandler(const std::string &verb, const ndn::mgmt::StatusDatasetHandler &handler)
ManagerBase(Dispatcher &dispatcher, const std::string &module)
function< void(const ControlCommand &command, const Name &prefix, const Interest &interest, const ControlParameters &parameters, const ndn::mgmt::CommandContinuation done)> ControlCommandHandler
#define PUBLIC_WITH_TESTS_ELSE_PROTECTED
Definition: common.hpp:39
STL namespace.
void registerCommandHandler(const std::string &verb, const ControlCommandHandler &handler)
Error(const std::string &what)
a collection of common functions shared by all NFD managers and RIB manager, such as communicating wi...
Copyright (c) 2014-2015, Regents of the University of California, Arizona Board of Regents...
Definition: algorithm.hpp:32
const std::string & getModule() const
ndn::mgmt::PostNotification registerNotificationStream(const std::string &verb)
virtual ~ManagerBase()
void extractRequester(const Interest &interest, ndn::mgmt::AcceptContinuation accept)
extract a requester from a ControlCommand request
#define PUBLIC_WITH_TESTS_ELSE_PRIVATE
Definition: common.hpp:40