Committed by
Gerrit Code Review
Disambiguation of the difference between reachability and availability.
Change-Id: Ie4c7468453d64a48a0bf712737f927f7086a5bc5
Showing
2 changed files
with
6 additions
and
0 deletions
| ... | @@ -50,6 +50,8 @@ public interface DeviceProvider extends Provider { | ... | @@ -50,6 +50,8 @@ public interface DeviceProvider extends Provider { |
| 50 | 50 | ||
| 51 | /** | 51 | /** |
| 52 | * Checks the reachability (connectivity) of a device from this provider. | 52 | * Checks the reachability (connectivity) of a device from this provider. |
| 53 | + * Reachability, unlike availability, denotes whether THIS particular node | ||
| 54 | + * can send messages and receive replies from the specified device. | ||
| 53 | * | 55 | * |
| 54 | * @param deviceId device identifier | 56 | * @param deviceId device identifier |
| 55 | * @return true if reachable, false otherwise | 57 | * @return true if reachable, false otherwise | ... | ... |
| ... | @@ -123,6 +123,10 @@ public interface DeviceService | ... | @@ -123,6 +123,10 @@ public interface DeviceService |
| 123 | 123 | ||
| 124 | /** | 124 | /** |
| 125 | * Indicates whether or not the device is presently online and available. | 125 | * Indicates whether or not the device is presently online and available. |
| 126 | + * Availability, unlike reachability, denotes whether ANY node in the | ||
| 127 | + * cluster can discover that this device is in an operational state, | ||
| 128 | + * this does not necessarily mean that there exists a node that can | ||
| 129 | + * control this device. | ||
| 126 | * | 130 | * |
| 127 | * @param deviceId device identifier | 131 | * @param deviceId device identifier |
| 128 | * @return true if the device is available | 132 | * @return true if the device is available | ... | ... |
-
Please register or login to post a comment