程序包 ohos.net

类 NetStatusCallback

java.lang.Object

ohos.net.NetStatusCallback

public class NetStatusCallback
extends Object

Provides interfaces to listen for status changes of data networks.

You can register a child class that inherits this class to listen for status changes of data networks.

从以下版本开始:

1

字段概要

字段

限定符和类型	字段	说明
NetSpecifier	networkRequest	specifier network param

构造器概要

构造器

构造器	说明
NetStatusCallback()	Constructor for this class

方法概要

限定符和类型	方法	说明
void	onAvailable(NetHandle handle)	A callback method used to notify applications of an available data network.
void	onBlockedStatusChanged(NetHandle handle, boolean blocked)	A callback method used to notify applications of network congestion status changes.
void	onCapabilitiesChanged(NetHandle handle, NetCapabilities networkCapabilities)	A callback method used to notify applications of network capability changes.
void	onConnectionPropertiesChanged(NetHandle handle, ConnectionProperties connectionProperties)	A callback method used to notify applications of changes in network link parameters.
void	onLosing(NetHandle handle, long maxMsToLive)	A callback method used to notify applications when a network disconnection is ongoing.
void	onLost(NetHandle handle)	Notifies applications of a serious network interruption or a normal network disconnection.
void	onUnavailable()	Notifies applications of a failure to set up a network connection if no connection is set up before the NetManager.setupSpecificNet(ohos.net.NetSpecifier, ohos.net.NetStatusCallback) request times out.

从类继承的方法 java.lang.Object

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

字段详细资料

networkRequest

public NetSpecifier networkRequest

specifier network param

从以下版本开始:

1

构造器详细资料

NetStatusCallback

public NetStatusCallback()

Constructor for this class

方法详细资料

onAvailable

public void onAvailable(NetHandle handle)

A callback method used to notify applications of an available data network.

参数:

handle - Indicates the available NetHandle object.

从以下版本开始:

1

onBlockedStatusChanged

public void onBlockedStatusChanged(NetHandle handle,
                                   boolean blocked)

A callback method used to notify applications of network congestion status changes.

参数:

handle - Indicates the NetHandle object whose congestion status has changed.

blocked - Specifies whether the network is congested. The value true indicates that the network is congested, and the value false indicates that the network is not congested.

从以下版本开始:

1

onLosing

public void onLosing(NetHandle handle,
                     long maxMsToLive)

A callback method used to notify applications when a network disconnection is ongoing.

参数:

handle - Indicates the NetHandle object that is undergoing a disconnection.

maxMsToLive - Indicates the time remaining before the network becomes unavailable.

从以下版本开始:

1

onLost

public void onLost(NetHandle handle)

Notifies applications of a serious network interruption or a normal network disconnection.

参数:

handle - Indicates the NetHandle object that has become unavailable.

从以下版本开始:

1

onUnavailable

public void onUnavailable()

Notifies applications of a failure to set up a network connection if no connection is set up before the NetManager.setupSpecificNet(ohos.net.NetSpecifier, ohos.net.NetStatusCallback) request times out.

从以下版本开始:

1

onCapabilitiesChanged

public void onCapabilitiesChanged(NetHandle handle,
                                  NetCapabilities networkCapabilities)

A callback method used to notify applications of network capability changes.

参数:

handle - Indicates the NetHandle object whose capability has changed.

networkCapabilities - Indicates the new NetCapabilities object.

从以下版本开始:

1

onConnectionPropertiesChanged

public void onConnectionPropertiesChanged(NetHandle handle,
                                          ConnectionProperties connectionProperties)

A callback method used to notify applications of changes in network link parameters.

参数:

handle - Indicates the NetHandle object whose link parameters have changed.

connectionProperties - Indicates the new ConnectionProperties object.

从以下版本开始:

1