網(wǎng)絡連接管理

導入模塊

import connection from '@ohos.net.connection'

connection.createNetConnection

createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection

返回一個NetConnection對象，netSpecifier指定關注的網(wǎng)絡的各項特征，timeout是超時時間(單位是毫秒)，netSpecifier是timeout的必要條件，兩者都沒有則表示關注默認網(wǎng)絡。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

示例：

// 關注默認網(wǎng)絡
let netConnection = connection.createNetConnection()

// 關注蜂窩網(wǎng)絡
let netConnectionCellular = connection.createNetConnection({
    netCapabilities: {
        bearerTypes: [connection.NetBearType.BEARER_CELLULAR]
    }
})

connection.getDefaultNet

getDefaultNet(callback: AsyncCallback<NetHandle>): void

獲取默認激活的數(shù)據(jù)網(wǎng)絡，使用callback方式作為異步方法。可以使用getNetCapabilities去獲取網(wǎng)絡的類型、擁有的能力等信息。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet(function (error, data) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(data))
})

connection.getDefaultNet

getDefaultNet(): Promise<NetHandle>

獲取默認激活的數(shù)據(jù)網(wǎng)絡，使用Promise方式作為異步方法。可以使用getNetCapabilities去獲取網(wǎng)絡的類型、擁有的能力等信息。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (data) {
    console.log(JSON.stringify(data))
})

connection.getDefaultNetSync9+

getDefaultNetSync(): NetHandle

使用同步方法獲取默認激活的數(shù)據(jù)網(wǎng)絡?？梢允褂?a rel="external nofollow" target="_blank" >getNetCapabilities去獲取網(wǎng)絡的類型、擁有的能力等信息。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

let netHandle = connection.getDefaultNetSync();

connection.getAppNet9+

getAppNet(callback: AsyncCallback<NetHandle>): void

獲取App綁定的網(wǎng)絡信息，使用callback方式作為異步方法。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getAppNet(function(error, data) {
   console.log(JSON.stringify(error))
   console.log(JSON.stringify(data))
})

connection.getAppNet9+

getAppNet(): Promise<NetHandle>;

獲取App綁定的網(wǎng)絡信息，使用Promise方式作為異步方法。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

connection.getAppNet().then((data) => {
   console.info(JSON.stringify(data));
}).catch(error => {
   console.info(JSON.stringify(error));
})

connection.SetAppNet9+

setAppNet(netHandle: NetHandle, callback: AsyncCallback<void>): void

綁定App到指定網(wǎng)絡，綁定后的App只能通過指定網(wǎng)絡訪問外網(wǎng)，使用callback方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet(function (error, netHandle) {
   connection.setAppNet(netHandle, (error, data) => {
       console.log(JSON.stringify(error))
       console.log(JSON.stringify(data))
   });
})

connection.SetAppNet9+

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

綁定App到指定網(wǎng)絡，綁定后的App只能通過指定網(wǎng)絡訪問外網(wǎng)，使用Promise方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
   connection.setAppNet(netHandle).then((error, data) => {
        console.log(JSON.stringify(data))
   }).catch(error => {
        console.log(JSON.stringify(error))
   })
})

connection.getAllNets

getAllNets(callback: AsyncCallback<Array<NetHandle>>): void

獲取所有處于連接狀態(tài)的網(wǎng)絡列表，使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getAllNets(function (error, data) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(data))
});

connection.getAllNets

getAllNets(): Promise<Array<NetHandle>>

獲取所有處于連接狀態(tài)的網(wǎng)絡列表，使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

connection.getAllNets().then(function (data) {
    console.log(JSON.stringify(data))
});

connection.getConnectionProperties

getConnectionProperties(netHandle: NetHandle, callback: AsyncCallback<ConnectionProperties>): void

獲取netHandle對應的網(wǎng)絡的連接信息，使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getConnectionProperties(netHandle, function (error, data) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(data))
    })
})

connection.getConnectionProperties

getConnectionProperties(netHandle: NetHandle): Promise<ConnectionProperties>

