API之NetworkInfo解释

java.lang.Object
↳ android.net.NetworkInfo

---

• 类概述
  描述一个网络接口的状态。
  通过ConnectivityManager对象的getActiveNetworkInfo()获取实例。

---

• 内部类

枚举	NetworkInfo.DetailedState	网络连接的细粒度状态
枚举	NetworkInfo.State	网络连接的粗粒度状态

---

• 公共方法

NetworkInfo.DetailedState	getDetailedState()
	说明：报告当前的细粒度状态的网络。
	返回细粒度状态。
String	getExtraInfo()
	说明：报告有关网络状态的额外信息。
	返回状态的额外信息，如果网络不可用那么返回null。
String	getReason()
	说明：在有可用的网络的情况下，报告创建网络连接失败的原因。
	返回创建网络连接失败的原因，如果网络不可用那么返回null。
NetworkInfo.State	getState()
	说明：报告当前的粗粒度状态的网络。
	返回粗粒度状态。
int	getSubtype()
	返回一个描述网络子类的网络类型的特定整数。
String	getSubtypeName()
	返回一个描述网络子类的网络类型的名称。
String	getType()
	说明：报告网络类型，在NetworkInfo父类中涉及到。
	返回TYPE_MOBILE, TYPE_WIFI, TYPE_WIMAX, TYPE_ETHERNET, TYPE_BLUETOOTH, 或其他由ConnectivityManager定义的网络类型中的其中一个
String	getTypeName()
	返回一个描述网络类型的名称，例如”WIFI”或”移动”。
boolean	isAvailable()
	说明：指示是否存在网络连接。当一个持续的或者半持续的条件组织了网络连接时，网络是不可用的，例子包括：设备超出了网络覆盖范围；设备的移动数据被禁用；设备的无线电被关闭，即启动了飞行模式。
	如果网络可用返回true，反之返回false。
boolean	isConnected()
	说明：指示是否存在网络连接，并可能建立连接和传递数据。
	在试图执行传递数据之前总是会调用该方法。
	如果网络连接存在，那么返回true，否则返回false。
boolean	isConnectedOrConnecting()
	说明：指示是否存在或正在建立过程中的网络连接。需要做任何有关网络以外的读或写数据时该方法对于应用程序来说比较有利。对于后者，可调用isConnected()来代替，它能保证网络完全可用。
	如果存在或正在建立过程中的网络连接，那么返回true，否则返回false。
boolean	isFailover()
	说明：指示是否由ConnectivityManager从另一个断开的网络连接到当前网络。
	如果ConnectivityManager网络切换成功，那么返回true，否则返回false。
boolean	isRoaming()
	说明：指示设备是否正在这个网络上漫游。当返回true，则表明使用这个网络上的数据可能会产生额外的成本。
	如果漫游有效，那么返回true，否则返回false。
boolean	toString()
	说明：返回一个包含该对象的简明、可读的描述的字符串。鼓励子类重写此方法，并提供一个实现，该方法考虑到对象的类型和数据。默认实现相当于下面的表达式：
	getClass().getName() + ‘@’ + Integer.toHexString(hashCode())