Jonathan Hart | 472062d | 2014-04-03 10:56:48 -0700 | [diff] [blame] | 1 | package net.onrc.onos.core.topology; |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 2 | |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 3 | import java.nio.ByteBuffer; |
| 4 | import java.nio.charset.StandardCharsets; |
weibit | cef0986 | 2014-07-11 17:05:16 -0700 | [diff] [blame] | 5 | import java.util.Objects; |
| 6 | |
Pavlin Radoslavov | d7b792e | 2014-08-01 02:47:47 -0700 | [diff] [blame] | 7 | import net.onrc.onos.core.util.Dpid; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 8 | import net.onrc.onos.core.util.OnosInstanceId; |
| 9 | |
| 10 | import static com.google.common.base.Preconditions.checkNotNull; |
weibit | cef0986 | 2014-07-11 17:05:16 -0700 | [diff] [blame] | 11 | |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 12 | /** |
| 13 | * Self-contained Topology event Object |
Ray Milkey | 269ffb9 | 2014-04-03 14:43:30 -0700 | [diff] [blame] | 14 | * <p/> |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 15 | * TODO: For now the topology event contains one of the following events: |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 16 | * Switch Mastership, Switch, Port, Link, Host. In the future it will contain |
Pavlin Radoslavov | 695f895 | 2014-07-23 16:57:01 -0700 | [diff] [blame] | 17 | * multiple events in a single transaction. |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 18 | * TODO: This class should become immutable after its internals and usage |
| 19 | * are finalized. |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 20 | */ |
Yuta HIGUCHI | 7c28ebb | 2014-08-19 00:29:30 -0700 | [diff] [blame] | 21 | public final class TopologyEvent implements TopologyBatchTarget { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 22 | private final Type eventType; |
| 23 | private final TopologyElement<?> event; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 24 | private final OnosInstanceId onosInstanceId; // The ONOS Instance ID |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 25 | |
| 26 | /** |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 27 | * The topology event type. |
| 28 | */ |
| 29 | public enum Type { |
| 30 | MASTERSHIP, |
| 31 | SWITCH, |
| 32 | PORT, |
| 33 | LINK, |
| 34 | HOST, |
| 35 | NOOP, // TODO: temporary type; should be removed |
| 36 | } |
| 37 | |
| 38 | /** |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 39 | * Default constructor for serializer. |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 40 | */ |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 41 | @Deprecated |
| 42 | protected TopologyEvent() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 43 | this.eventType = Type.NOOP; |
| 44 | this.event = null; |
| 45 | this.onosInstanceId = null; |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 46 | } |
| 47 | |
| 48 | /** |
Pavlin Radoslavov | 054cd59 | 2014-08-07 20:57:16 -0700 | [diff] [blame] | 49 | * Constructor for creating an empty (NO-OP) Topology Event. |
| 50 | * |
| 51 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
| 52 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 53 | public TopologyEvent(OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 54 | this.eventType = Type.NOOP; |
| 55 | this.event = null; |
Pavlin Radoslavov | 054cd59 | 2014-08-07 20:57:16 -0700 | [diff] [blame] | 56 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 57 | } |
| 58 | |
| 59 | /** |
Pavlin Radoslavov | 695f895 | 2014-07-23 16:57:01 -0700 | [diff] [blame] | 60 | * Constructor for given Switch Mastership event. |
| 61 | * |
Yuta HIGUCHI | d8fd2f5 | 2014-09-01 23:19:45 -0700 | [diff] [blame] | 62 | * @param mastershipData the Switch Mastership event to use. |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 63 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
Pavlin Radoslavov | 695f895 | 2014-07-23 16:57:01 -0700 | [diff] [blame] | 64 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 65 | public TopologyEvent(MastershipData mastershipData, |
| 66 | OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 67 | this.eventType = Type.MASTERSHIP; |
Yuta HIGUCHI | d8fd2f5 | 2014-09-01 23:19:45 -0700 | [diff] [blame] | 68 | this.event = checkNotNull(mastershipData); |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 69 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 70 | } |
| 71 | |
| 72 | /** |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 73 | * Constructor for given Switch event. |
| 74 | * |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 75 | * @param switchData the Switch event to use. |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 76 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
| 77 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 78 | public TopologyEvent(SwitchData switchData, |
| 79 | OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 80 | this.eventType = Type.SWITCH; |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 81 | this.event = checkNotNull(switchData); |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 82 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 83 | } |
| 84 | |
| 85 | /** |
| 86 | * Constructor for given Port event. |
| 87 | * |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 88 | * @param portData the Port event to use. |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 89 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
| 90 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 91 | public TopologyEvent(PortData portData, OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 92 | this.eventType = Type.PORT; |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 93 | this.event = checkNotNull(portData); |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 94 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 95 | } |
| 96 | |
| 97 | /** |
| 98 | * Constructor for given Link event. |
| 99 | * |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 100 | * @param linkData the Link event to use. |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 101 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
| 102 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 103 | public TopologyEvent(LinkData linkData, OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 104 | this.eventType = Type.LINK; |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 105 | this.event = checkNotNull(linkData); |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 106 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 107 | } |
| 108 | |
| 109 | /** |
| 110 | * Constructor for given Host event. |
| 111 | * |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 112 | * @param hostData the Host event to use. |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 113 | * @param onosInstanceId the ONOS Instance ID that originates the event. |
| 114 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 115 | public TopologyEvent(HostData hostData, OnosInstanceId onosInstanceId) { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 116 | this.eventType = Type.HOST; |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 117 | this.event = checkNotNull(hostData); |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 118 | this.onosInstanceId = checkNotNull(onosInstanceId); |
| 119 | } |
| 120 | |
| 121 | /** |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 122 | * Gets the Topology Event type. |
| 123 | * |
| 124 | * @return the Topology Event type. |
| 125 | */ |
Pavlin Radoslavov | 656fdde | 2014-09-02 17:37:46 -0700 | [diff] [blame^] | 126 | public TopologyEvent.Type getEventType() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 127 | return this.eventType; |
| 128 | } |
| 129 | |
| 130 | /** |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 131 | * Gets the Mastership event. |
| 132 | * |
| 133 | * @return the Mastership event. |
| 134 | */ |
Yuta HIGUCHI | d8fd2f5 | 2014-09-01 23:19:45 -0700 | [diff] [blame] | 135 | public MastershipData getMastershipData() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 136 | if (eventType != Type.MASTERSHIP) { |
| 137 | return null; |
| 138 | } |
Yuta HIGUCHI | d8fd2f5 | 2014-09-01 23:19:45 -0700 | [diff] [blame] | 139 | MastershipData mastershipData = (MastershipData) event; |
| 140 | return mastershipData; |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 141 | } |
| 142 | |
| 143 | /** |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 144 | * Gets the Switch event. |
| 145 | * |
| 146 | * @return the Switch event. |
| 147 | */ |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 148 | public SwitchData getSwitchData() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 149 | if (eventType != Type.SWITCH) { |
| 150 | return null; |
| 151 | } |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 152 | SwitchData switchData = (SwitchData) event; |
| 153 | return switchData; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 154 | } |
| 155 | |
| 156 | /** |
| 157 | * Gets the Port event. |
| 158 | * |
| 159 | * @return the Port event. |
| 160 | */ |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 161 | public PortData getPortData() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 162 | if (eventType != Type.PORT) { |
| 163 | return null; |
| 164 | } |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 165 | PortData portData = (PortData) event; |
| 166 | return portData; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 167 | } |
| 168 | |
| 169 | /** |
| 170 | * Gets the Link event. |
| 171 | * |
| 172 | * @return the Link event. |
| 173 | */ |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 174 | public LinkData getLinkData() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 175 | if (eventType != Type.LINK) { |
| 176 | return null; |
| 177 | } |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 178 | LinkData linkData = (LinkData) event; |
| 179 | return linkData; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 180 | } |
| 181 | |
| 182 | /** |
| 183 | * Gets the Host event. |
| 184 | * |
| 185 | * @return the Host event. |
| 186 | */ |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 187 | public HostData getHostData() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 188 | if (eventType != Type.HOST) { |
| 189 | return null; |
| 190 | } |
Yuta HIGUCHI | 93d35ea | 2014-08-31 23:26:13 -0700 | [diff] [blame] | 191 | HostData hostData = (HostData) event; |
| 192 | return hostData; |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 193 | } |
| 194 | |
| 195 | /** |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 196 | * Gets the ONOS Instance ID. |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 197 | * |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 198 | * @return the ONOS Instance ID. |
Pavlin Radoslavov | a5637c0 | 2014-07-30 15:55:11 -0700 | [diff] [blame] | 199 | */ |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 200 | public OnosInstanceId getOnosInstanceId() { |
| 201 | return onosInstanceId; |
Pavlin Radoslavov | 695f895 | 2014-07-23 16:57:01 -0700 | [diff] [blame] | 202 | } |
| 203 | |
| 204 | /** |
Pavlin Radoslavov | d7b792e | 2014-08-01 02:47:47 -0700 | [diff] [blame] | 205 | * Tests whether the event origin DPID equals the specified DPID. |
| 206 | * |
| 207 | * @param dpid the DPID to compare against. |
| 208 | * @return true if the event origin Dpid equals the specified DPID. |
| 209 | */ |
| 210 | public boolean equalsOriginDpid(Dpid dpid) { |
| 211 | return dpid.equals(getOriginDpid()); |
| 212 | } |
| 213 | |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 214 | public Dpid getOriginDpid() { |
| 215 | if (eventType == Type.NOOP) { |
| 216 | return null; |
| 217 | } |
| 218 | return event.getOriginDpid(); |
| 219 | } |
| 220 | |
Pavlin Radoslavov | d7b792e | 2014-08-01 02:47:47 -0700 | [diff] [blame] | 221 | /** |
Pavlin Radoslavov | ae7e848 | 2014-08-11 16:58:19 -0700 | [diff] [blame] | 222 | * Returns the config state of the topology element. |
| 223 | * |
| 224 | * @return the config state of the topology element. |
| 225 | */ |
| 226 | public ConfigState getConfigState() { |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 227 | if (eventType == Type.NOOP) { |
| 228 | return ConfigState.NOT_CONFIGURED; // Default: not configured |
Pavlin Radoslavov | ae7e848 | 2014-08-11 16:58:19 -0700 | [diff] [blame] | 229 | } |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 230 | return event.getConfigState(); |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 231 | } |
| 232 | |
| 233 | /** |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 234 | * Gets the Topology event ID as a byte array. |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 235 | * |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 236 | * @return the Topology event ID as a byte array. |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 237 | */ |
| 238 | public byte[] getID() { |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 239 | return getIDasByteBuffer().array(); |
| 240 | } |
| 241 | |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 242 | public ByteBuffer getIDasByteBuffer() { |
| 243 | ByteBuffer eventId = null; |
| 244 | |
| 245 | // |
| 246 | // Get the Event ID |
| 247 | // |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 248 | if (eventType == Type.NOOP) { |
| 249 | String id = "NO-OP"; |
| 250 | eventId = ByteBuffer.wrap(id.getBytes(StandardCharsets.UTF_8)); |
| 251 | } else { |
| 252 | eventId = event.getIDasByteBuffer(); |
Pavlin Radoslavov | 845ffdd | 2014-08-06 18:01:26 -0700 | [diff] [blame] | 253 | } |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 254 | |
| 255 | // |
| 256 | // Prepare the ONOS Instance ID. The '@' separator is needed to avoid |
| 257 | // potential key collisions. |
| 258 | // |
Pavlin Radoslavov | 845ffdd | 2014-08-06 18:01:26 -0700 | [diff] [blame] | 259 | byte[] onosId = |
| 260 | ("@" + onosInstanceId.toString()).getBytes(StandardCharsets.UTF_8); |
Pavlin Radoslavov | cac157d | 2014-07-31 13:54:08 -0700 | [diff] [blame] | 261 | |
| 262 | // Concatenate the IDs |
| 263 | ByteBuffer buf = |
| 264 | ByteBuffer.allocate(eventId.capacity() + onosId.length); |
| 265 | buf.put(eventId); |
| 266 | buf.put(onosId); |
| 267 | buf.flip(); |
| 268 | return buf; |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 269 | } |
Pavlin Radoslavov | 31f8510 | 2014-08-15 13:55:44 -0700 | [diff] [blame] | 270 | |
| 271 | @Override |
| 272 | public boolean equals(Object o) { |
| 273 | if (this == o) { |
| 274 | return true; |
| 275 | } |
| 276 | if (o == null || getClass() != o.getClass()) { |
| 277 | return false; |
| 278 | } |
| 279 | |
| 280 | TopologyEvent other = (TopologyEvent) o; |
| 281 | return Objects.equals(eventType, other.eventType) && |
| 282 | Objects.equals(event, other.event) && |
| 283 | Objects.equals(onosInstanceId, other.onosInstanceId); |
| 284 | } |
| 285 | |
| 286 | @Override |
| 287 | public int hashCode() { |
| 288 | return Objects.hash(eventType, event, onosInstanceId); |
| 289 | } |
| 290 | |
| 291 | @Override |
| 292 | public String toString() { |
| 293 | String eventStr = null; |
| 294 | |
| 295 | // |
| 296 | // Get the Event string |
| 297 | // |
| 298 | if (eventType == Type.NOOP) { |
| 299 | eventStr = "NO-OP"; |
| 300 | } else { |
| 301 | eventStr = event.toString(); |
| 302 | } |
| 303 | return "[TopologyEvent " + eventStr + " from " + |
| 304 | onosInstanceId.toString() + "]"; |
| 305 | } |
Pavlin Radoslavov | 45ec04b | 2014-02-14 23:29:33 -0800 | [diff] [blame] | 306 | } |