獲取netHandle對應的網(wǎng)絡的連接信息，使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getConnectionProperties(netHandle).then(function (data) {
        console.log(JSON.stringify(data))
    })
})

connection.getNetCapabilities

getNetCapabilities(netHandle: NetHandle, callback: AsyncCallback<NetCapabilities>): void

獲取netHandle對應的網(wǎng)絡的能力信息，使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getNetCapabilities(netHandle, function (error, data) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(data))
    })
})

connection.getNetCapabilities

getNetCapabilities(netHandle: NetHandle): Promise<NetCapabilities>

獲取netHandle對應的網(wǎng)絡的能力信息，使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.getNetCapabilities(netHandle).then(function (data) {
        console.log(JSON.stringify(data))
    })
})

connection.isDefaultNetMetered9+

isDefaultNetMetered(callback: AsyncCallback<boolean>): void

檢查當前網(wǎng)絡上的數(shù)據(jù)流量使用是否被計量，使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.isDefaultNetMetered(function (error, data) {
    console.log(JSON.stringify(error))
    console.log('data: ' + data)
})

connection.isDefaultNetMetered9+

isDefaultNetMetered(): Promise<boolean>

檢查當前網(wǎng)絡上的數(shù)據(jù)流量使用是否被計量，使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

connection.isDefaultNetMetered().then(function (data) {
    console.log('data: ' + data)
})

connection.hasDefaultNet

hasDefaultNet(callback: AsyncCallback<boolean>): void

檢查默認數(shù)據(jù)網(wǎng)絡是否被激活，使用callback方式作為異步方法。如果有默認數(shù)據(jù)網(wǎng)路，可以使用getDefaultNet去獲取。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.hasDefaultNet(function (error, data) {
    console.log(JSON.stringify(error))
    console.log('data: ' + data)
})

connection.hasDefaultNet

hasDefaultNet(): Promise<boolean>

檢查默認數(shù)據(jù)網(wǎng)絡是否被激活，使用Promise方式作為異步方法。如果有默認數(shù)據(jù)網(wǎng)路，可以使用getDefaultNet去獲取。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

返回值：

錯誤碼：

示例：

connection.hasDefaultNet().then(function (data) {
    console.log('data: ' + data)
})

connection.reportNetConnected

reportNetConnected(netHandle: NetHandle, callback: AsyncCallback<void>): void

向網(wǎng)絡管理報告網(wǎng)絡處于可用狀態(tài)，調用此接口說明應用程序認為網(wǎng)絡的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）與網(wǎng)絡管理不一致。

使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetConnected(netHandle, function (error) {
        console.log(JSON.stringify(error))
    });
});

connection.reportNetConnected

reportNetConnected(netHandle: NetHandle): Promise<void>

向網(wǎng)絡管理報告網(wǎng)絡處于可用狀態(tài)，調用此接口說明應用程序認為網(wǎng)絡的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）與網(wǎng)絡管理不一致。

使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetConnected(netHandle).then(function () {
        console.log(`report success`)
    });
});

connection.reportNetDisconnected

reportNetDisconnected(netHandle: NetHandle, callback: AsyncCallback<void>): void

向網(wǎng)絡管理報告網(wǎng)絡處于不可用狀態(tài)，調用此接口說明應用程序認為網(wǎng)絡的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）與網(wǎng)絡管理不一致。

使用callback方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetDisconnected(netHandle, function (error) {
        console.log(JSON.stringify(error))
    });
});

connection.reportNetDisconnected

reportNetDisconnected(netHandle: NetHandle): Promise<void>

向網(wǎng)絡管理報告網(wǎng)絡處于不可用狀態(tài)，調用此接口說明應用程序認為網(wǎng)絡的可用性（ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED）與網(wǎng)絡管理不一致。

使用Promise方式作為異步方法。

需要權限：ohos.permission.GET_NETWORK_INFO 和 ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    connection.reportNetDisconnected(netHandle).then(function () {
        console.log(`report success`)
    });
});

connection.getAddressesByName

getAddressesByName(host: string, callback: AsyncCallback<Array<NetAddress>>): void

使用默認網(wǎng)絡解析主機名以獲取所有IP地址，使用callback方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

