represents the Strategy Choice table More...

#include <strategy-choice.hpp>

Inheritance diagram for nfd::StrategyChoice:

Collaboration diagram for nfd::StrategyChoice:

Classes
class	const_iterator

Public Member Functions
	StrategyChoice (NameTree &nameTree, shared_ptr< fw::Strategy > defaultStrategy)

bool	hasStrategy (const Name &strategyName, bool isExact=false) const
	determines if a strategy is installed More...

bool	install (shared_ptr< fw::Strategy > strategy)
	install a strategy More...

bool	insert (const Name &prefix, const Name &strategyName)
	set strategy of prefix to be strategyName More...

void	erase (const Name &prefix)
	make prefix to inherit strategy from its parent More...

std::pair< bool, Name >	get (const Name &prefix) const
	get strategy Name of prefix More...

fw::Strategy &	findEffectiveStrategy (const Name &prefix) const
	get effective strategy for prefix More...

fw::Strategy &	findEffectiveStrategy (const pit::Entry &pitEntry) const
	get effective strategy for pitEntry More...

fw::Strategy &	findEffectiveStrategy (const measurements::Entry &measurementsEntry) const
	get effective strategy for measurementsEntry More...

size_t	size () const
	number of entries stored More...

const_iterator	begin () const

const_iterator	end () const

Detailed Description

represents the Strategy Choice table

The Strategy Choice table maintains available Strategy types, and associates Name prefixes with Strategy types.

Each strategy is identified by a strategyName. It's recommended to include a version number as the last component of strategyName.

A Name prefix is owned by a strategy if a longest prefix match on the Strategy Choice table returns that strategy.

Definition at line 45 of file strategy-choice.hpp.

Constructor & Destructor Documentation

nfd::StrategyChoice::StrategyChoice	(	NameTree &	nameTree,
		shared_ptr< fw::Strategy >	defaultStrategy
	)

Member Function Documentation

bool nfd::StrategyChoice::hasStrategy	(	const Name &	strategyName,
		bool	isExact = `false`
	)		const

determines if a strategy is installed

Parameters

isExact true to require exact match, false to permit unversioned strategyName

Returns: true if strategy is installed

Definition at line 47 of file strategy-choice.cpp.

Referenced by nfd::TablesConfigSection::ensureTablesAreConfigured(), install(), ns3::ndn::StrategyChoiceHelper::Install(), nfd::fw::installStrategies(), and nfd::StrategyChoiceManager::onStrategyChoiceRequest().

bool nfd::StrategyChoice::install ( shared_ptr< fw::Strategy > strategy )

install a strategy

Returns: true if installed; false if not installed due to duplicate strategyName

Note: shared_ptr is passed by value because StrategyChoice takes ownership of strategy

Definition at line 58 of file strategy-choice.cpp.

References hasStrategy(), ndn::Name::isPrefixOf(), NFD_LOG_ERROR, and ndn::Name::size().

Referenced by findEffectiveStrategy(), ns3::ndn::StrategyChoiceHelper::Install(), and nfd::fw::installStrategies().

bool nfd::StrategyChoice::insert	(	const Name &	prefix,
		const Name &	strategyName
	)

set strategy of prefix to be strategyName

Parameters

strategyName the strategy to be used

Returns: true on success

This method set a strategy onto a Name prefix. The strategy must have been installed. The strategyName can either be exact (contains version component), or omit the version component to pick the latest version.

Definition at line 90 of file strategy-choice.cpp.

References findEffectiveStrategy(), nfd::NameTree::lookup(), NFD_LOG_ERROR, NFD_LOG_TRACE, and nfd::fw::Strategy.

Referenced by nfd::TablesConfigSection::ensureTablesAreConfigured(), and nfd::StrategyChoiceManager::onStrategyChoiceRequest().

void nfd::StrategyChoice::erase ( const Name & prefix )

make prefix to inherit strategy from its parent

not allowed for root prefix (ndn:/)

Definition at line 125 of file strategy-choice.cpp.

References nfd::NameTree::eraseEntryIfEmpty(), findEffectiveStrategy(), nfd::NameTree::findExactMatch(), ndn::Name::getPrefix(), ndn::Name::size(), and nfd::fw::Strategy.

Referenced by nfd::StrategyChoiceManager::onStrategyChoiceRequest().

std::pair< bool, Name > nfd::StrategyChoice::get ( const Name & prefix ) const

get strategy Name of prefix