org.onosproject.net.host

Interface HostStore

All Superinterfaces:

Store<HostEvent,HostStoreDelegate>

public interface HostStore
extends Store<HostEvent,HostStoreDelegate>

Manages inventory of end-station hosts; not intended for direct use.

Method Summary

Modifier and Type	Method and Description
default MacAddress	addPendingHostLocation(HostId hostId, HostLocation hostLocation) Notifies HostStore the beginning of pending host location verification and retrieves the unique MAC address for the probe.
HostEvent	createOrUpdateHost(ProviderId providerId, HostId hostId, HostDescription hostDescription, boolean replaceIps) Creates a new host or updates the existing one based on the specified description.
java.util.Set<Host>	getConnectedHosts(ConnectPoint connectPoint) Returns the set of hosts whose location falls on the given connection point.
java.util.Set<Host>	getConnectedHosts(DeviceId deviceId) Returns the set of hosts whose location falls on the given device.
Host	getHost(HostId hostId) Returns the host with the specified identifer.
int	getHostCount() Returns the number of hosts in the store.
java.lang.Iterable<Host>	getHosts() Returns a collection of all hosts in the store.
java.util.Set<Host>	getHosts(IpAddress ip) Returns the set of hosts with the specified IP address.
java.util.Set<Host>	getHosts(MacAddress mac) Returns the set of hosts with the specified MAC address.
java.util.Set<Host>	getHosts(VlanId vlanId) Returns the set of all hosts within the specified VLAN.
HostEvent	removeHost(HostId hostId) Removes the specified host from the inventory.
HostEvent	removeIp(HostId hostId, IpAddress ipAddress) Removes the specified ip from the host entry.
void	removeLocation(HostId hostId, HostLocation location) Removes the specified location from the host entry.
default void	removePendingHostLocation(MacAddress probeMac) Notifies HostStore the end of pending host location verification.

Methods inherited from interface org.onosproject.store.Store

hasDelegate, setDelegate, unsetDelegate

Method Detail

createOrUpdateHost

HostEvent createOrUpdateHost(ProviderId providerId,
                             HostId hostId,
                             HostDescription hostDescription,
                             boolean replaceIps)

Creates a new host or updates the existing one based on the specified description.

Parameters:

providerId - provider identification

hostId - host identification

hostDescription - host description data

replaceIps - replace IP set if true, merge IP set otherwise

Returns:

appropriate event or null if no change resulted

removeHost

HostEvent removeHost(HostId hostId)

Removes the specified host from the inventory.

Parameters:

hostId - host identification

Returns:

remove event or null if host was not found

removeIp

HostEvent removeIp(HostId hostId,
                   IpAddress ipAddress)

Removes the specified ip from the host entry.

Parameters:

hostId - host identification

ipAddress - ipAddress to be removed

Returns:

remove event or null if host was not found

removeLocation

void removeLocation(HostId hostId,
                    HostLocation location)

Removes the specified location from the host entry.

Parameters:

hostId - host identification

location - location to be removed

getHostCount

int getHostCount()

Returns the number of hosts in the store.

Returns:

host count

getHosts

java.lang.Iterable<Host> getHosts()

Returns a collection of all hosts in the store.

Returns:

iterable collection of all hosts

getHost

Host getHost(HostId hostId)

Returns the host with the specified identifer.

Parameters:

hostId - host identification

Returns:

host or null if not found

getHosts

java.util.Set<Host> getHosts(VlanId vlanId)

Returns the set of all hosts within the specified VLAN.

Parameters:

vlanId - vlan id

Returns:

set of hosts in the vlan

getHosts

java.util.Set<Host> getHosts(MacAddress mac)

Returns the set of hosts with the specified MAC address.

Parameters:

mac - mac address

Returns:

set of hosts with the given mac

getHosts

java.util.Set<Host> getHosts(IpAddress ip)

Returns the set of hosts with the specified IP address.

Parameters:

ip - ip address

Returns:

set of hosts with the given IP

getConnectedHosts

java.util.Set<Host> getConnectedHosts(ConnectPoint connectPoint)

Returns the set of hosts whose location falls on the given connection point.

Parameters:

connectPoint - connection point

Returns:

set of hosts

getConnectedHosts

java.util.Set<Host> getConnectedHosts(DeviceId deviceId)

Returns the set of hosts whose location falls on the given device.

Parameters:

deviceId - infrastructure device identifier

Returns:

set of hosts

addPendingHostLocation

default MacAddress addPendingHostLocation(HostId hostId,
                                          HostLocation hostLocation)

Notifies HostStore the beginning of pending host location verification and retrieves the unique MAC address for the probe.

Parameters:

hostId - ID of the host

hostLocation - the host location that is under verification

Returns:

probeMac, the source MAC address ONOS uses to probe the host

removePendingHostLocation

default void removePendingHostLocation(MacAddress probeMac)

Notifies HostStore the end of pending host location verification.

Parameters:

probeMac - the source MAC address ONOS uses to probe the host