第二一课：HarmonyOS Next网络请求开发实战

一、HTTP请求实现

1. 权限申请与模块初始化

在HarmonyOS Next中发起HTTP请求需先在module.json5中声明网络权限：

// entry/src/main/module.json5
"requestPermissions": [
{
"name": "ohos.permission.INTERNET",
"reason": "用于加载网络数据",
"usedScene": { "ability": ["EntryAbility"] }
}
]

2. 基础HTTP请求方法

使用@kit.NetworkKit模块发起请求，支持GET/POST等常见方法：

import { http } from '@kit.NetworkKit';

// 创建请求实例
let httpRequest = http.createHttp();

// 发起GET请求
httpRequest.request(
"https://api.example.com/data",
{
method: http.RequestMethod.GET,
header: { 'Content-Type': 'application/json' }
},
(err, data) => {
if (!err) {
console.log('Response:', data.result);
} else {
console.error('Error:', err.code);
}
}
);

3. 高级封装与拦截器

通过封装NetWorkManage类统一管理请求配置：

class NetWorkManage {
private BASE_URL: string = 'https://api.example.com';

async get(path: string, params?: object) {
try {
const response = await httpRequest.request(
${this.BASE_URL}${path},
{ method: http.RequestMethod.GET, data: params }
);
return response.result;
} catch (error) {
throw new Error(请求失败: ${error.message});
}
}

// 添加请求拦截器
addInterceptor(interceptor: HttpInterceptor) {
httpRequest.on('beforeRequest', interceptor);
}
}

二、WebSocket双向通信

1. WebSocket连接建立

通过WebSocket类实现实时通信：

import { webSocket } from '@kit.NetworkKit';

// 创建WebSocket连接
const ws = new webSocket.WebSocket('wss://echo.websocket.org');

// 监听连接事件
ws.on('open', () => {
console.log('WebSocket连接已建立');
ws.send('Hello Server!');
});

// 接收消息
ws.on('message', (data: string) => {
console.log('收到消息:', data);
});

2. 心跳机制与重连策略

let reconnectAttempts = 0;

// 心跳检测
setInterval(() => {
if (ws.readyState === webSocket.OPEN) {
ws.send('ping');
}
}, 30000);

// 断线重连
ws.on('close', () => {
if (reconnectAttempts < 5) {
setTimeout(() => {
ws.connect();
reconnectAttempts++;
}, 2000);
}
});

三、最佳实践与性能优化

1. 网络请求性能对比

根据HarmonyOS官方性能测试数据，不同网络请求方案的延迟如下：

方案 延迟（ms） 适用场景 HTTP短连接 50-200 低频数据请求 HTTP长连接 30-150 高频短数据交互 WebSocket <50 实时通信/高频双向数据

HTTP短连接适用于低频数据请求场景，每次请求都会建立新的连接，完成后立即关闭。HTTP长连接则通过持久连接减少因TCP握手和慢启动导致的延迟，适用于高频短数据交互。而WebSocket则更进一步，通过长连接和双向通信，实现了更低的延迟，非常适合实时通信和高频双向数据交互场景。

2. 关键优化策略

‌数据压缩‌：对请求体启用GZIP压缩减少传输量‌ ‌请求合并‌：使用GraphQL合并多个API调用‌ ‌缓存机制‌：通过@ohos.data.preferences缓存高频数据‌