nfd::pit::Entry Class Reference

an Interest table entry More...

#include <daemon/table/pit-entry.hpp>

Inheritance diagram for nfd::pit::Entry:

Collaboration diagram for nfd::pit::Entry:

Public Member Functions
	Entry (const Interest &interest)
bool	canMatch (const Interest &interest, size_t nEqualNameComps=0) const
void	clearInRecords ()
	delete all in-records More...
void	clearStrategyInfo ()
	clear all StrategyInfo items More...
void	deleteInRecord (const Face &face)
	delete the in-record for face if it exists More...
void	deleteOutRecord (const Face &face)
	delete the out-record for face if it exists More...
template<typename T >
size_t	eraseStrategyInfo ()
	erase a StrategyInfo item More...
InRecordCollection::iterator	getInRecord (const Face &face)
	get the in-record for face More...
const InRecordCollection &	getInRecords () const
const Interest &	getInterest () const
const Name &	getName () const
OutRecordCollection::iterator	getOutRecord (const Face &face)
	get the out-record for face More...
const OutRecordCollection &	getOutRecords () const
template<typename T >
T *	getStrategyInfo () const
	get a StrategyInfo item More...
bool	hasInRecords () const
bool	hasOutRecords () const
InRecordCollection::iterator	in_begin ()
InRecordCollection::const_iterator	in_begin () const
InRecordCollection::iterator	in_end ()
InRecordCollection::const_iterator	in_end () const
InRecordCollection::iterator	insertOrUpdateInRecord (Face &face, const Interest &interest)
	insert or update an in-record More...
OutRecordCollection::iterator	insertOrUpdateOutRecord (Face &face, const Interest &interest)
	insert or update an out-record More...
template<typename T , typename... A>
std::pair< T *, bool >	insertStrategyInfo (A &&...args)
	insert a StrategyInfo item More...
OutRecordCollection::iterator	out_begin ()
OutRecordCollection::const_iterator	out_begin () const
OutRecordCollection::iterator	out_end ()
OutRecordCollection::const_iterator	out_end () const

Public Attributes
time::milliseconds	dataFreshnessPeriod
	Data freshness period. More...
scheduler::EventId	expiryTimer
	expiry timer More...
bool	isSatisfied
	indicate if PIT entry is satisfied More...

Friends
class	name_tree::Entry

Detailed Description

an Interest table entry

An Interest table entry represents either a pending Interest or a recently satisfied Interest. Each entry contains a collection of in-records, a collection of out-records, and two timers used in forwarding pipelines. In addition, the entry, in-records, and out-records are subclasses of StrategyInfoHost, which allows forwarding strategy to store arbitrary information on them.

Definition at line 59 of file pit-entry.hpp.

Constructor & Destructor Documentation

nfd::pit::Entry::Entry ( const Interest &  interest )

explicit

Definition at line 32 of file pit-entry.cpp.

Member Function Documentation

bool nfd::pit::Entry::canMatch	(	const Interest &	interest,
		size_t	nEqualNameComps = 0
	)		const

Returns

whether interest matches this entry

Parameters

interest	the Interest
nEqualNameComps	number of initial name components guaranteed to be equal

Todo:

#3162 match Link field

Definition at line 41 of file pit-entry.cpp.

void nfd::pit::Entry::clearInRecords

(

)

delete all in-records

Definition at line 86 of file pit-entry.cpp.

void nfd::StrategyInfoHost::clearStrategyInfo ( )

inherited

clear all StrategyInfo items

Definition at line 31 of file strategy-info-host.cpp.

void nfd::pit::Entry::deleteInRecord

(

const Face &

face

)

delete the in-record for face if it exists

Definition at line 76 of file pit-entry.cpp.

void nfd::pit::Entry::deleteOutRecord

(

const Face &

face

)

delete the out-record for face if it exists

Definition at line 115 of file pit-entry.cpp.

template<typename T >

size_t nfd::StrategyInfoHost::eraseStrategyInfo ( )

inlineinherited

erase a StrategyInfo item

Template Parameters

T	type of StrategyInfo, must be a subclass of fw::StrategyInfo

Returns

number of items erased

Definition at line 82 of file strategy-info-host.hpp.

InRecordCollection::iterator nfd::pit::Entry::getInRecord

(

const Face &

face

)

get the in-record for face

Returns

an iterator to the in-record, or .in_end() if it does not exist

Definition at line 53 of file pit-entry.cpp.

const InRecordCollection& nfd::pit::Entry::getInRecords ( ) const

inline

Returns

collection of in-records

Definition at line 95 of file pit-entry.hpp.