let host = "xxxx";
connection.getAddressesByName(host, function (error, data) {
    console.log(JSON.stringify(error))
    console.log(JSON.stringify(data))
})

connection.getAddressesByName

getAddressesByName(host: string): Promise<Array<NetAddress>>

使用默認網(wǎng)絡解析主機名以獲取所有IP地址，使用Promise方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

let host = "xxxx";
connection.getAddressesByName(host).then(function (data) {
    console.log(JSON.stringify(data))
})

NetConnection

網(wǎng)絡連接的句柄。

register

register(callback: AsyncCallback<void>): void

訂閱指定網(wǎng)絡狀態(tài)變化的通知。

需要權限：ohos.permission.GET_NETWORK_INFO

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

netConnection.register(function (error) {
    console.log(JSON.stringify(error))
})

unregister

unregister(callback: AsyncCallback<void>): void

取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

netConnection.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netAvailable')

on(type: 'netAvailable', callback: Callback<NetHandle>): void

訂閱網(wǎng)絡可用事件。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡可用事件。調用register后，才能接收到此事件通知
netCon.on('netAvailable', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netBlockStatusChange')

on(type: 'netBlockStatusChange', callback: Callback<{ netHandle: NetHandle, blocked: boolean }>): void

訂閱網(wǎng)絡阻塞狀態(tài)事件，使用callback方式作為異步方法。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡阻塞狀態(tài)事件。調用register后，才能接收到此事件通知
netCon.on('netBlockStatusChange', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netCapabilitiesChange')

on(type: 'netCapabilitiesChange', callback: Callback<{ netHandle: NetHandle, netCap: NetCapabilities }>): void

訂閱網(wǎng)絡能力變化事件。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡能力變化事件。調用register后，才能接收到此事件通知
netCon.on('netCapabilitiesChange', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netConnectionPropertiesChange')

on(type: 'netConnectionPropertiesChange', callback: Callback<{ netHandle: NetHandle, connectionProperties: ConnectionProperties }>): void

訂閱網(wǎng)絡連接信息變化事件。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡連接信息變化事件。調用register后，才能接收到此事件通知
netCon.on('netConnectionPropertiesChange', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netLost')

on(type: 'netLost', callback: Callback<NetHandle>): void

訂閱網(wǎng)絡丟失事件。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡丟失事件。調用register后，才能接收到此事件通知
netCon.on('netLost', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

on('netUnavailable')

on(type: 'netUnavailable', callback: Callback<void>): void

訂閱網(wǎng)絡不可用事件。

模型約束：此接口調用之前需要先調用register接口，使用unregister取消訂閱默認網(wǎng)絡狀態(tài)變化的通知。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

示例：

// 創(chuàng)建NetConnection對象
let netCon = connection.createNetConnection()

// 先使用register接口注冊訂閱事件
netCon.register(function (error) {
    console.log(JSON.stringify(error))
})

// 訂閱網(wǎng)絡不可用事件。調用register后，才能接收到此事件通知
netCon.on('netUnavailable', function (data) {
    console.log(JSON.stringify(data))
})

// 使用unregister接口取消訂閱
netCon.unregister(function (error) {
    console.log(JSON.stringify(error))
})

NetHandle

數(shù)據(jù)網(wǎng)絡的句柄。

在調用NetHandle的方法之前，需要先獲取NetHandle對象。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

屬性

bindSocket9+

bindSocket(socketParam: TCPSocket | UDPSocket, callback: AsyncCallback<void>): void

將TCPSocket或UDPSocket綁定到當前網(wǎng)絡，使用callback方式作為異步方法。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

import socket from "@ohos.net.socket";
connection.getDefaultNet().then((netHandle) => {
    var tcp = socket.constructTCPSocketInstance();
    var udp = socket.constructUDPSocketInstance();
    let socketType = "TCPSocket";
    if (socketType == "TCPSocket") {
        tcp.bind({
            address: '192.168.xx.xxx', port: 8080, family: 1
        }, error => {
            if (error) {
                console.log('bind fail');
            }
            netHandle.bindSocket(tcp, (error, data) => {
                if (error) {
                    console.log(JSON.stringify(error));
                } else {
                    console.log(JSON.stringify(data));
                }
            })
        })
    } else {
        let callback = value => {
            console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
        }
        udp.on('message', callback);
        udp.bind({
            address: '192.168.xx.xxx', port: 8080, family: 1
        }, error => {
            if (error) {
                console.log('bind fail');
            }
            udp.on('message', (data) => {
                console.log(JSON.stringify(data))
            });
            netHandle.bindSocket(udp, (error, data) => {
                if (error) {
                    console.log(JSON.stringify(error));
                } else {
                    console.log(JSON.stringify(data));
                }
            })
        })
    }
})

bindSocket9+

bindSocket(socketParam: TCPSocket | UDPSocket): Promise<void>;

將TCPSocket或UDPSockett綁定到當前網(wǎng)絡，使用Promise方式作為異步方法。

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

import socket from "@ohos.net.socket";
connection.getDefaultNet().then((netHandle) => {
    var tcp = socket.constructTCPSocketInstance();
    var udp = socket.constructUDPSocketInstance();
    let socketType = "TCPSocket";
    if (socketType == "TCPSocket") {
        tcp.bind({
            address: '192.168.xx.xxx', port: 8080, family: 1
        }, error => {
            if (error) {
                console.log('bind fail');
            }
            netHandle.bindSocket(tcp).then((data) => {
                console.log(JSON.stringify(data));
            }).catch(error => {
                console.log(JSON.stringify(error));
            })
        })
    } else {
        let callback = value => {
            console.log("on message, message:" + value.message + ", remoteInfo:" + value.remoteInfo);
        }
        udp.on('message', callback);
        udp.bind({
            address: '192.168.xx.xxx', port: 8080, family: 1
        }, error => {
            if (error) {
                console.log('bind fail');
            }
            udp.on('message', (data) => {
                console.log(JSON.stringify(data));
            })
            netHandle.bindSocket(udp).then((data) => {
                console.log(JSON.stringify(data));
            }).catch(error => {
                console.log(JSON.stringify(error));
            })
        })
    }
})

getAddressesByName

getAddressesByName(host: string, callback: AsyncCallback<Array<NetAddress>>): void

使用對應網(wǎng)絡解析主機名以獲取所有IP地址，使用callback方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressesByName(host, function (error, data) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(data))
    })
})

getAddressesByName

getAddressesByName(host: string): Promise<Array<NetAddress>>

使用對應網(wǎng)絡解析主機名以獲取所有IP地址，使用Promise方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressesByName(host).then(function (data) {
        console.log(JSON.stringify(data))
    })
})

