ej.net

Class PollerConnectivityManager

java.lang.Object

android.net.ConnectivityManager

ej.net.PollerConnectivityManager

Direct Known Subclasses:

HttpPollerConnectivityManager

public class PollerConnectivityManager
extends ConnectivityManager

Basic full java implementation. Consider the network is connected when there is at least one NetworkInterface which address is not 0.0.0.0.

Nested Class Summary

Nested classes/interfaces inherited from class android.net.ConnectivityManager

ConnectivityManager.NetworkCallback

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	BASE_PROPERTY Base property name.
protected static NetworkCapabilities	INTERNET_CONNECTED Capability with internet access.
protected static NetworkCapabilities	INTERNET_UNCONNECTED Capability with internet access.

Constructor Summary

Constructors

Constructor and Description
PollerConnectivityManager() Instantiates a PollerConnectivityManager with default periods and delay and a new timer.
PollerConnectivityManager(Timer timer) Instantiates a PollerConnectivityManager with default value.
PollerConnectivityManager(Timer timer, long delay, long period) Instantiates a PollerConnectivityManager with the same period when up or not.
PollerConnectivityManager(Timer timer, long delay, long periodWhenAvailable, long periodWhenLost) Instantiates a PollerConnectivityManager with the different periods when available or not.
PollerConnectivityManager(Timer timer, long delay, long periodWhenAvaialble, long periodWhenLost, long periodWhenInternet) Instantiates a PollerConnectivityManager with the same period when connected or not.

Method Summary

Modifier and Type	Method and Description
void	cancel() Cancels the associated timer.
protected NetworkCapabilities	getCapabilities(InetAddress connectedAddress) Gets the capabilities of a network.
protected NetworkInterface	getNetworkInterface(String name) Isolate for testing.
protected Enumeration<NetworkInterface>	getNetworkInterfaces() Isolate for testing.
protected void	log(int msg) Logs a message.
protected void	log(int msg, Throwable t) Logs a message and a throwable.
void	startPolling(long delay) Starts the polling function.
void	stopPolling() Stops the polling function.

Methods inherited from class android.net.ConnectivityManager

doNotifyAvailabilityChange, doNotifyCapabilitiesChange, getActiveNetwork, getActiveNetworkInfo, getAllNetworks, getNetworkCapabilities, getNetworkInfo, notifyNetworkCallbacks, notifyNetworkCallbacks, registerDefaultNetworkCallback, registerNetworkCallback, setActiveNetwork, setAvailable, unregisterNetworkCallback

Methods inherited from class java.lang.Object

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

Field Detail

BASE_PROPERTY

protected static final String BASE_PROPERTY

Base property name.

See Also:

Constant Field Values

INTERNET_CONNECTED

protected static final NetworkCapabilities INTERNET_CONNECTED

Capability with internet access.

INTERNET_UNCONNECTED

protected static final NetworkCapabilities INTERNET_UNCONNECTED

Capability with internet access.

Constructor Detail

PollerConnectivityManager

public PollerConnectivityManager()

Instantiates a PollerConnectivityManager with default periods and delay and a new timer.

PollerConnectivityManager

public PollerConnectivityManager(Timer timer)

Instantiates a PollerConnectivityManager with default value.

Parameters:

timer - the timer to use, cannot be null.

PollerConnectivityManager

public PollerConnectivityManager(Timer timer,
                                 long delay,
                                 long period)

Instantiates a PollerConnectivityManager with the same period when up or not.

Parameters:

timer - the timer to use, cannot be null.

delay - the delay before the start.

period - the period for the polling.

PollerConnectivityManager

public PollerConnectivityManager(Timer timer,
                                 long delay,
                                 long periodWhenAvailable,
                                 long periodWhenLost)

Instantiates a PollerConnectivityManager with the different periods when available or not. The same period is used wth or without internet access when availble.

Parameters:

timer - the timer to use, cannot be null.

delay - the delay before the start.

periodWhenAvailable - the period for the polling when at least one interface is available.

periodWhenLost - the period for the polling when all the interface are down.

PollerConnectivityManager

public PollerConnectivityManager(Timer timer,
                                 long delay,
                                 long periodWhenAvaialble,
                                 long periodWhenLost,
                                 long periodWhenInternet)

Instantiates a PollerConnectivityManager with the same period when connected or not.

Parameters:

timer - the timer to use, cannot be null.

delay - the delay before the start.

periodWhenAvaialble - the period for the polling when at least one interface is available.

periodWhenLost - the period for the polling when all the interface are down.

periodWhenInternet - the period for the polling when there is internet access.

Method Detail

cancel

public void cancel()

Cancels the associated timer.

getCapabilities

protected NetworkCapabilities getCapabilities(InetAddress connectedAddress)

Gets the capabilities of a network.

Parameters:

connectedAddress - the address to get the capabilities from, cannot be null.

Returns:

the capabilities of the address.

getNetworkInterface

@Nullable
protected NetworkInterface getNetworkInterface(String name)
                                                  throws SocketException

Isolate for testing.

Parameters:

name - the name of the interface, cannot be null.

Returns:

the interface with a name.

Throws:

SocketException - if an I/O exception occurs.

getNetworkInterfaces

@Nullable
protected Enumeration<NetworkInterface> getNetworkInterfaces()
                                                                throws SocketException

Isolate for testing.

Returns:

all the interface available.

Throws:

SocketException - if an I/O exception occurs.

log

protected void log(int msg)

Logs a message.

Parameters:

msg - the message to log.

log

protected void log(int msg,
                   Throwable t)

Logs a message and a throwable.

Parameters:

msg - the message to log.

t - a throwable to print, cannot be null.

startPolling

public void startPolling(long delay)

Starts the polling function.

Parameters:

delay - the delay before starting.

stopPolling

public void stopPolling()

Stops the polling function.