represents a Link object More...

#include <link.hpp>

Inheritance diagram for ndn::Link:

Collaboration diagram for ndn::Link:

Classes
class	Error

Public Member Functions
	Link ()
	Create an empty Link object. More...

	Link (const Block &wire, bool wantSort=true)
	Decode a Link object from a Block. More...

	Link (const Name &name, std::initializer_list< Delegation > dels={})
	Create a Link object with the given name and delegations. More...

void	addDelegation (uint32_t preference, const Name &name)
	Add a delegation in the format of <Name, Preference> More...

uint64_t	getCongestionMark () const
	get the value of the CongestionMark tag More...

const Block &	getContent () const
	Get Content. More...

uint32_t	getContentType () const

const DelegationList &	getDelegationList () const
	Get the delegations. More...

const name::Component &	getFinalBlockId () const

const time::milliseconds &	getFreshnessPeriod () const

const Name &	getFullName () const
	Get full name including implicit digest. More...

const MetaInfo &	getMetaInfo () const
	Get MetaInfo. More...

const Name &	getName () const
	Get name. More...

const Signature &	getSignature () const
	Get Signature. More...

template<typename T >
shared_ptr< T >	getTag () const
	get a tag item More...

bool	hasWire () const
	Check if already has wire. More...

bool	removeDelegation (const Name &name)
	Remove a delegation whose name is `name`. More...

template<typename T >
void	removeTag () const
	remove tag item More...

void	setCongestionMark (uint64_t mark)
	set the CongestionMark tag to the specified value More...

Data &	setContent (const Block &block)
	Set Content from a block. More...

Data &	setContent (const uint8_t *value, size_t valueSize)
	Copy Content value from raw buffer. More...

Data &	setContent (const ConstBufferPtr &value)
	Set Content from wire buffer. More...

Data &	setContentType (uint32_t type)

void	setDelegationList (const DelegationList &dels)
	Set the delegations. More...

Data &	setFinalBlockId (const name::Component &finalBlockId)

Data &	setFreshnessPeriod (const time::milliseconds &freshnessPeriod)

Data &	setMetaInfo (const MetaInfo &metaInfo)
	Set MetaInfo. More...

Data &	setName (const Name &name)
	Set name. More...

Data &	setSignature (const Signature &signature)
	Set Signature. More...

Data &	setSignatureValue (const Block &value)
	Set SignatureValue. More...

template<typename T >
void	setTag (shared_ptr< T > tag) const
	set a tag item More...

void	wireDecode (const Block &wire, bool wantSort=true)
	Decode from the wire format. More...

void	wireDecode (const Block &wire)
	Decode from the wire format. More...

template<encoding::Tag TAG>
size_t	wireEncode (EncodingImpl< TAG > &encoder, bool wantUnsignedPortionOnly=false) const
	Fast encoding or block size estimation. More...

const Block &	wireEncode (EncodingBuffer &encoder, const Block &signatureValue) const
	Finalize Data packet encoding with the specified SignatureValue. More...

const Block &	wireEncode () const
	Encode to a wire format. More...

Protected Member Functions
void	resetWire ()
	Clear wire encoding and cached FullName. More...

Detailed Description

represents a Link object

Definition at line 32 of file link.hpp.

Constructor & Destructor Documentation

ndn::Link::Link ( )

default

Create an empty Link object.

Note that in certain contexts that use Link::shared_from_this(), Link must be created using make_shared:

shared_ptr<Link> linkObject = make_shared<Link>();

ndn::Link::Link	(	const Block &	wire,
		bool	wantSort = `true`
	)

explicit

Decode a Link object from a Block.

Parameters

wire	a TLV block
wantSort	if false, relative order among delegations is preserved

Note that in certain contexts that use Link::shared_from_this(), Link must be created using make_shared:

shared_ptr<Link> linkObject = make_shared<Link>(block);

Definition at line 35 of file link.cpp.

ndn::Link::Link	(	const Name &	name,
		std::initializer_list< Delegation >	dels = `{}`
	)

explicit