getAddressByName

getAddressByName(host: string, callback: AsyncCallback<NetAddress>): void

使用對應網(wǎng)絡解析主機名以獲取第一個IP地址，使用callback方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressByName(host, function (error, data) {
        console.log(JSON.stringify(error))
        console.log(JSON.stringify(data))
    })
})

getAddressByName

getAddressByName(host: string): Promise<NetAddress>

使用對應網(wǎng)絡解析主機名以獲取第一個IP地址，使用Promise方式作為異步方法。

需要權限：ohos.permission.INTERNET

系統(tǒng)能力：SystemCapability.Communication.NetManager.Core

參數(shù)：

返回值：

錯誤碼：

示例：

connection.getDefaultNet().then(function (netHandle) {
    let host = "xxxx";
    netHandle.getAddressByName(host).then(function (data) {
        console.log(JSON.stringify(data))
    })
})

NetCap

網(wǎng)絡具體能力。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

NetBearType

網(wǎng)絡類型。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

NetSpecifier

提供承載數(shù)據(jù)網(wǎng)絡能力的實例。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

NetCapabilities

網(wǎng)絡的能力集。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

ConnectionProperties

網(wǎng)絡連接信息。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

RouteInfo

網(wǎng)絡路由信息。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

LinkAddress

網(wǎng)絡鏈路信息。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。

NetAddress

網(wǎng)絡地址。

系統(tǒng)能力：以下各項對應的系統(tǒng)能力均為SystemCapability.Communication.NetManager.Core。