const Interest& nfd::pit::Entry::getInterest ( ) const

inline

Returns

the representative Interest of the PIT entry

Note

Every Interest in in-records and out-records should have same Name and Selectors as the representative Interest.

Todo:

#3162 require Link field to match the representative Interest

Definition at line 71 of file pit-entry.hpp.

const Name& nfd::pit::Entry::getName ( ) const

inline

Returns

Interest Name

Definition at line 79 of file pit-entry.hpp.

OutRecordCollection::iterator nfd::pit::Entry::getOutRecord

(

const Face &

face

)

get the out-record for face

Returns

an iterator to the out-record, or .out_end() if it does not exist

Definition at line 92 of file pit-entry.cpp.

const OutRecordCollection& nfd::pit::Entry::getOutRecords ( ) const

inline

Returns

collection of in-records

Definition at line 161 of file pit-entry.hpp.

template<typename T >

T* nfd::StrategyInfoHost::getStrategyInfo ( ) const

inlineinherited

get a StrategyInfo item

Template Parameters

T	type of StrategyInfo, must be a subclass of fw::StrategyInfo

Returns

an existing StrategyInfo item of type T, or nullptr if it does not exist

Definition at line 44 of file strategy-info-host.hpp.

bool nfd::pit::Entry::hasInRecords ( ) const

inline

Return values

true	There is at least one in-record. This implies some downstream is waiting for Data or Nack.
false	There is no in-record. This implies the entry is new or has been satisfied or Nacked.

Definition at line 106 of file pit-entry.hpp.

bool nfd::pit::Entry::hasOutRecords ( ) const

inline

Return values

true	There is at least one out-record. This implies the Interest has been forwarded to some upstream, and they haven't returned Data, but may have returned Nacks.
false	There is no out-record. This implies the Interest has not been forwarded.

Definition at line 173 of file pit-entry.hpp.

InRecordCollection::iterator nfd::pit::Entry::in_begin ( )

inline

Definition at line 112 of file pit-entry.hpp.

InRecordCollection::const_iterator nfd::pit::Entry::in_begin ( ) const

inline

Definition at line 118 of file pit-entry.hpp.

InRecordCollection::iterator nfd::pit::Entry::in_end ( )

inline

Definition at line 124 of file pit-entry.hpp.

InRecordCollection::const_iterator nfd::pit::Entry::in_end ( ) const

inline

Definition at line 130 of file pit-entry.hpp.

InRecordCollection::iterator nfd::pit::Entry::insertOrUpdateInRecord	(	Face &	face,
		const Interest &	interest
	)

insert or update an in-record

Returns

an iterator to the new or updated in-record

Definition at line 60 of file pit-entry.cpp.

OutRecordCollection::iterator nfd::pit::Entry::insertOrUpdateOutRecord	(	Face &	face,
		const Interest &	interest
	)

insert or update an out-record

Returns

an iterator to the new or updated out-record

Definition at line 99 of file pit-entry.cpp.

template<typename T , typename... A>

std::pair<T*, bool> nfd::StrategyInfoHost::insertStrategyInfo ( A &&...  args )

inlineinherited

insert a StrategyInfo item

Template Parameters

T	type of StrategyInfo, must be a subclass of fw::StrategyInfo

Returns

a new or existing StrategyInfo item of type T, and true for new item, false for existing item

Definition at line 63 of file strategy-info-host.hpp.

OutRecordCollection::iterator nfd::pit::Entry::out_begin ( )

inline

Definition at line 179 of file pit-entry.hpp.

OutRecordCollection::const_iterator nfd::pit::Entry::out_begin ( ) const

inline

Definition at line 185 of file pit-entry.hpp.

OutRecordCollection::iterator nfd::pit::Entry::out_end ( )

inline

Definition at line 191 of file pit-entry.hpp.

OutRecordCollection::const_iterator nfd::pit::Entry::out_end ( ) const

inline

Definition at line 197 of file pit-entry.hpp.

Friends And Related Function Documentation

friend class name_tree::Entry

friend

Definition at line 242 of file pit-entry.hpp.

Member Data Documentation

time::milliseconds nfd::pit::Entry::dataFreshnessPeriod

Data freshness period.

Note

This field is meaningful only if isSatisfied is true

Definition at line 233 of file pit-entry.hpp.

scheduler::EventId nfd::pit::Entry::expiryTimer

expiry timer

This timer is used in forwarding pipelines to delete the entry

Definition at line 224 of file pit-entry.hpp.

bool nfd::pit::Entry::isSatisfied

indicate if PIT entry is satisfied

Definition at line 228 of file pit-entry.hpp.