Create a Link object with the given name and delegations.

Parameters

name	A reference to the name of the redirected namespace
dels	Delegations in payload

Note that in certain contexts that use Link::shared_from_this(), Link must be created using make_shared:

shared_ptr<Link> link = make_shared<Link>(name, dels);

Definition at line 40 of file link.cpp.

Member Function Documentation

void ndn::Link::addDelegation	(	uint32_t	preference,
		const Name &	name
	)

Add a delegation in the format of <Name, Preference>

Parameters

preference	The preference of the delegation to be added
name	The name of the delegation to be added

Note: If a delegation with name exists, its preference will be updated

Definition at line 86 of file link.cpp.

uint64_t ndn::PacketBase::getCongestionMark ( ) const

inherited

get the value of the CongestionMark tag

Definition at line 28 of file packet-base.cpp.

const Block & ndn::Data::getContent ( ) const

inherited

Get Content.

The Content value is accessible through value()/value_size() or value_begin()/value_end() methods of the Block class.

Definition at line 185 of file data.cpp.

uint32_t ndn::Data::getContentType ( ) const

inlineinherited

Definition at line 201 of file data.hpp.

const DelegationList& ndn::Link::getDelegationList ( ) const

inline

Get the delegations.

Definition at line 88 of file link.hpp.

const name::Component& ndn::Data::getFinalBlockId ( ) const

inlineinherited

Definition at line 219 of file data.hpp.

const time::milliseconds& ndn::Data::getFreshnessPeriod ( ) const

inlineinherited

Definition at line 210 of file data.hpp.

const Name & ndn::Data::getFullName ( ) const

inherited

Get full name including implicit digest.

Precondition: hasWire() == true; i.e. wireEncode() must have been called

Exceptions

Error Data has no wire encoding

Definition at line 148 of file data.cpp.

const MetaInfo& ndn::Data::getMetaInfo ( ) const

inlineinherited

Get MetaInfo.

Definition at line 135 of file data.hpp.

const Name& ndn::Data::getName ( ) const

inlineinherited

Get name.

Definition at line 121 of file data.hpp.

const Signature& ndn::Data::getSignature ( ) const

inlineinherited

Get Signature.

Definition at line 182 of file data.hpp.

template<typename T >

shared_ptr< T > ndn::TagHost::getTag ( ) const

inlineinherited

get a tag item

Template Parameters

T	type of the tag, which must be a subclass of ndn::Tag

Return values

nullptr if no Tag of type T is stored

Definition at line 67 of file tag-host.hpp.

bool ndn::Data::hasWire ( ) const

inlineinherited

Check if already has wire.

Definition at line 105 of file data.hpp.

bool ndn::Link::removeDelegation ( const Name & name )

Remove a delegation whose name is name.

Parameters

name	The name of the delegation to be removed

Returns: true if delegation is removed, otherwise false

Definition at line 93 of file link.cpp.

template<typename T >

void ndn::TagHost::removeTag ( ) const

inlineinherited

remove tag item

Note: Tag can be removed even on a const tag host instance

Definition at line 94 of file tag-host.hpp.

void ndn::Data::resetWire ( )

protectedinherited

Clear wire encoding and cached FullName.

Note: This does not clear the SignatureValue.

Definition at line 162 of file data.cpp.

void ndn::PacketBase::setCongestionMark ( uint64_t mark )

inherited

set the CongestionMark tag to the specified value

Definition at line 41 of file packet-base.cpp.

Data & ndn::Data::setContent ( const Block & block )

inherited

Set Content from a block.

If block's TLV-TYPE is Content, it will be used directly as Data's Content element. If block's TLV-TYPE is not Content, it will be nested into a Content element.

Returns: a reference to this Data, to allow chaining

Definition at line 194 of file data.cpp.

Data & ndn::Data::setContent	(	const uint8_t *	value,
		size_t	valueSize
	)

inherited

Copy Content value from raw buffer.

Parameters

value	pointer to the first octet of the value
valueSize	size of the raw buffer

Returns: a reference to this Data, to allow chaining

