鸿蒙开发5.0案例分析：TaskPool数据库操作实战

往期推文全新看点（文中附带最新·鸿蒙全栈学习笔记）

市场巨变，移动开发行业即将迎来“第二春”?

鸿蒙应用开发与鸿蒙系统开发哪个更有前景？

嵌入式开发适不适合做鸿蒙南向开发？看完这篇你就了解了~

对于大前端开发来说，转鸿蒙开发究竟是福还是祸？

鸿蒙岗位需求突增！移动端、PC端、IoT到底该怎么选？

记录一场鸿蒙开发岗位面试经历~

持续更新中……

---

介绍

本实例通过列表场景实例讲解，介绍在TaskPool线程中操作关系型数据库的方法，涵盖单条插入、批量插入、删除和查询操作。

效果图预览

使用说明

1. 进入页面有insert(单条数据插入)、batch insert(批量数据插入)、query(查询操作)三个按钮，点击query按钮后列表数据会从数据库更新，列表每条后面都有删除按钮，可以从数据库删除数据。

实现思路

1. 首先，构建一个关系型数据库并封装数据库操作方法涉及几个关键步骤。

• 通过getRdbStore方法初始化一个关系型数据库，用户可以根据STORE_CONFIG配置RdbStore的参数，使用Promise异步回调。

// 初始化数据库 
 public async initRdbStore(context: common.Context): Promise<void> {
    this.rdbStore = await rdb.getRdbStore(context, STORE_CONFIG);
    await this.createTable();
 }

• 使用executeSql接口初始化数据库表结构和相关数据。

// 创建数据库表
  private async createTable(): Promise<void> { 
  await this.rdbStore.executeSql(SQL_CREATE_TABLE)
}

• 封装数据库操作方法分别为数据插入、数据删除和数据查询。

// 单条数据插入数据库
public async insertData(context: common.Context, Contact: Contact): Promise<void> {
  let value1 = Contact.name;
  let value2 = Contact.phone;
  const valueBucket: ValuesBucket = {
    'name': value1,
    'phone': value2
  }
  if (this.rdbStore != undefined) {
    let ret = await this.rdbStore.insert(TABLE_NAME, valueBucket, rdb.ConflictResolution.ON_CONFLICT_REPLACE)
  }
}

// 批量插入数据库
public async batchInsertData(context: common.Context, array: Array<Contact>): Promise<void> {
  let valueBuckets: Array<ValuesBucket> = [];
  for (let index = 0; index < array.length; index++) {
    let Contact = array[index] as Contact;
    let value1 = Contact.name;
    let value2 = Contact.phone;
    const valueBucket: ValuesBucket = {
      'name': value1, 
      'phone': value2
    }
    valueBuckets.push(valueBucket);
  }
  if (this.rdbStore != undefined) {
    let ret = await this.rdbStore.batchInsert(TABLE_NAME, valueBuckets)
  }
}

// 删除操作
public async deleteData(context: common.Context, Contact: Contact): Promise<boolean> { 
  try {
    predicates.or().equalTo('id', Contact.id)
    let row = await this.rdbStore.delete(predicates);
    logger.info(TAG, `delete contact success:${row}`)
  } catch (e) {
    logger.error(TAG, 'delete failed:', JSON.stringify(e));
    promptAction.showToast({
      message: JSON.stringify(e),
      duration: 2000
    });
    return false;
  }
  return true;
}

 // 查询数据库
public async query(context: common.Context): Promise<Array<Contact>> {
    if (!this.rdbStore) {
    logger.info(TAG, 'query rdbStore is null')
    await this.initRdbStore(context);
  } else {
    try {
      this.rdbStore = await rdb.getRdbStore(context, STORE_CONFIG);
      // 默认查询所有列
      let resultSet: rdb.ResultSet = await this.rdbStore.query(predicates);
      logger.info(TAG, 'result is ' + JSON.stringify(resultSet.rowCount))
      // 处理查询到的结果数组
      return this.getListFromResultSet(resultSet)
    } catch (e) {
      logger.error(TAG, 'query result error:' + JSON.stringify(e))
    }
  }
  return [];
}

2. 创建任务池（taskpool）为数据库操作提供一个多线程的运行环境。

• 将创建好的任务放入taskpool内部任务队列。（注：任务不会立即执行，而是等待分发到工作线程执行。）

export async function taskPoolExecuteQuery(context: common.Context): Promise<Array<Contact>> {
  let task: taskPool.Task = new taskPool.Task(query, context); // query函数调用 需使用装饰器@Concurrent
  let result: Array<Contact> = await taskPool.execute(task) as Array<Contact>;
}

• 在使用TaskPool时，执行的并发函数需要使用@Concurrent装饰器修饰，通过相关校验。

export async function taskPoolExecuteQuery(context: common.Context): Promise<Array<Contact>> {
  try {
    let task: taskPool.Task = new taskPool.Task(query, context); // query函数调用 需使用装饰器@Concurrent
    let result: Array<Contact> = await taskPool.execute(task) as Array<Contact>;
    return result;
  } catch (err) {
    logger.error(TAG, 'query error:' + JSON.stringify(err));
    return [];
  }
}

3. 在taskpool线程中操作关系型数据库方法的调用。

// 单条数据插入按钮
Button('insert', { type: ButtonType.Normal, stateEffect: true })
  .borderRadius($r('app.integer.operate_rdb_in_taskpool_button_border_radius'))
  .backgroundColor($r('app.color.operate_rdb_in_taskpool_button_background_color'))
  .width($r('app.integer.operate_rdb_in_taskpool_button_width'))
  .height($r('app.integer.operate_rdb_in_taskpool_button_height'))
  .onClick(async () => {
    // 单条数据插入操作
    taskPoolExecuteInsert(context, originalContact);
})

// 批量数据插入操作
taskPoolExecuteBatchInsert(context, this.sourceData);

// 数据查询操作
taskPoolExecuteQuery(context).then((contact: Array<Contact>) => {
  this.dataArray.clear()
  this.dataArray.pushData(contact)
});

// 数据删除操作
taskPoolExecuteDelete(context, item).then((isDelete: boolean) => {
  if (isDelete) {
    // 数据库删除成功后 操作列表数据源
    this.dataArray.deleteData(item)
  }
});