鸿蒙网络编程系列19-获取网络连接信息并选择一种绑定到应用示例

1. 网络类型简介

移动设备一般都具备移动网络和无线WIFI的连接能力，有些还可以接入有线以太网，这些网络可以根据需要随时切换。鸿蒙APP可以自动适应上述的网络，一般来说，会优先使用WIFI或者有线以太网，移动网络因为要收费，不会首选使用。但是在某些特殊情形下，可能要求必须使用某一种网络，比如必须使用蜂窝网络，这时候就需要显示的配置一下，指定app使用该网络类型。

2. Web组件及控制器常用方法

网络连接相关能力位于connection模块下，使用如下的方式导入：

import connection from '@ohos.net.connection'

connection模块包括了众多的操作方法，就本文而言，重点需要掌握的是如下四个：

1）getAllNets(): Promise<Array<NetHandle>>

获取所有处于连接状态的网络列表，使用Promise方式作为异步方法。

2）getConnectionProperties(netHandle: NetHandle): Promise<ConnectionProperties>

获取netHandle对应的网络的连接信息，使用Promise方式作为异步方法。

3）getNetCapabilities(netHandle: NetHandle): Promise<NetCapabilities>

获取netHandle对应的网络的能力信息，使用Promise方式作为异步方法。

4）setAppNet(netHandle: NetHandle): Promise<void>;

绑定App到指定网络，绑定后的App只能通过指定网络访问外网，使用Promise方式作为异步方法。

3. 获取网络连接信息并选择一种绑定到应用

本示例会列出所有激活中的网络，然后可以选择其中一种绑定到当前APP，最后可以通过访问指定的网页验证是否绑定成功，示例运行后的初始界面如下所示：

下面详细介绍创建该应用的步骤。

步骤1：创建Empty Ability项目。

步骤2：在module.json5配置文件加上对权限的声明：

"requestPermissions": [{"name": "ohos.permission.GET_NETWORK_INFO"},{"name": "ohos.permission.INTERNET"}]

这里添加了获取WIFI信息以及访问互联网的权限。

步骤3：在Index.ets文件里添加如下的代码：

import connection from '@ohos.net.connection';
import web_webview from '@ohos.web.webview'

@Entry
@Component
struct Index {//连接、通讯历史记录@State msgHistory: string = ''scroller: Scroller = new Scroller()//网络类型列表@State netShowArray: Array<SelectOption> = new Array<SelectOption>()//网络句柄数组netHandleArray: Array<connection.NetHandle> = new Array<connection.NetHandle>()//选中的网络序号selectNetIndx: number = 0//要测试的网址@State webUrl: string = "http://192.168.100.100:8080/index"//显示网页的控制器controller: web_webview.WebviewController = new web_webview.WebviewController()
build() {Row() {Column() {Text("绑定应用使用的网络").fontSize(14).fontWeight(FontWeight.Bold).width('100%').textAlign(TextAlign.Center).padding(10)
Flex({ justifyContent: FlexAlign.SpaceBetween, alignItems: ItemAlign.Center }) {Button("查看网络信息").width(120).fontSize(14).flexGrow(0).onClick(() => {this.ShowNetInfo()})
Select(this.netShowArray).width(100).value("选择网络").flexGrow(1).onSelect((index, value) => {this.selectNetIndx = index})
Button("绑定").width(120).fontSize(14).flexGrow(0).onClick(() => {connection.setAppNet(this.netHandleArray[this.selectNetIndx]).then(() => {this.msgHistory += "绑定成功\r\n"}).catch((error) => {this.msgHistory += "绑定出错" + error.message + "\r\n"})})}.width('100%').padding(10)
Scroll(this.scroller) {Text(this.msgHistory).textAlign(TextAlign.Start).fontSize(10).padding(10).width('100%').backgroundColor(0xeeeeee)}.align(Alignment.Top).backgroundColor(0xeeeeee).height(200).flexGrow(1).scrollable(ScrollDirection.Vertical).scrollBar(BarState.On).scrollBarWidth(20)
Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {Text("网址：").fontSize(14).width(50).flexGrow(0)
TextInput({ text: this.webUrl }).onChange((value) => {this.webUrl = value}).width(110).fontSize(11).flexGrow(1)
Button("加载").onClick(() => {this.controller.loadUrl(this.webUrl);}).width(60).fontSize(14).flexGrow(0)}.width('100%').padding(5)
Web({ src: this.webUrl, controller: this.controller }).padding(10).width('100%').backgroundColor(0xeeeeee).height(200).flexGrow(1)}.width('100%').justifyContent(FlexAlign.Start).height('100%')}.height('100%')}
showConnectionPropInfo(connProp: connection.ConnectionProperties) {this.msgHistory += `网卡名称:${connProp.interfaceName}\r\n`for (let i = 0; i < connProp.dnses.length; i++) {this.msgHistory += `DNS${i}:${connProp.dnses[i].address}\r\n`}
for (let i = 0; i < connProp.linkAddresses.length; i++) {this.msgHistory += `IP${i}:${connProp.linkAddresses[i].address.address}\r\n`}
this.msgHistory += `mtu:${connProp.mtu}\r\n`}
showNetCapInfo(connCap: connection.NetCapabilities) {
let netType = ""if (connCap.bearerTypes[0].valueOf() == 0) {netType = "蜂窝网络"} else if (connCap.bearerTypes[0].valueOf() == 1) {netType = "Wi-Fi网络"}else if (connCap.bearerTypes[0].valueOf() == 3) {netType = "以太网网络"}//添加网络类型到下拉列表this.netShowArray.push({ value: netType })this.msgHistory += `网络类型:${netType}\r\n`this.msgHistory += `网络能力（kbps）:${connCap.linkUpBandwidthKbps}/${connCap.linkDownBandwidthKbps}\r\n`}
//显示网络信息async ShowNetInfo() {this.netHandleArray = await connection.getAllNets();this.msgHistory += `激活网络数量:${this.netHandleArray.length}\r\n\r\n`
//清空下拉列表元素this.netShowArray.splice(0, this.netShowArray.length);
for (let i = 0; i < this.netHandleArray.length; i++) {let connProp = await connection.getConnectionProperties(this.netHandleArray[i])this.showConnectionPropInfo(connProp)
let connCap = await connection.getNetCapabilities(this.netHandleArray[i])this.showNetCapInfo(connCap)this.msgHistory += "\r\n"}}
}

步骤4：编译运行，最好使用真机。

步骤5：单击“查看网络信息”按钮，列出当前网络信息，截图如下所示：