鸿蒙NEXT网络通信实战：使用HTTP协议进行网络请求

在移动应用开发中，网络通信是连接客户端与服务器的重要桥梁，本文将全面介绍如何在鸿蒙NEXT中使用HTTP协议进行网络通信。

在鸿蒙应用开发中，网络通信是实现应用与服务器数据交互的核心能力。鸿蒙NEXT提供了强大且易用的网络通信模块，支持多种协议和请求方式，让开发者能够轻松实现数据的获取与提交。

HTTP协议基础

HTTP协议是TCP/IP协议族中的应用层协议，用于客户端和服务器之间的通信。它规定请求从客户端发出，服务器端响应该请求并返回。一个完整的HTTP请求包含请求方法、请求URI、协议版本、可选的请求首部字段和内容实体。

常见的HTTP请求方法有：

GET：查询数据，不会对服务器状态产生影响
POST：提交数据
PUT：修改数据
DELETE：删除数据

在鸿蒙NEXT中使用HTTP模块

权限配置

使用HTTP数据请求功能前，需要在module.json5文件中申请网络权限：

json

复制代码

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

发起HTTP请求

鸿蒙NEXT的HTTP数据请求功能主要由@kit.NetworkKit模块提供，开发步骤清晰简单：

调用http.createHttp()方法创建HttpRequest对象
调用该对象的request()方法，传入URL地址和可选参数
解析返回结果
请求完成后调用destroy()方法销毁对象

以下是完整的示例代码：

typescript

复制代码

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

// 创建HTTP请求对象
let httpRequest = http.createHttp();

// 可选：订阅响应头事件
httpRequest.on('headersReceive', (header) => {
  console.info('header: ' + JSON.stringify(header));
});

// 发起HTTP请求
httpRequest.request(
  "https://api.example.com/data",
  {
    method: http.RequestMethod.GET,
    header: {
      'Content-Type': 'application/json'
    },
    expectDataType: http.HttpDataType.STRING,
    usingCache: true,
    priority: 1,
    connectTimeout: 60000,
    readTimeout: 60000
  }, (err: BusinessError, data: http.HttpResponse) => {
    if (!err) {
      // 处理返回数据
      console.info('Result:' + JSON.stringify(data.result));
      console.info('code:' + JSON.stringify(data.responseCode));
      console.info('header:' + JSON.stringify(data.header));
      console.info('cookies:' + JSON.stringify(data.cookies));
      
      // 销毁请求对象
      httpRequest.destroy();
    } else {
      console.error('error:' + JSON.stringify(err));
      // 取消订阅响应头事件
      httpRequest.off('headersReceive');
      // 销毁请求对象
      httpRequest.destroy();
    }
  }
);

使用Promise风格

除了回调函数方式，鸿蒙NEXT的HTTP模块也支持Promise风格的异步调用，使代码更加简洁：

typescript

复制代码

aboutToAppear(): void {
  this.getData()
}

getData() {
  // 1. 创建 http 实例
  const httpInstance = http.createHttp();
  // 2. 发起网络请求
  httpInstance.request('https://hmajax.itheima.net/api/news')
    .then(res => {
      // 3.1 成功，处理请求结果
      console.log('success', res.result.toString());
    })
    .catch((err: Error) => {
      // 3.2 失败
      console.log('error', err.message);
    })
    .finally(() => {
      // 4. 销毁实例
      httpInstance.destroy();
    });
}

异步处理与Promise

在鸿蒙网络编程中，理解异步编程模式至关重要。Promise是一种用于处理异步操作的对象，可以将异步操作转换为类似于同步操作的风格。

Promise有三种状态：

待定（pending）：初始状态
已兑现（fulfilled）：操作成功
已拒绝（rejected）：操作失败

使用async/await简化异步代码

async/await是处理异步操作的Promise语法糖，使得编写异步代码变得更加简单和易读。

typescript

复制代码

// 模拟异步获取数据
function getA() {
  return new Promise<string>((resolve, reject) => {
    setTimeout(() => {
      resolve('A');
    }, 2000);
  });
}

function getB() {
  return new Promise<string>((resolve, reject) => {
    setTimeout(() => {
      resolve('B');
    }, 3000);
  });
}

async function getData() {
  const a = await getA();
  console.log('数据', a);
  const b = await getB();
  console.log('数据', b);
}

getData();

处理JSON数据

在网络通信中，JSON是最常用的数据交换格式。鸿蒙NEXT提供了原生的JSON解析和序列化支持：

typescript

复制代码

// 定义接口
interface User {
  name: string;
  age: number;
}

// JSON字符串转对象
const userStr = '{"name":"Jack","age":18}';
const user = JSON.parse(userStr) as User;
user.age = 20;

// 对象转JSON字符串
const newUserStr = JSON.stringify(user);

网络状态管理

在实际应用中，我们经常需要检查网络状态并响应网络变化。鸿蒙NEXT提供了强大的网络连接管理能力。

检查网络状态

typescript

复制代码

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

// 检查默认网络状态
connection.getDefaultNet().then((netHandle) => {
  console.log("当前默认网络ID：" + netHandle.netId);
}).catch((error) => {
  console.error("获取失败：" + error.code);
});

监听网络变化

typescript

复制代码

// 网络状态实时监控
const specifier = {
  netCapabilities: {
    bearerTypes: [connection.NetBearType.BEARER_CELLULAR],
    networkCap: [connection.NetCap.NET_CAPABILITY_INTERNET]
  }
};

const conn = connection.createNetConnection(specifier);
conn.on('netAvailable', (netHandle) => {
  console.log(`🎉 网络切换成功！新网络ID：${netHandle.netId}`);
  // 网络恢复时重新加载数据
  this.loadData();
});
conn.on('netLost', (data) => {
  console.log('网络连接丢失');
  // 提示用户网络不可用
  this.showNetworkError();
});
conn.register(); // 开启监听

错误处理与最佳实践

完善的错误处理

网络请求难免会遇到各种错误，完善的错误处理机制能提升应用稳定性：

typescript

复制代码

httpRequest.request(url, options, (err: BusinessError, data: http.HttpResponse) => {
  if (!err) {
    // 成功处理
    this.handleData(data);
  } else {
    // 根据错误码进行不同处理
    switch (err.code) {
      case 400:
        console.error('请求错误');
        break;
      case 401:
        console.error('权限不足');
        break;
      case 404:
        console.error('资源不存在');
        break;
      case 500:
        console.error('服务器内部错误');
        break;
      default:
        console.error('网络错误:' + JSON.stringify(err));
    }
    this.showErrorToast(err.message);
  }
});

性能优化建议

合理设置超时时间：根据业务需求设置连接和读取超时
及时销毁请求对象：避免内存泄漏
合理使用缓存：对不常变化的数据启用缓存
设置请求优先级：重要请求可设置更高优先级
批量请求：减少频繁的小请求

结语

鸿蒙NEXT提供了强大而完善的网络通信能力，从简单的HTTP请求到复杂的网络状态管理，都提供了简洁易用的API。

通过本文的介绍，相信你已经掌握了在鸿蒙应用中使用HTTP协议进行网络通信的核心技能。

在实际开发中，记得遵循最佳实践，构建稳定、高效的网络应用。