ndn::PrefixAnnouncement Class Reference

A prefix announcement object that represents an application's intent of registering a prefix toward itself. More...

#include <prefix-announcement.hpp>

Classes
class	Error

Public Member Functions
	PrefixAnnouncement ()
	Construct an empty prefix announcement. More...
	PrefixAnnouncement (Data data)
	Decode a prefix announcement from Data. More...
const optional< Data > &	getData () const
	Get the Data representing the prefix announcement, if available. More...
const Data &	toData (KeyChain &keyChain, const ndn::security::SigningInfo &si=KeyChain::getDefaultSigningInfo(), optional< uint64_t > version=nullopt) const
	Create a Data packet representing the prefix announcement, if it does not exist. More...
const Name &	getAnnouncedName () const
	Return announced name. More...
PrefixAnnouncement &	setAnnouncedName (Name name)
	Set announced name. More...
time::milliseconds	getExpiration () const
	Return relative expiration period. More...
PrefixAnnouncement &	setExpiration (time::milliseconds expiration)
	Set relative expiration period. More...
optional< security::ValidityPeriod >	getValidityPeriod () const
	Return absolute validity period. More...
PrefixAnnouncement &	setValidityPeriod (optional< security::ValidityPeriod > validity)
	Set absolute validity period. More...

Detailed Description

A prefix announcement object that represents an application's intent of registering a prefix toward itself.

See also

https://redmine.named-data.net/projects/nfd/wiki/PrefixAnnouncement

Definition at line 33 of file prefix-announcement.hpp.

Constructor & Destructor Documentation

PrefixAnnouncement() [1/2]

ndn::PrefixAnnouncement::PrefixAnnouncement ( )

default

Construct an empty prefix announcement.

Postcondition

getData() == nullopt

getAnnouncedName() == "/"

getExpiration() == 0_ms

PrefixAnnouncement() [2/2]

ndn::PrefixAnnouncement::PrefixAnnouncement ( Data  data )

explicit

Decode a prefix announcement from Data.

Exceptions

tlv::Error

the Data is not a prefix announcement.

Postcondition

getData() == data

Definition at line 31 of file prefix-announcement.cpp.

References ndn::tlv::ContentType_PrefixAnn, ndn::Block::elements(), ndn::Block::elements_end(), ndn::tlv::nfd::ExpirationPeriod, ndn::Block::find(), ndn::Block::get(), ndn::Name::getPrefix(), ndn::tlv::isCriticalType(), ndn::KEYWORD_PA_COMP, NDN_THROW, ndn::Block::parse(), ndn::encoding::readNonNegativeInteger(), ndn::Name::size(), ndn::to_string(), and ndn::tlv::ValidityPeriod.

Member Function Documentation

getData()

const optional<Data>& ndn::PrefixAnnouncement::getData ( ) const

inline

Get the Data representing the prefix announcement, if available.

Definition at line 59 of file prefix-announcement.hpp.

Referenced by nfd::RibManager::slAnnounce().

toData()

const Data & ndn::PrefixAnnouncement::toData	(	KeyChain &	keyChain,
		const ndn::security::SigningInfo &	si = KeyChain::getDefaultSigningInfo(),
		optional< uint64_t >	version = nullopt
	)		const

Create a Data packet representing the prefix announcement, if it does not exist.

Parameters

keyChain	KeyChain to sign the Data.
si	signing parameters.
version	version number in Data name; if nullopt, use current Unix timestamp (in milliseconds) as the version number.

Postcondition

getData() == the returned Data

Definition at line 65 of file prefix-announcement.cpp.

References ndn::Name::append(), ndn::Name::appendSegment(), ndn::Name::appendVersion(), ndn::tlv::Content, ndn::tlv::ContentType_PrefixAnn, ndn::Block::encode(), ndn::tlv::nfd::ExpirationPeriod, ndn::KEYWORD_PA_COMP, ndn::encoding::makeNonNegativeIntegerBlock(), ndn::time::system_clock::now(), ndn::Block::push_back(), ndn::security::v2::KeyChain::sign(), and ndn::time::toUnixTimestamp().

getAnnouncedName()

const Name& ndn::PrefixAnnouncement::getAnnouncedName ( ) const

inline

Return announced name.

Definition at line 79 of file prefix-announcement.hpp.

Referenced by ndn::operator<<(), and ndn::operator==().

setAnnouncedName()

PrefixAnnouncement & ndn::PrefixAnnouncement::setAnnouncedName

(

Name

name

)

Set announced name.

Postcondition

getData() == nullopt

Definition at line 91 of file prefix-announcement.cpp.

References nonstd::optional_lite::std11::move().

Referenced by nfd::rib::RibEntry::getPrefixAnnouncement().

getExpiration()

time::milliseconds ndn::PrefixAnnouncement::getExpiration ( ) const

inline

Return relative expiration period.

Definition at line 93 of file prefix-announcement.hpp.

Referenced by nfd::rib::computeExpiration(), ndn::operator<<(), and ndn::operator==().

setExpiration()

PrefixAnnouncement & ndn::PrefixAnnouncement::setExpiration

(

time::milliseconds

expiration

)

Set relative expiration period.

Exceptions

std::invalid_argument

expiration period is negative.

Postcondition

getData() == nullopt

Definition at line 99 of file prefix-announcement.cpp.

References NDN_THROW.

Referenced by nfd::rib::RibEntry::getPrefixAnnouncement().

getValidityPeriod()

optional<security::ValidityPeriod> ndn::PrefixAnnouncement::getValidityPeriod ( ) const

inline

Return absolute validity period.

Definition at line 108 of file prefix-announcement.hpp.

Referenced by nfd::rib::computeExpiration(), ndn::operator<<(), and ndn::operator==().

setValidityPeriod()

PrefixAnnouncement & ndn::PrefixAnnouncement::setValidityPeriod

(

optional< security::ValidityPeriod >

validity

)

Set absolute validity period.

Postcondition

getData() == nullopt

Definition at line 110 of file prefix-announcement.cpp.

References nonstd::optional_lite::std11::move().

---

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

• ndnSIM/ndn-cxx/ndn-cxx/prefix-announcement.hpp
• ndnSIM/ndn-cxx/ndn-cxx/prefix-announcement.cpp