Definition at line 209 of file data.cpp.

Data & ndn::Data::setContent ( const ConstBufferPtr & value )

inherited

Set Content from wire buffer.

Parameters

value Content value, which does not need to be a TLV element

Returns: a reference to this Data, to allow chaining

Definition at line 217 of file data.cpp.

Data & ndn::Data::setContentType ( uint32_t type )

inherited

Definition at line 241 of file data.cpp.

void ndn::Link::setDelegationList ( const DelegationList & dels )

Set the delegations.

Note: This is more efficient than multiple addDelegation and removeDelegation invocations.

Definition at line 79 of file link.cpp.

Data & ndn::Data::setFinalBlockId ( const name::Component & finalBlockId )

inherited

Definition at line 257 of file data.cpp.

Data & ndn::Data::setFreshnessPeriod ( const time::milliseconds & freshnessPeriod )

inherited

Definition at line 249 of file data.cpp.

Data & ndn::Data::setMetaInfo ( const MetaInfo & metaInfo )

inherited

Set MetaInfo.

Returns: a reference to this Data, to allow chaining

Definition at line 177 of file data.cpp.

Data & ndn::Data::setName ( const Name & name )

inherited

Set name.

Returns: a reference to this Data, to allow chaining

Definition at line 169 of file data.cpp.

Data & ndn::Data::setSignature ( const Signature & signature )

inherited

Set Signature.

Returns: a reference to this Data, to allow chaining

Definition at line 225 of file data.cpp.

Data & ndn::Data::setSignatureValue ( const Block & value )

inherited

Set SignatureValue.

Returns: a reference to this Data, to allow chaining

Definition at line 233 of file data.cpp.

template<typename T >

void ndn::TagHost::setTag ( shared_ptr< T > tag ) const

inlineinherited

set a tag item

Template Parameters

T	type of the tag, which must be a subclass of ndn::Tag

Note: Tag can be set even on a const tag host instance

Definition at line 80 of file tag-host.hpp.

void ndn::Link::wireDecode	(	const Block &	wire,
		bool	wantSort = `true`
	)

Decode from the wire format.

Parameters

wire	a TLV block
wantSort	if false, relative order among delegations is preserved

Definition at line 67 of file link.cpp.

void ndn::Data::wireDecode ( const Block & wire )

inherited

Decode from the wire format.

Definition at line 122 of file data.cpp.

template<encoding::Tag TAG>

size_t ndn::Data::wireEncode	(	EncodingImpl< TAG > &	encoder,
		bool	wantUnsignedPortionOnly = `false`
	)		const

inherited

Fast encoding or block size estimation.

Parameters

encoder	EncodingEstimator or EncodingBuffer instance
wantUnsignedPortionOnly	If true, only prepends Name, MetaInfo, Content, and SignatureInfo to `encoder`, but omit SignatureValue and outmost Type-Length of Data element. This is intended to be used with wireEncode(encoder, signatureValue).

Exceptions

Error SignatureBits are not provided and wantUnsignedPortionOnly is false.

Definition at line 48 of file data.cpp.

const Block & ndn::Data::wireEncode	(	EncodingBuffer &	encoder,
		const Block &	signatureValue
	)		const

inherited

Finalize Data packet encoding with the specified SignatureValue.

Parameters

encoder	EncodingBuffer containing Name, MetaInfo, Content, and SignatureInfo, but without SignatureValue or outmost Type-Length of Data element
signatureValue	SignatureValue element

This method is intended to be used in concert with Data::wireEncode(encoder, true)

Data data;
...
EncodingBuffer encoder;
data.wireEncode(encoder, true);
...
Block signatureValue = <sign_over_unsigned_portion>(encoder.buf(), encoder.size());
data.wireEncode(encoder, signatureValue)

Definition at line 93 of file data.cpp.

const Block & ndn::Data::wireEncode ( ) const

inherited

Encode to a wire format.

Definition at line 106 of file data.cpp.

ndn-cxx: NDN C++ library with eXperimental eXtensions 0.6.0 documentation

Classes

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation