represents a dispatcher on server side of NFD Management protocol More...

#include <dispatcher.hpp>

Inheritance diagram for ndn::mgmt::Dispatcher:

Collaboration diagram for ndn::mgmt::Dispatcher:

Public Member Functions
	Dispatcher (Face &face, security::KeyChain &keyChain, const security::SigningInfo &signingInfo=security::SigningInfo())
	constructor More...

virtual	~Dispatcher ()

void	addTopPrefix (const Name &prefix, bool wantRegister=true, const security::SigningInfo &signingInfo=security::SigningInfo())
	add a top-level prefix More...

void	removeTopPrefix (const Name &prefix)
	remove a top-level prefix More...

template<typename CP >
void	addControlCommand (const PartialName &relPrefix, Authorization authorization, ValidateParameters validateParams, ControlCommandHandler handler)
	register a ControlCommand More...

void	addStatusDataset (const PartialName &relPrefix, Authorization authorization, StatusDatasetHandler handler)
	register a StatusDataset or a prefix under which StatusDatasets can be requested More...

PostNotification	addNotificationStream (const PartialName &relPrefix)
	register a NotificationStream More...

Detailed Description

represents a dispatcher on server side of NFD Management protocol

Definition at line 132 of file dispatcher.hpp.

Constructor & Destructor Documentation

ndn::mgmt::Dispatcher::Dispatcher	(	Face &	face,
		security::KeyChain &	keyChain,
		const security::SigningInfo &	signingInfo = `security::SigningInfo()`
	)

constructor

Parameters

face	the Face on which the dispatcher operates
keyChain	a KeyChain to sign Data
signingInfo	signing parameters to sign Data with `keyChain`

Definition at line 47 of file dispatcher.cpp.

ndn::mgmt::Dispatcher::~Dispatcher ( )

virtual

Definition at line 55 of file dispatcher.cpp.

References removeTopPrefix().

Member Function Documentation

void ndn::mgmt::Dispatcher::addTopPrefix	(	const Name &	prefix,
		bool	wantRegister = `true`,
		const security::SigningInfo &	signingInfo = `security::SigningInfo()`
	)

add a top-level prefix

Parameters

prefix	a top-level prefix, e.g., "/localhost/nfd"
wantRegister	whether prefix registration should be performed through the Face
signingInfo	signing parameters to sign the prefix registration command

Exceptions

std::out_of_range prefix overlaps with an existing top-level prefix

Procedure for adding a top-level prefix:

if the new top-level prefix overlaps with an existing top-level prefix (one top-level prefix is a prefix of another top-level prefix), throw std::domain_error
if wantRegister is true, invoke face.registerPrefix for the top-level prefix; the returned RegisteredPrefixId shall be recorded internally, indexed by the top-level prefix
foreach relPrefix from ControlCommands and StatusDatasets, join the top-level prefix with the relPrefix to obtain the full prefix, and invoke non-registering overload of face.setInterestFilter, with the InterestHandler set to an appropriate private method to handle incoming Interests for the ControlCommand or StatusDataset; the returned InterestFilterId shall be recorded internally, indexed by the top-level prefix

Definition at line 72 of file dispatcher.cpp.

References ndn::Name::append(), ndn::Name::isPrefixOf(), ndn::Face::registerPrefix(), and ndn::Face::setInterestFilter().

void ndn::mgmt::Dispatcher::removeTopPrefix ( const Name & prefix )

remove a top-level prefix

Parameters

prefix a top-level prefix, e.g., "/localhost/nfd"

Procedure for removing a top-level prefix:

if the top-level prefix has not been added, abort these steps
if the top-level prefix has been added with wantRegister, invoke face.unregisterPrefix with the RegisteredPrefixId
foreach InterestFilterId recorded during addTopPrefix, invoke face.unsetInterestFilter with the InterestFilterId

Definition at line 109 of file dispatcher.cpp.

References ndn::tlv::ContentType_Nack, ndn::Name::get(), ndn::Interest::getName(), ndn::Name::isPrefixOf(), ndn::Face::put(), ndn::MetaInfo::setType(), ndn::security::KeyChain::sign(), ndn::Name::size(), ndn::mgmt::STATUS403, ndn::Face::unregisterPrefix(), ndn::Face::unsetInterestFilter(), and ndn::mgmt::ControlResponse::wireEncode().

