org.onosproject.incubator.net.virtual

Interface VirtualNetworkService

All Known Subinterfaces:

VirtualNetworkAdminService

All Known Implementing Classes:

VirtualNetworkManager

@Beta
public interface VirtualNetworkService

Service for querying virtual network inventory.

Field Summary

Fields

Modifier and Type	Field and Description
static String	VIRTUAL_NETWORK_TOPIC The topic used for obtaining globally unique ids.

Method Summary

Modifier and Type	Method and Description
<T> T	get(NetworkId networkId, Class<T> serviceClass) Returns implementation of the specified service class for operating in the context of the given network.
org.onlab.osgi.ServiceDirectory	getServiceDirectory() Returns service directory.
Set<VirtualDevice>	getVirtualDevices(NetworkId networkId) Returns a collection of all virtual devices in the specified network.
Set<VirtualHost>	getVirtualHosts(NetworkId networkId) Returns a collection of all virtual hosts in the specified network.
Set<VirtualLink>	getVirtualLinks(NetworkId networkId) Returns collection of all virtual links in the specified network.
org.onosproject.core.ApplicationId	getVirtualNetworkApplicationId(NetworkId networkId) Returns the application identifier for a virtual network.
Set<VirtualNetwork>	getVirtualNetworks(TenantId tenantId) Returns a collection of all virtual networks created on behalf of the specified tenant.
Set<VirtualPort>	getVirtualPorts(NetworkId networkId, org.onosproject.net.DeviceId deviceId) Returns list of all virtual ports of the specified device.

Field Detail

VIRTUAL_NETWORK_TOPIC

static final String VIRTUAL_NETWORK_TOPIC

The topic used for obtaining globally unique ids.

See Also:

Constant Field Values

Method Detail

getVirtualNetworks

Set<VirtualNetwork> getVirtualNetworks(TenantId tenantId)

Returns a collection of all virtual networks created on behalf of the specified tenant.

Parameters:

tenantId - tenant identifier

Returns:

collection of networks

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

getVirtualDevices

Set<VirtualDevice> getVirtualDevices(NetworkId networkId)

Returns a collection of all virtual devices in the specified network.

Parameters:

networkId - network identifier

Returns:

collection of devices

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

getVirtualHosts

Set<VirtualHost> getVirtualHosts(NetworkId networkId)

Returns a collection of all virtual hosts in the specified network.

Parameters:

networkId - network identifier

Returns:

collection of hosts

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

getVirtualLinks

Set<VirtualLink> getVirtualLinks(NetworkId networkId)

Returns collection of all virtual links in the specified network.

Parameters:

networkId - network identifier

Returns:

collection of links

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

getVirtualPorts

Set<VirtualPort> getVirtualPorts(NetworkId networkId,
                                 org.onosproject.net.DeviceId deviceId)

Returns list of all virtual ports of the specified device. If the device identifier is null then all of the virtual ports in the specified network will be returned.

Parameters:

networkId - network identifier

deviceId - device identifier

Returns:

list of ports

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

get

<T> T get(NetworkId networkId,
          Class<T> serviceClass)

Returns implementation of the specified service class for operating in the context of the given network.

The following services will be available:

• DeviceService
• LinkService
• HostService
• TopologyService
• PathService
• FlowRuleService
• FlowObjectiveService
• IntentService

Type Parameters:

T - type of service

Parameters:

networkId - network identifier

serviceClass - service class

Returns:

implementation class

Throws:

org.onlab.util.ItemNotFoundException - if no such network found

org.onlab.osgi.ServiceNotFoundException - if no implementation found

getServiceDirectory

org.onlab.osgi.ServiceDirectory getServiceDirectory()

Returns service directory.

Returns:

a service directory

getVirtualNetworkApplicationId

org.onosproject.core.ApplicationId getVirtualNetworkApplicationId(NetworkId networkId)

Returns the application identifier for a virtual network.

Parameters:

networkId - network identifier

Returns:

an representative application identifier for a virtual network