represents a Link object More...

#include <ndn-cxx/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...

InputBuffers	extractSignedRanges () const
	Extract ranges of Data covered by the signature. More...

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

const Block &	getContent () const noexcept
	Get the Content element. More...

uint32_t	getContentType () const

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

const optional< name::Component > &	getFinalBlock () const

time::milliseconds	getFreshnessPeriod () const

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

optional< KeyLocator >	getKeyLocator () const noexcept
	Get KeyLocator. More...

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

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

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

const SignatureInfo &	getSignatureInfo () const noexcept
	Get SignatureInfo. More...

int32_t	getSignatureType () const noexcept
	Get SignatureType. More...

const Block &	getSignatureValue () const noexcept
	Get SignatureValue. More...

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

bool	hasContent () const noexcept
	Return whether this Data has a Content element. More...

bool	hasWire () const noexcept
	Check if this instance has cached wire encoding. 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 length)
	Set Content by copying from a raw buffer. More...

Data &	setContent (ConstBufferPtr value)
	Set Content from a shared buffer. More...

Data &	setContentType (uint32_t type)

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

Data &	setFinalBlock (optional< name::Component > finalBlockId)

Data &	setFreshnessPeriod (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 &	setSignatureInfo (const SignatureInfo &info)
	Set SignatureInfo. More...

Data &	setSignatureValue (ConstBufferPtr value)
	Set SignatureValue. More...

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

Data &	unsetContent ()
	Remove the Content element. More...

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

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

template<encoding::Tag TAG>
size_t	wireEncode (EncodingImpl< TAG > &encoder, bool wantUnsignedPortionOnly=false) const
	Prepend wire encoding to `encoder`. More...

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

const Block &	wireEncode () const
	Encode into a Block. 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

◆ Link() [1/3]

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>();

◆ Link() [2/3]

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.

◆ Link() [3/3]

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

◆ addDelegation()

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.

◆ extractSignedRanges()

InputBuffers ndn::Data::extractSignedRanges ( ) const

inherited

Extract ranges of Data covered by the signature.

Exceptions

Error Data cannot be encoded or is missing ranges necessary for signing

Warning: The returned pointers will be invalidated if wireDecode() or wireEncode() are called.

Definition at line 330 of file data.cpp.

◆ getCongestionMark()

uint64_t ndn::PacketBase::getCongestionMark ( ) const

inherited

get the value of the CongestionMark tag

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

◆ getContent()

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

inlinenoexceptinherited

Get the Content element.

If the element is not present (hasContent() == false), an invalid Block will be returned.

The value of the returned Content Block (if valid) can be accessed through Block::value() / Block::value_size() or Block::value_begin() / Block::value_end().

See also: hasContent(); Block::blockFromValue(), Block::parse()

Definition at line 172 of file data.hpp.

◆ getContentType()

uint32_t ndn::Data::getContentType ( ) const

inlineinherited

Definition at line 277 of file data.hpp.

◆ getDelegationList()

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

inline

Get the delegations.

Definition at line 84 of file link.hpp.

◆ getFinalBlock()

const optional<name::Component>& ndn::Data::getFinalBlock ( ) const

inlineinherited

Definition at line 295 of file data.hpp.

◆ getFreshnessPeriod()

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

inlineinherited

Definition at line 286 of file data.hpp.

◆ getFullName()

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 206 of file data.cpp.

◆ getKeyLocator()

optional<KeyLocator> ndn::Data::getKeyLocator ( ) const

inlinenoexceptinherited

Get KeyLocator.

Definition at line 316 of file data.hpp.

◆ getMetaInfo()

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

inlinenoexceptinherited

Get MetaInfo.

Definition at line 140 of file data.hpp.

◆ getName()

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

inlinenoexceptinherited

Get name.

Definition at line 126 of file data.hpp.

◆ getSignature()

Signature ndn::Data::getSignature ( ) const

inherited

Get Signature.

Deprecated:: Use getSignatureInfo and getSignatureValue

Definition at line 295 of file data.cpp.

◆ getSignatureInfo()

const SignatureInfo& ndn::Data::getSignatureInfo ( ) const

inlinenoexceptinherited

Get SignatureInfo.

Definition at line 231 of file data.hpp.

◆ getSignatureType()

int32_t ndn::Data::getSignatureType ( ) const

inlinenoexceptinherited

Get SignatureType.

Returns: tlv::SignatureTypeValue, or -1 to indicate the signature is invalid

Definition at line 308 of file data.hpp.

◆ getSignatureValue()

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

inlinenoexceptinherited

Get SignatureValue.

Definition at line 251 of file data.hpp.

◆ getTag()

template<typename T >

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

inherited

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 66 of file tag-host.hpp.

◆ hasContent()

bool ndn::Data::hasContent ( ) const

inlinenoexceptinherited

Return whether this Data has a Content element.

Definition at line 155 of file data.hpp.

◆ hasWire()

bool ndn::Data::hasWire ( ) const

inlinenoexceptinherited

Check if this instance has cached wire encoding.

Definition at line 110 of file data.hpp.

◆ removeDelegation()

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.

◆ removeTag()

template<typename T >

void ndn::TagHost::removeTag ( ) const

inherited

remove tag item

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

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

◆ resetWire()

void ndn::Data::resetWire ( )

protectedinherited

Clear wire encoding and cached FullName.

Note: This does not clear the SignatureValue.

Definition at line 220 of file data.cpp.

◆ setCongestionMark()

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.

◆ setContent() [1/3]

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

inherited

Set Content from a Block.

Parameters

block TLV block to be used as Content; must be valid

Returns: a reference to this Data, to allow chaining

If the block's TLV-TYPE is tlv::Content, it will be used directly as this Data's Content element. Otherwise, the block will be nested into a Content element.

Definition at line 245 of file data.cpp.

◆ setContent() [2/3]

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

inherited

Set Content by copying from a raw buffer.

Parameters

value	buffer with the TLV-VALUE of the content; may be nullptr if `length` is zero
length	size of the buffer

Returns: a reference to this Data, to allow chaining

Definition at line 263 of file data.cpp.

◆ setContent() [3/3]

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

inherited

Set Content from a shared buffer.

Parameters

value buffer with the TLV-VALUE of the content; must not be nullptr

Returns: a reference to this Data, to allow chaining

Definition at line 275 of file data.cpp.

◆ setContentType()

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

inherited

Definition at line 343 of file data.cpp.

◆ setDelegationList()

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.

◆ setFinalBlock()

Data & ndn::Data::setFinalBlock ( optional< name::Component > finalBlockId )

inherited

Definition at line 363 of file data.cpp.

◆ setFreshnessPeriod()

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

inherited

Definition at line 353 of file data.cpp.

◆ setMetaInfo()

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

inherited

Set MetaInfo.

Returns: a reference to this Data, to allow chaining

Definition at line 237 of file data.cpp.

◆ setName()

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

inherited

Set name.

Returns: a reference to this Data, to allow chaining

Definition at line 227 of file data.cpp.

◆ setSignature()

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

inherited

Set Signature.

Deprecated:: Use setSignatureInfo and setSignatureValue

Returns: a reference to this Data, to allow chaining

Definition at line 301 of file data.cpp.

◆ setSignatureInfo()

Data & ndn::Data::setSignatureInfo ( const SignatureInfo & info )

inherited

Set SignatureInfo.

This is a low-level function that should not normally be called directly by applications. Instead, provide a SignatureInfo to the SigningInfo object passed to KeyChain::sign().

Returns: a reference to this Data, to allow chaining

Warning: SignatureInfo is overwritten when the packet is signed via KeyChain::sign().

See also: SigningInfo

Definition at line 310 of file data.cpp.

◆ setSignatureValue()

Data & ndn::Data::setSignatureValue ( ConstBufferPtr value )

inherited

Set SignatureValue.

Parameters

value buffer containing the TLV-VALUE of the SignatureValue; must not be nullptr

This is a low-level function that should not normally be called directly by applications. Instead, use KeyChain::sign() to sign the packet.

Returns: a reference to this Data, to allow chaining

Warning: SignatureValue is overwritten when the packet is signed via KeyChain::sign().

Definition at line 318 of file data.cpp.

◆ setTag()

template<typename T >

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

inherited

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 79 of file tag-host.hpp.

◆ unsetContent()

Data & ndn::Data::unsetContent ( )

inherited

Remove the Content element.

Returns: a reference to this Data, to allow chaining

Postcondition: hasContent() == false

Definition at line 287 of file data.cpp.

◆ wireDecode() [1/2]

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.

◆ wireDecode() [2/2]

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

inherited

Decode from wire.

Definition at line 124 of file data.cpp.

◆ wireEncode() [1/3]

template<encoding::Tag TAG>

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

inherited

Prepend wire encoding to encoder.

Parameters

encoder	EncodingEstimator or EncodingBuffer instance.
wantUnsignedPortionOnly	If true, prepend only Name, MetaInfo, Content, and SignatureInfo to `encoder`, but omit SignatureValue and the outermost TLV Type and Length of the Data element. This is intended to be used with wireEncode(EncodingBuffer&, const Block&) const.

Exceptions

Error Signature is not present and wantUnsignedPortionOnly is false.

Definition at line 47 of file data.cpp.

◆ wireEncode() [2/3]

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 and the outermost Type-Length of the Data element.
signatureValue	SignatureValue element.

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

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 95 of file data.cpp.

◆ wireEncode() [3/3]

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

inherited

Encode into a Block.

Precondition: Data must be signed.

Definition at line 108 of file data.cpp.

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

Classes

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Link() [1/3]

◆ Link() [2/3]

◆ Link() [3/3]

Member Function Documentation

◆ addDelegation()

◆ extractSignedRanges()

◆ getCongestionMark()

◆ getContent()

◆ getContentType()

◆ getDelegationList()

◆ getFinalBlock()

◆ getFreshnessPeriod()

◆ getFullName()

◆ getKeyLocator()

◆ getMetaInfo()

◆ getName()

◆ getSignature()

◆ getSignatureInfo()

◆ getSignatureType()

◆ getSignatureValue()

◆ getTag()

◆ hasContent()

◆ hasWire()

◆ removeDelegation()

◆ removeTag()

◆ resetWire()

◆ setCongestionMark()

◆ setContent() [1/3]

◆ setContent() [2/3]

◆ setContent() [3/3]

◆ setContentType()

◆ setDelegationList()

◆ setFinalBlock()

◆ setFreshnessPeriod()

◆ setMetaInfo()

◆ setName()

◆ setSignature()

◆ setSignatureInfo()

◆ setSignatureValue()

◆ setTag()

◆ unsetContent()

◆ wireDecode() [1/2]

◆ wireDecode() [2/2]

◆ wireEncode() [1/3]

◆ wireEncode() [2/3]

◆ wireEncode() [3/3]