ConnectivityManager.NetworkCallback

Base class for NetworkRequest callbacks. Used for notifications about network changes. Should be extended by applications wanting notifications.

Summary

Public Constructors
	ConnectivityManager.NetworkCallback()

Public Constructors

ConnectivityManager.NetworkCallback()

Public Methods
void	onAvailable(Network network) Called when the framework connects and has declared new network ready for use.
void	onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities) Called when the network the framework connected to for this request changes capabilities but still satisfies the stated need.
void	onLinkPropertiesChanged(Network network, LinkProperties linkProperties) Called when the network the framework connected to for this request changes `LinkProperties`.
void	onLosing(Network network, int maxMsToLive) Called when the network is about to be disconnected.
void	onLost(Network network) Called when the framework has a hard loss of the network or when the graceful failure ends.

Public Methods

void

onAvailable(Network network)

Called when the framework connects and has declared new network ready for use.

void

onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities)

Called when the network the framework connected to for this request changes capabilities but still satisfies the stated need.

void

onLinkPropertiesChanged(Network network, LinkProperties linkProperties)

Called when the network the framework connected to for this request changes LinkProperties.

void

onLosing(Network network, int maxMsToLive)

Called when the network is about to be disconnected.

void

onLost(Network network)

Called when the framework has a hard loss of the network or when the graceful failure ends.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Methods

public void onAvailable (Network network)

Added in API level 21

Called when the framework connects and has declared new network ready for use. This callback may be called more than once if the Network that is satisfying the request changes.

Parameters

network	The `Network` of the satisfying network.

public void onCapabilitiesChanged (Network network, NetworkCapabilities networkCapabilities)

Added in API level 21

Called when the network the framework connected to for this request changes capabilities but still satisfies the stated need.

Parameters

network	The `Network` whose capabilities have changed.
networkCapabilities	The new `NetworkCapabilities` for this network.

public void onLinkPropertiesChanged (Network network, LinkProperties linkProperties)

Added in API level 21

Called when the network the framework connected to for this request changes LinkProperties.

Parameters

network	The `Network` whose link properties have changed.
linkProperties	The new `LinkProperties` for this network.

public void onLosing (Network network, int maxMsToLive)

Added in API level 21

Called when the network is about to be disconnected. Often paired with an onAvailable(Network) call with the new replacement network for graceful handover. This may not be called if we have a hard loss (loss without warning). This may be followed by either a onLost(Network) call or a onAvailable(Network) call for this network depending on whether we lose or regain it.

Parameters

network	The `Network` that is about to be disconnected.
maxMsToLive	The time in ms the framework will attempt to keep the network connected. Note that the network may suffer a hard loss at any time.

public void onLost (Network network)

Added in API level 21

Called when the framework has a hard loss of the network or when the graceful failure ends.

Parameters

network	The `Network` lost.

Results

Interfaces

Classes

Enums

Exceptions

Class Overview

Summary

Public Constructors

public ConnectivityManager.NetworkCallback ()

Public Methods

public void onAvailable (Network network)

Parameters

public void onCapabilitiesChanged (Network network, NetworkCapabilities networkCapabilities)

Parameters

public void onLinkPropertiesChanged (Network network, LinkProperties linkProperties)

Parameters

public void onLosing (Network network, int maxMsToLive)

Parameters

public void onLost (Network network)

Parameters

java.lang.Object
↳	android.net.ConnectivityManager.NetworkCallback