|
NASA World Wind | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectgov.nasa.worldwind.avlist.AVListImpl
gov.nasa.worldwind.util.BasicNetworkStatus
public class BasicNetworkStatus
Provides tracking of per-host network availability. Host computers that fail network requests can be logged to this class' tracking list. When a host has been logged a specified number of times, it is marked as unreachable. Users can query instances of this class to determine whether a host has been marked as unreachable.
Users are expected to invoke this class'logUnavailableHost(java.net.URL) method when an attempt to contact
a host fails. Each invocation increments the failure count by one. When the count exceeds the attempt limit, the host
is marked as unreachable. When attempts to contact the host are successful, users should invoke this class'
logAvailableHost(java.net.URL) method to clear its status.
A host may become reachable at a time subsequent to its being logged. To detect this, this class will mark a host as
not unreachable after a specifiable interval of time. If the host is once more logged as unavailable, its entry will
return to the unavailable state. This cycle continues indefinitely.
Methods are also provided to determine whether the public network can be reached and whether the NASA World Wind
servers cab be reached.
| Field Summary |
|---|
| Fields inherited from class gov.nasa.worldwind.avlist.AVListImpl |
|---|
changeSupport |
| Constructor Summary | |
|---|---|
BasicNetworkStatus()
|
|
| Method Summary | |
|---|---|
int |
getAttemptLimit()
Returns the number of times a host must be logged as unavailable before it is marked unavailable in this class. |
long |
getTryAgainInterval()
Returns the length of time to wait until a host is marked as not unreachable subsequent to its being marked unreachable. |
boolean |
isHostUnavailable(URL url)
Indicates whether the host has been marked as unavailable. |
boolean |
isNetworkUnavailable()
Indicates whether a public network can be reached or has been reached in the previous five seconds. |
boolean |
isNetworkUnavailable(long checkInterval)
Indicates whether a public network can be reached or has been reached in a specified previous amount of time. |
boolean |
isOfflineMode()
Indicates whether World Wind will attempt to connect to the network to retrieve data or for other reasons. |
boolean |
isWorlWindServerUnavailable()
Indicates whether the NASA World Wind servers can be reached. |
void |
logAvailableHost(URL url)
Log a host as available. |
void |
logUnavailableHost(URL url)
Log a host as unavailable. |
void |
setAttemptLimit(int limit)
Set the number of times a host must be logged as unavailable before it is marked unavailable in this class. |
void |
setOfflineMode(boolean offlineMode)
Indicate whether World Wind should attempt to connect to the network to retrieve data or for other reasons. |
void |
setTryAgainInterval(long interval)
Set the length of time to wait until a host is marked as not unreachable subsequent to its being marked unreachable. |
| Methods inherited from class gov.nasa.worldwind.avlist.AVListImpl |
|---|
addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getDoubleValue, getDoubleValue, getEntries, getIntegerValue, getIntegerValue, getLongValue, getLongValue, getStringValue, getStringValue, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface gov.nasa.worldwind.avlist.AVList |
|---|
addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getEntries, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues |
| Constructor Detail |
|---|
public BasicNetworkStatus()
| Method Detail |
|---|
public int getAttemptLimit()
getAttemptLimit in interface NetworkStatuspublic long getTryAgainInterval()
getTryAgainInterval in interface NetworkStatuspublic boolean isHostUnavailable(URL url)
isHostUnavailable in interface NetworkStatusurl - a url containing the host to check for availability.
public boolean isNetworkUnavailable()
isNetworkUnavailable in interface NetworkStatuspublic boolean isNetworkUnavailable(long checkInterval)
checkInterval - the number of milliseconds in the past used to determine whether the server was avaialble
recently.
public boolean isOfflineMode()
isOfflineMode in interface NetworkStatustrue if World Wind is in off-line mode, false if not.public boolean isWorlWindServerUnavailable()
isWorlWindServerUnavailable in interface NetworkStatuspublic void logAvailableHost(URL url)
logAvailableHost in interface NetworkStatusurl - a url containing the host to mark as available.public void logUnavailableHost(URL url)
logUnavailableHost in interface NetworkStatusurl - a url containing the host to mark as unavailable.public void setAttemptLimit(int limit)
setAttemptLimit in interface NetworkStatuslimit - the number of log-unavailability invocations necessary to consider the host unreachable.
IllegalArgumentException - if the limit is less than 1.public void setOfflineMode(boolean offlineMode)
false, indicating that the network should be used.
setOfflineMode in interface NetworkStatusofflineMode - true if World Wind should use the network, false otherwisepublic void setTryAgainInterval(long interval)
setTryAgainInterval in interface NetworkStatusinterval - The length of time, in milliseconds, to wait to unmark a host as unreachable.
IllegalArgumentException - if the interval is less than 0.
|
NASA World Wind | ||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||