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