ndn::net::NetworkMonitorStub Class Reference

A dummy NetworkMonitor for unit testing. More...

#include <ndn-cxx/net/network-monitor-stub.hpp>

Inheritance diagram for ndn::net::NetworkMonitorStub:

Collaboration diagram for ndn::net::NetworkMonitorStub:

Public Types
enum	Capability : uint32_t {   CAP_NONE = 0 ,   CAP_ENUM = 1 << 0 ,   CAP_IF_ADD_REMOVE = 1 << 1 ,   CAP_STATE_CHANGE = 1 << 2 ,   CAP_MTU_CHANGE = 1 << 3 ,   CAP_ADDR_ADD_REMOVE = 1 << 4 }

Public Member Functions
	NetworkMonitorStub (uint32_t capabilities)
	Constructor. More...
void	addInterface (shared_ptr< NetworkInterface > netif)
	Emit the onInterfaceAdded signal and add netif internally. More...
void	emitEnumerationCompleted ()
	Emit the onEnumerationCompleted signal. More...
uint32_t	getCapabilities () const
	Returns a bitwise OR'ed set of Capability flags supported on the current platform. More...
shared_ptr< const NetworkInterface >	getNetworkInterface (const std::string &ifname) const
	Returns the NetworkInterface with the given name, or nullptr if it does not exist. More...
std::vector< shared_ptr< const NetworkInterface > >	listNetworkInterfaces () const
	Lists all network interfaces currently available on the system. More...
void	removeInterface (const std::string &ifname)
	Emit the onInterfaceRemoved signal and remove netif internally. More...

Static Public Member Functions
static shared_ptr< NetworkInterface >	makeNetworkInterface ()
	Create a NetworkInterface instance. More...

Public Attributes
util::Signal< NetworkMonitorImpl > &	onEnumerationCompleted
	Fires when the enumeration of all network interfaces on the system is complete. More...
util::Signal< NetworkMonitorImpl, shared_ptr< const NetworkInterface > > &	onInterfaceAdded
	Fires whenever a new interface is detected on the system. More...
util::Signal< NetworkMonitorImpl, shared_ptr< const NetworkInterface > > &	onInterfaceRemoved
	Fires whenever an interface disappears from the system. More...
util::Signal< NetworkMonitorImpl > &	onNetworkStateChanged

Detailed Description

A dummy NetworkMonitor for unit testing.

Definition at line 35 of file network-monitor-stub.hpp.

Member Enumeration Documentation

Capability

enum ndn::net::NetworkMonitor::Capability : uint32_t

inherited

Enumerator
CAP_NONE	NetworkMonitor is not supported and is a no-op.
CAP_ENUM	listNetworkInterfaces() and getNetworkInterface() are supported
CAP_IF_ADD_REMOVE	NetworkMonitor onInterfaceAdded and onInterfaceRemoved signals are supported.
CAP_STATE_CHANGE	NetworkInterface onStateChanged signal is supported.
CAP_MTU_CHANGE	NetworkInterface onMtuChanged signal is supported.
CAP_ADDR_ADD_REMOVE	NetworkInterface onAddressAdded and onAddressRemoved signals are supported.

Definition at line 67 of file network-monitor.hpp.

Constructor & Destructor Documentation

NetworkMonitorStub()

ndn::net::NetworkMonitorStub::NetworkMonitorStub ( uint32_t  capabilities )

explicit

Constructor.

Parameters

capabilities

The capabilities reported by getCapabilities()

Definition at line 102 of file network-monitor-stub.cpp.

Member Function Documentation

addInterface()

void ndn::net::NetworkMonitorStub::addInterface

(

shared_ptr< NetworkInterface >

netif

)

Emit the onInterfaceAdded signal and add netif internally.

Parameters

netif

new network interface

Postcondition

getNetworkInterface(netif->getName()) == netif

listNetworkInterfaces() contains netif

Exceptions

std::invalid_argument

a network interface with the same name already exists

Definition at line 120 of file network-monitor-stub.cpp.

emitEnumerationCompleted()

void ndn::net::NetworkMonitorStub::emitEnumerationCompleted

(

)

Emit the onEnumerationCompleted signal.

A real NetworkMonitor starts with an "enumerating" state, during which the initial information about network interfaces is collected from the OS. Upon discovering a network interface, it emits the onInterfaceAdded signal. When the initial enumerating completes, it emits the onEnumerationCompleted signal.

To simulate this procedure on a newly constructed MockNetworkMonitor, the caller should invoke addInterface() once for each network interface that already exists, and then invoke emitEnumerationCompleted().

Definition at line 132 of file network-monitor-stub.cpp.

getCapabilities()

uint32_t ndn::net::NetworkMonitor::getCapabilities ( ) const

inherited

Returns a bitwise OR'ed set of Capability flags supported on the current platform.

Definition at line 73 of file network-monitor.cpp.

getNetworkInterface()

shared_ptr< const NetworkInterface > ndn::net::NetworkMonitor::getNetworkInterface ( const std::string &  ifname ) const

inherited

Returns the NetworkInterface with the given name, or nullptr if it does not exist.

Definition at line 79 of file network-monitor.cpp.

listNetworkInterfaces()

std::vector< shared_ptr< const NetworkInterface > > ndn::net::NetworkMonitor::listNetworkInterfaces ( ) const

inherited

Lists all network interfaces currently available on the system.

Warning

May return incomplete results if called before the onEnumerationCompleted signal has been emitted.

Definition at line 85 of file network-monitor.cpp.

makeNetworkInterface()

shared_ptr< NetworkInterface > ndn::net::NetworkMonitorStub::makeNetworkInterface ( )

static

Create a NetworkInterface instance.

Definition at line 114 of file network-monitor-stub.cpp.

removeInterface()

void ndn::net::NetworkMonitorStub::removeInterface

(

const std::string &

ifname

)

Emit the onInterfaceRemoved signal and remove netif internally.

Parameters

ifname

network interface name

Postcondition

getNetworkInterface(ifname) == nullptr

listNetworkInterfaces() does not contains an interface with specified name

Note

If the specified interface name does not exist, this operation has no effect.

Definition at line 126 of file network-monitor-stub.cpp.

Member Data Documentation

onEnumerationCompleted

util::Signal<NetworkMonitorImpl>& ndn::net::NetworkMonitor::onEnumerationCompleted

inherited

Fires when the enumeration of all network interfaces on the system is complete.

Definition at line 115 of file network-monitor.hpp.

onInterfaceAdded

util::Signal<NetworkMonitorImpl, shared_ptr<const NetworkInterface> >& ndn::net::NetworkMonitor::onInterfaceAdded

inherited

Fires whenever a new interface is detected on the system.

Definition at line 118 of file network-monitor.hpp.

onInterfaceRemoved

util::Signal<NetworkMonitorImpl, shared_ptr<const NetworkInterface> >& ndn::net::NetworkMonitor::onInterfaceRemoved

inherited

Fires whenever an interface disappears from the system.

Note

The NetworkInterface object has already been removed from the list returned by listNetworkInterfaces() when this signal is emitted.

Definition at line 125 of file network-monitor.hpp.

onNetworkStateChanged

util::Signal<NetworkMonitorImpl>& ndn::net::NetworkMonitor::onNetworkStateChanged

inherited

Deprecated:

Only for backward compatibility

Definition at line 128 of file network-monitor.hpp.