tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 1 | package org.onlab.onos.net.device; |
| 2 | |
tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 3 | import org.onlab.onos.net.Device; |
tom | c1a38d3 | 2014-08-25 23:01:32 -0700 | [diff] [blame] | 4 | import org.onlab.onos.net.provider.Provider; |
tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 5 | |
| 6 | /** |
| 7 | * Abstraction of a device information provider. |
| 8 | */ |
| 9 | public interface DeviceProvider extends Provider { |
tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 10 | |
| 11 | // TODO: consider how dirty the triggerProbe gets; if it costs too much, let's drop it |
| 12 | |
| 13 | /** |
| 14 | * Triggers an asynchronous probe of the specified device, intended to |
| 15 | * determine whether the host is present or not. An indirect result of this |
| 16 | * should be invocation of |
tom | e06f855 | 2014-08-26 16:58:42 -0700 | [diff] [blame] | 17 | * {@link org.onlab.onos.net.device.DeviceProviderService#deviceConnected} )} or |
| 18 | * {@link org.onlab.onos.net.device.DeviceProviderService#deviceDisconnected} |
tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 19 | * at some later point in time. |
| 20 | * |
| 21 | * @param device device to be probed |
| 22 | */ |
| 23 | void triggerProbe(Device device); |
| 24 | |
| 25 | /** |
| 26 | * Notifies the provider of a mastership role change for the specified |
| 27 | * device as decided by the core. |
| 28 | * |
| 29 | * @param device affected device |
| 30 | * @param newRole newly determined mastership role |
| 31 | */ |
Madan Jampani | 195af6e | 2014-10-09 15:01:17 -0700 | [diff] [blame] | 32 | void roleChanged(Device device, DeviceMastershipRole newRole); |
tom | e33cc1a | 2014-08-25 21:59:41 -0700 | [diff] [blame] | 33 | |
tom | 0eb04ca | 2014-08-25 14:34:51 -0700 | [diff] [blame] | 34 | } |