Referenced by ~Dispatcher().

template<typename CP >

void ndn::mgmt::Dispatcher::addControlCommand	(	const PartialName &	relPrefix,
		Authorization	authorization,
		ValidateParameters	validateParams,
		ControlCommandHandler	handler
	)

register a ControlCommand

Template Parameters

CP	subclass of ControlParameters used by this command

Parameters

relPrefix a prefix for this command, e.g., "faces/create"; relPrefixes in ControlCommands, StatusDatasets, NotificationStreams must be non-overlapping (no relPrefix is a prefix of another relPrefix)

Precondition: no top-level prefix has been added

Exceptions

std::out_of_range	`relPrefix` overlaps with an existing relPrefix
std::domain_error	one or more top-level prefix has been added

Procedure for processing a ControlCommand:

extract the NameComponent containing ControlParameters (the component after relPrefix), and parse ControlParameters into type CP; if parsing fails, abort these steps
perform authorization; if authorization is rejected, perform the RejectReply action, and abort these steps
validate ControlParameters; if validation fails, make ControlResponse with StatusCode 400, and go to step 5
invoke handler, wait until CommandContinuation is called
encode the ControlResponse into one Data packet
sign the Data packet
if the Data packet is too large, abort these steps and log an error
send the signed Data packet

Definition at line 420 of file dispatcher.hpp.

void ndn::mgmt::Dispatcher::addStatusDataset	(	const PartialName &	relPrefix,
		Authorization	authorization,
		StatusDatasetHandler	handler
	)

register a StatusDataset or a prefix under which StatusDatasets can be requested

Parameters

relPrefix	a prefix for this dataset, e.g., "faces/list"; relPrefixes in ControlCommands, StatusDatasets, NotificationStreams must be non-overlapping (no relPrefix is a prefix of another relPrefix)
authorization	should set identity to Name() if the dataset is public

Precondition: no top-level prefix has been added

Exceptions

std::out_of_range	`relPrefix` overlaps with an existing relPrefix
std::domain_error	one or more top-level prefix has been added

The payload of the returned status dataset data packet is at most half of the maximum data packet size.

Procedure for processing a StatusDataset request:

if the request Interest contains version or segment components, abort these steps; note: the request may contain more components after relPrefix, e.g., a query condition
perform authorization; if authorization is rejected, perform the RejectReply action, and abort these steps
invoke handler, store blocks passed to StatusDatasetAppend calls in a buffer, wait until StatusDatasetEnd is called
allocate a version
segment the buffer into one or more segments under the allocated version, such that the Data packets will not become too large after signing
set FinalBlockId on at least the last segment
sign the Data packets
send the signed Data packets

As an optimization, a Data packet may be sent as soon as enough octets have been collected through StatusDatasetAppend calls.

Definition at line 228 of file dispatcher.cpp.

References ndn::Interest::getName(), and ndn::Name::size().

PostNotification ndn::mgmt::Dispatcher::addNotificationStream ( const PartialName & relPrefix )

register a NotificationStream

Parameters

relPrefix a prefix for this notification stream, e.g., "faces/events"; relPrefixes in ControlCommands, StatusDatasets, NotificationStreams must be non-overlapping (no relPrefix is a prefix of another relPrefix)

Returns: a function into which notifications can be posted

Precondition: no top-level prefix has been added

Exceptions

std::out_of_range	`relPrefix` overlaps with an existing relPrefix
std::domain_error	one or more top-level prefix has been added

Procedure for posting a notification:

if no top-level prefix has been added, or more than one top-level prefixes have been added, abort these steps and log an error
assign the next sequence number to the notification
place the notification block into one Data packet under the sole top-level prefix
sign the Data packet
if the Data packet is too large, abort these steps and log an error
send the signed Data packet

Definition at line 279 of file dispatcher.cpp.

References ndn::Name::append(), ndn::Name::appendSequenceNumber(), and ndn::tlv::MetaInfo.

The documentation for this class was generated from the following files:

ndnSIM/ndn-cxx/src/mgmt/dispatcher.hpp
ndnSIM/ndn-cxx/src/mgmt/dispatcher.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation