HarmonyOS网络请求与数据持久化实战指南

1. HarmonyOS网络请求基础与实战

在HarmonyOS应用开发中，网络请求是与后端服务交互的核心能力。不同于Android的Retrofit或iOS的Alamofire，HarmonyOS提供了自研的http模块来实现网络通信。这个模块基于轻量级设计，支持HTTP/HTTPS协议，同时针对分布式场景做了特殊优化。

1.1 http模块核心API解析

http模块的核心类包括：

• HttpRequest：封装请求参数和配置
• HttpResponse：处理响应数据和状态
• HttpClient：实际执行网络操作的引擎

一个典型的GET请求实现如下：

typescript复制import http from '@ohos.net.http';

// 创建HTTP客户端
let httpClient = http.createHttp();

// 构建请求对象
let request = http.createHttpRequest();
request.method = http.RequestMethod.GET;
request.url = 'https://api.example.com/data';

// 发送请求
httpClient.request(request, (err, data) => {
  if (err) {
    console.error(`请求失败: ${err.code}, ${err.message}`);
    return;
  }
  
  // 处理响应数据
  console.info(`状态码: ${data.responseCode}`);
  console.info(`响应头: ${JSON.stringify(data.header)}`);
  console.info(`响应体: ${data.result}`);
});

1.2 网络请求的分布式特性

HarmonyOS的独特之处在于其分布式能力。当设备组成超级终端时，应用可以通过setExtraOptions方法指定网络请求的执行设备：

typescript复制request.setExtraOptions({
  deviceId: '目标设备ID' // 空字符串表示本地执行
});

这个特性在以下场景特别有用：

• 手机电量不足时，将计算密集型请求转移到平板
• 手表发起请求但由手机实际处理
• 跨设备数据同步时选择最优网络路径

1.3 安全策略与最佳实践

HarmonyOS对网络请求有严格的安全限制：

1. 必须先在module.json5中声明网络权限：

json复制"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  }
]

2. HTTPS证书校验默认开启，如需调试可临时关闭：

typescript复制request.setExtraOptions({
  sslCipherSuite: 'SSL_RSA_WITH_AES_128_GCM_SHA256', // 指定加密套件
  sslCaCerts: '/path/to/cert.pem' // 自定义CA证书
});

3. 推荐使用连接池管理请求：

typescript复制// 全局初始化时创建
const httpClient = http.createHttp({
  connectTimeout: 30000, // 30秒超时
  usingCache: true,     // 启用缓存
  maxConnections: 5     // 最大连接数
});

重要提示：生产环境必须使用HTTPS，且不要关闭证书验证。对于敏感数据，建议额外使用@ohos.security.crypto模块进行加密。

2. 数据持久化方案深度对比

HarmonyOS提供了多种数据持久化方案，各有其适用场景：

2.1 Preferences的进阶用法

虽然Preferences通常用于存储简单配置，但其API设计支持一些高级特性：

typescript复制import dataPreferences from '@ohos.data.preferences';

// 获取Preferences实例
let preferences: Promise<dataPreferences.Preferences> = 
  dataPreferences.getPreferences(this.context, 'myProfile');

// 批量操作示例
preferences.then((pref) => {
  pref.put('username', 'John')
     .put('age', 25)
     .put('vip', true)
     .flush()  // 立即持久化
     .then(() => {
       console.info('数据保存成功');
     })
     .catch((err) => {
       console.error(`保存失败: ${err.code}, ${err.message}`);
     });
});

// 监听数据变化
pref.on('change', (key) => {
  console.log(`键 ${key} 的值已更新`);
});

分布式场景下的特殊处理：

typescript复制// 设置同步策略
pref.setSyncRange(
  dataPreferences.SyncRange.SPAN_ACCOUNT, // 账号内所有设备同步
  ['username', 'age']  // 只同步指定字段
);

2.2 RDB关系型数据库实战

对于复杂数据结构，RDB提供了完整的SQLite功能支持：

typescript复制import relationalStore from '@ohos.data.relationalStore';

// 定义表结构
const SQL_CREATE_TABLE = `
CREATE TABLE IF NOT EXISTS user (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  age INTEGER,
  created TIMESTAMP DEFAULT (datetime('now','localtime'))
)`;

// 初始化数据库
let rdbStore;
const config = {
  name: 'MyApplication.db',
  securityLevel: relationalStore.SecurityLevel.S1 // 数据加密级别
};

relationalStore.getRdbStore(this.context, config, (err, store) => {
  if (err) {
    console.error(`数据库初始化失败: ${err}`);
    return;
  }
  rdbStore = store;
  rdbStore.executeSql(SQL_CREATE_TABLE);
});

// 插入数据
const valueBucket = {
  'name': 'Alice',
  'age': 28
};
rdbStore.insert('user', valueBucket, (err, rowId) => {
  console.log(`插入记录ID: ${rowId}`);
});

// 复杂查询
const predicates = new relationalStore.RdbPredicates('user');
predicates.equalTo('age', 28)
          .orderByAsc('name')
          .limit(10);

rdbStore.query(predicates, ['id', 'name', 'age'], (err, resultSet) => {
  while (resultSet.goToNextRow()) {
    console.log(`ID: ${resultSet.getLong(0)}, Name: ${resultSet.getString(1)}`);
  }
  resultSet.close();
});

