org.onosproject.ui.model.topo

Class UiLinkId

java.lang.Object

org.onosproject.ui.model.topo.UiLinkId

public final class UiLinkId
extends Object

A canonical representation of an identifier for UiLinks.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UiLinkId.Direction Designates the directionality of an underlying (uni-directional) link.

Method Summary

Modifier and Type	Method and Description
ElementId	elementA() Returns the identifier of the first element.
ElementId	elementB() Returns the identifier of the second element.
boolean	equals(Object o)
int	hashCode()
PortNumber	portA() Returns the port of the first element.
PortNumber	portB() Returns the port of the second element.
RegionId	regionA() Returns the identity of the first region.
RegionId	regionB() Returns the identity of the second region.
String	toString()
static UiLinkId	uiLinkId(Link link) Generates the canonical link identifier for the given link.
static UiLinkId	uiLinkId(RegionId regionId, DeviceId deviceId, PortNumber portNumber) Generates the canonical link identifier for a link between the specified region and device/port.
static UiLinkId	uiLinkId(RegionId one, RegionId two) Generates the canonical link identifier for a link between the specified region nodes.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

toString

public String toString()

Overrides:

toString in class Object

elementA

public ElementId elementA()

Returns the identifier of the first element. Note that the returned value will be null if this identifier is for a region-region link.

Returns:

first element identity

portA

public PortNumber portA()

Returns the port of the first element. Note that the returned value will be null if this identifier is for a region-region link.

Returns:

first element port

elementB

public ElementId elementB()

Returns the identifier of the second element. Note that the returned value will be null if this identifier is for a region-region link.

Returns:

second element identity

portB

public PortNumber portB()

Returns the port of the second element. Note that the returned value will be null if this identifier is for a region-region link.

Returns:

second element port

regionA

public RegionId regionA()

Returns the identity of the first region. Note that the returned value will be null if this identifier is for a device-device or device-host link.

Returns:

first region ID

regionB

public RegionId regionB()

Returns the identity of the second region. Note that the returned value will be null if this identifier is for a device-device or device-host link.

Returns:

second region ID

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

uiLinkId

public static UiLinkId uiLinkId(Link link)

Generates the canonical link identifier for the given link.

Parameters:

link - link for which the identifier is required

Returns:

link identifier

Throws:

NullPointerException - if any of the required fields are null

uiLinkId

public static UiLinkId uiLinkId(RegionId one,
                                RegionId two)

Generates the canonical link identifier for a link between the specified region nodes.

Parameters:

one - the first region ID

two - the second region ID

Returns:

link identifier

Throws:

NullPointerException - if any of the required fields are null

IllegalArgumentException - if the identifiers are identical

uiLinkId

public static UiLinkId uiLinkId(RegionId regionId,
                                DeviceId deviceId,
                                PortNumber portNumber)

Generates the canonical link identifier for a link between the specified region and device/port.

Parameters:

regionId - region ID

deviceId - device ID

portNumber - port number

Returns:

link identifier

Throws:

NullPointerException - if any of the required fields are null