buzz.getcoco.iot

Class ConnectivityStateManager

java.lang.Object

buzz.getcoco.iot.ConnectivityStateManager

All Implemented Interfaces:

CallbacksInterface, DefaultCallbacksInterface

public final class ConnectivityStateManager
extends java.lang.Object
implements DefaultCallbacksInterface

ConnectivityStateManager maintains states of networks and notifies Listener in case it changes. It is reliant on FiniteStateMachine to handle events.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConnectivityStateManager.CacheState Class responsible to cache the list of connected networks.
static interface	ConnectivityStateManager.ConnectivityStateChangeListener Listener which is triggered by callbacks.
static class	ConnectivityStateManager.State An enum denoting possible values of state for network object.

Method Summary

Modifier and Type	Method and Description
ConnectivityStateManager.CacheState	cacheStates() This function is responsible for caching of networks that are in connected state.
static boolean	connect(Network network)
void	connectStatusCallback(Network network)
static boolean	disconnect(Network network)
static ConnectivityStateManager	getInstance() This function calls overloaded getInstance to retrieve the instance of ConnectivityStateManager with a null listener.
static ConnectivityStateManager	getInstance(ConnectivityStateManager.ConnectivityStateChangeListener listener) This overloaded function fetches instance of this class with assigned listener param.
java.lang.Exception	getRecentException()
static ConnectivityStateManager.State	getState(Network network) This method fetches state of Network param sent.
void	networkDataCallback(Network network)
void	nodeConnectionStatusCallback(Network network, long nodeId, NodeType nodeType, boolean isOnline)
void	restoreToCachedState()
void	restoreToCachedState(ConnectivityStateManager.CacheState cacheState) This function is responsible to restore the connection with the cached networks by reconnecting if needed.
void	setConnectingTimeout(long connectingDelay)
void	setLocal2Timeout(long localDelay2)
void	setLocal3Timeout(long localDelay3)
void	setLocalTimeout(long localDelay)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface buzz.getcoco.iot.DefaultCallbacksInterface

advertiseResourceCallback, commandStatusCallback, contentInfoCallback, deviceInfoCallback, deviceManagementStatusCallback, errorCallback, infoRequestCallback, infoRequestStatusCallback, infoResponseCallback, infoResponseStatusCallback, leaveNetworkStatusCallback, messageCallback, networkListCallback, networkManagementCommandCallback, networkMetadataCallback, receiveDataCallback, resourceAttributeCallback, resourceCallback, resourceCapabilityCallback, resourceExcludedCallback, resourceIncludedCallback, ruleDeletedCallback, ruleInfoCallback, sceneDeletedCallback, sceneInfoCallback, tunnelStatusCallback, zoneDeletedCallback, zoneInfoCallback

Method Detail

getInstance

public static ConnectivityStateManager getInstance()

This function calls overloaded getInstance to retrieve the instance of ConnectivityStateManager with a null listener.

Returns:

Instance of ConnectivityStateManager.

See Also:

getInstance(ConnectivityStateChangeListener)

getInstance

public static ConnectivityStateManager getInstance(ConnectivityStateManager.ConnectivityStateChangeListener listener)

This overloaded function fetches instance of this class with assigned listener param. NOTE: a weak-reference will be used to store the listener. So, the reference must be maintained by the caller.

Parameters:

listener - listens for network state change ConnectivityStateManager.ConnectivityStateChangeListener

Returns:

Instance of ConnectivityStateManager.

cacheStates

public ConnectivityStateManager.CacheState cacheStates()

This function is responsible for caching of networks that are in connected state.

Returns:

CacheState object with list of connected networks.

setConnectingTimeout

public void setConnectingTimeout(long connectingDelay)

setLocalTimeout

public void setLocalTimeout(long localDelay)

setLocal2Timeout

public void setLocal2Timeout(long localDelay2)

setLocal3Timeout

public void setLocal3Timeout(long localDelay3)

getRecentException

public java.lang.Exception getRecentException()

restoreToCachedState

public void restoreToCachedState()

restoreToCachedState

public void restoreToCachedState(ConnectivityStateManager.CacheState cacheState)

This function is responsible to restore the connection with the cached networks by reconnecting if needed.

Parameters:

cacheState - used for caching networks in cacheStates()

disconnect

public static boolean disconnect(Network network)

connect

public static boolean connect(Network network)

connectStatusCallback

public void connectStatusCallback(Network network)

Specified by:

connectStatusCallback in interface CallbacksInterface

Specified by:

connectStatusCallback in interface DefaultCallbacksInterface

nodeConnectionStatusCallback

public void nodeConnectionStatusCallback(Network network,
                                         long nodeId,
                                         NodeType nodeType,
                                         boolean isOnline)

Specified by:

nodeConnectionStatusCallback in interface CallbacksInterface

Specified by:

nodeConnectionStatusCallback in interface DefaultCallbacksInterface

networkDataCallback

public void networkDataCallback(Network network)

Specified by:

networkDataCallback in interface CallbacksInterface

Specified by:

networkDataCallback in interface DefaultCallbacksInterface

getState

public static ConnectivityStateManager.State getState(Network network)

This method fetches state of Network param sent.

Parameters:

network - Network object in interest.

Returns:

state from the ConnectivityStateManager.State enum.