3. 网络与持久化结合的最佳实践

3.1 离线优先架构实现

在弱网环境下，合理的缓存策略能极大提升用户体验：

typescript复制async function fetchWithCache(url: string) {
  // 1. 先检查本地缓存
  const cached = await getFromCache(url);
  if (cached) {
    updateUI(cached);
    
    // 2. 后台更新数据
    refreshInBackground(url);
    return;
  }
  
  // 3. 无缓存时直接请求
  fetchData(url);
}

async function getFromCache(url: string) {
  const predicates = new relationalStore.RdbPredicates('api_cache');
  predicates.equalTo('url', url);
  
  return new Promise((resolve) => {
    rdbStore.query(predicates, ['data', 'timestamp'], (err, resultSet) => {
      if (resultSet.rowCount > 0) {
        resultSet.goToFirstRow();
        const data = resultSet.getString(0);
        const timestamp = resultSet.getLong(1);
        
        // 检查缓存有效期（1小时）
        if (Date.now() - timestamp < 3600000) {
          resolve(JSON.parse(data));
        }
      }
      resolve(null);
    });
  });
}

function refreshInBackground(url: string) {
  // 实际实现中应使用Worker线程
  fetchData(url, {background: true});
}

3.2 数据同步冲突解决

分布式场景下，多设备同时修改数据可能导致冲突。推荐采用以下策略：

1. 时间戳策略：最后修改的版本生效

typescript复制// 在数据表中添加version字段
const SQL_CREATE_TABLE = `
CREATE TABLE IF NOT EXISTS notes (
  id TEXT PRIMARY KEY,
  content TEXT,
  version INTEGER,
  device_id TEXT
)`;

// 更新时检查版本
const predicates = new relationalStore.RdbPredicates('notes');
predicates.equalTo('id', noteId)
          .equalTo('version', currentVersion);

rdbStore.update(valueBucket, predicates, (err, rows) => {
  if (rows === 0) {
    // 版本冲突，需要合并或提示用户
    handleConflict();
  }
});

2. 操作转换(OT)策略：适用于协同编辑场景

typescript复制// 记录操作类型而非直接修改内容
interface Operation {
  type: 'insert' | 'delete';
  position: number;
  text?: string;
  timestamp: number;
}

// 在本地应用操作
function applyOperation(content: string, op: Operation): string {
  // 实现操作转换逻辑
}

// 同步时发送操作序列而非最终内容

4. 性能优化与调试技巧

4.1 网络请求优化

1. 连接复用：保持HttpClient实例长期存在

typescript复制// 应用全局单例
class HttpManager {
  private static instance: http.HttpClient;
  
  static getClient(): http.HttpClient {
    if (!this.instance) {
      this.instance = http.createHttp({
        usingCache: true,
        enableHttp2: true  // 启用HTTP/2多路复用
      });
    }
    return this.instance;
  }
}

2. 数据压缩：减少传输体积

typescript复制request.setExtraOptions({
  compress: true  // 启用gzip压缩
});

3. 智能预加载：根据用户行为预测请求

typescript复制// 在页面onShow时预加载可能需要的资源
onShow() {
  prefetchData('/api/recommendations');
}

function prefetchData(url: string) {
  if (navigator.connection === 'wifi') {
    // 只在WiFi环境下预加载
    httpClient.request(createRequest(url));
  }
}

4.2 数据存储性能优化

1. 批量操作：减少IO次数

typescript复制// 不好的做法：循环中单条插入
for (const item of dataList) {
  rdbStore.insert('items', item);
}

// 推荐做法：使用事务批量插入
rdbStore.beginTransaction();
try {
  for (const item of dataList) {
    rdbStore.insert('items', item);
  }
  rdbStore.commit();
} catch (err) {
  rdbStore.rollback();
}

2. 索引优化：为常用查询字段添加索引

typescript复制const SQL_CREATE_INDEX = `
CREATE INDEX IF NOT EXISTS idx_user_age ON user(age)`;

rdbStore.executeSql(SQL_CREATE_INDEX);

3. 分页加载：大数据集分块处理

typescript复制function loadInChunks(offset: number, limit: number) {
  const predicates = new relationalStore.RdbPredicates('large_data');
  predicates.offset(offset).limit(limit);
  
  rdbStore.query(predicates, (err, resultSet) => {
    // 处理当前页数据
  });
}

4.3 调试工具的使用

1. HiDebug工具：

bash复制# 查看网络请求日志
hdc shell hilog | grep Http

# 监控数据库操作
hdc shell hidumper -s 3301 -a 'query rdb'

2. DevEco Studio调试技巧：

• 使用Network Profiler分析请求时序
• 通过Database Inspector实时查看数据库内容
• 使用Distributed Debugging跟踪跨设备数据同步

3. 性能分析：

typescript复制// 标记代码段执行时间
console.time('dbOperation');
// 数据库操作...
console.timeEnd('dbOperation');  // 输出耗时

在实际项目中，我发现合理使用Preferences的同步范围能显著减少不必要的网络传输。例如用户主题偏好可以设置为SPAN_ACCOUNT级别同步，而临时性的UI状态应该只在本地设备保存。对于关键业务数据，建议采用RDB的加密存储(S2级别)配合定期备份到云端的策略。