| package org.onlab.onos.of.controller; |
| |
| import org.projectfloodlight.openflow.util.HexString; |
| |
| import java.net.URI; |
| import java.net.URISyntaxException; |
| |
| import static com.google.common.base.Preconditions.checkArgument; |
| import static org.onlab.util.Tools.fromHex; |
| import static org.onlab.util.Tools.toHex; |
| |
| /** |
| * The class representing a network switch DPID. |
| * This class is immutable. |
| */ |
| public final class Dpid { |
| |
| private static final String SCHEME = "of"; |
| private static final long UNKNOWN = 0; |
| private final long value; |
| |
| /** |
| * Default constructor. |
| */ |
| public Dpid() { |
| this.value = Dpid.UNKNOWN; |
| } |
| |
| /** |
| * Constructor from a long value. |
| * |
| * @param value the value to use. |
| */ |
| public Dpid(long value) { |
| this.value = value; |
| } |
| |
| /** |
| * Constructor from a string. |
| * |
| * @param value the value to use. |
| */ |
| public Dpid(String value) { |
| this.value = HexString.toLong(value); |
| } |
| |
| /** |
| * Get the value of the DPID. |
| * |
| * @return the value of the DPID. |
| */ |
| public long value() { |
| return value; |
| } |
| |
| /** |
| * Convert the DPID value to a ':' separated hexadecimal string. |
| * |
| * @return the DPID value as a ':' separated hexadecimal string. |
| */ |
| @Override |
| public String toString() { |
| return HexString.toHexString(this.value); |
| } |
| |
| @Override |
| public boolean equals(Object other) { |
| if (!(other instanceof Dpid)) { |
| return false; |
| } |
| |
| Dpid otherDpid = (Dpid) other; |
| |
| return value == otherDpid.value; |
| } |
| |
| @Override |
| public int hashCode() { |
| int hash = 17; |
| hash += 31 * hash + (int) (value ^ value >>> 32); |
| return hash; |
| } |
| |
| /** |
| * Returns DPID created from the given device URI. |
| * |
| * @param uri device URI |
| * @return dpid |
| */ |
| public static Dpid dpid(URI uri) { |
| checkArgument(uri.getScheme().equals(SCHEME), "Unsupported URI scheme"); |
| return new Dpid(fromHex(uri.getSchemeSpecificPart())); |
| } |
| |
| /** |
| * Produces device URI from the given DPID. |
| * |
| * @param dpid device dpid |
| * @return device URI |
| */ |
| public static URI uri(Dpid dpid) { |
| return uri(dpid.value); |
| } |
| |
| /** |
| * Produces device URI from the given DPID long. |
| * |
| * @param value device dpid as long |
| * @return device URI |
| */ |
| public static URI uri(long value) { |
| try { |
| return new URI(SCHEME, toHex(value), null); |
| } catch (URISyntaxException e) { |
| return null; |
| } |
| } |
| |
| } |