HarmonyOS NEXT关系型数据库增删改查

前言

数据存储基本绕不开数据库,后续工作迟早要用上,趁着周末有空,提前踩下坑和熟悉相关api和用法

效果图

获取RdbStore

  private dbStore: relationalStore.RdbStore | undefined = undefined

  public async initDbStored(context: common.Context) {
    let storeConfig: relationalStore.StoreConfig =
      {
        name: "People.db", //数据库文件名
        securityLevel: relationalStore.SecurityLevel.S2 //数据库的安全级别
      }

    //获得一个相关的RdbStore,操作关系型数据库,用户可以根据自己的需求配置RdbStore的参数,然后通过RdbStore调用相关接口可以执行相关的数据操作
    this.dbStore = await relationalStore.getRdbStore(context, storeConfig)
  }

创建数据表(student)

const storeConfig: relationalStore.StoreConfig = 
{
    name: "People.db", //数据库文件名
    securityLevel: relationalStore.SecurityLevel.S2 //数据库的安全级别
}

async createTable(context: common.Context) {
  //获取RdbStore
  this.dbStore = await relationalStore.getRdbStore(context,storeConfig)
  
  //创建student表的sql语句(分别是id,name,age三列数据,id设置自增长)
  let createTableSql="CREATE TABLE IF NOT EXISTS student" +
    "(" +
    "id INTEGER PRIMARY KEY AUTOINCREMENT" +
    ", name TEXT NOT NULL" +
    ", age INTEGER NOT NULL" +
    ")"
    
  await this.dbStore.executeSql(createTableSql)
}

添加数据

async insert(context: common.Context): Promise<boolean> {
    const value: relationalStore.ValuesBucket = {
      "name": "张三",
      "age": 18
    };
    try {
      this.dbStore = await relationalStore.getRdbStore(context,storeConfig)
      let number = this.dbStore.insertSync("student", value,relationalStore.ConflictResolution.ON_CONFLICT_REPLACE) ?? 0
      return number >= 0
    } catch (e) {
    }
    return false
  }

删除数据

async delete(context: common.Context, uid: string="666"): Promise<number> {
  try {
    let predicates = new relationalStore.RdbPredicates("student")
    //删除id=666的数据
    predicates.equalTo("id", uid);
    
    //获取RdbStore
    this.dbStore = await relationalStore.getRdbStore(context,storeConfig)
    let count = this.dbStore.deleteSync(predicates)
    return Promise.resolve(count ?? 0)
  } catch (e) {
  }
  return 0
}

修改数据

async update(context: common.Context, student: Student): Promise<number> {
  const value: relationalStore.ValuesBucket = {
    "name": student.name,
    "age": student.age
  };
  try {
    //获取RdbStore
    this.dbStore = await relationalStore.getRdbStore(context,storeConfig)
    
    let predicates = new relationalStore.RdbPredicates("student")
    //修改id==student.id一列的name和age
    predicates.equalTo("id", student.id);
    
    let count: number | undefined = this.dbStore.updateSync(value, predicates,relationalStore.ConflictResolution.ON_CONFLICT_REPLACE)
    return count ?? 0
  } catch (e) {
  }
  return 0
}

查询数据

async query(context: common.Context): Promise<Student[]> {
  try {
    //获取RdbStore
    this.dbStore = await relationalStore.getRdbStore(context,storeConfig)
    
    let predicates = new relationalStore.RdbPredicates("student")
    //查询所有列
    let result = this.dbStore.querySync(predicates)
    //查询id,name,age三列数据
    let result = this.dbStore.querySync(predicates, ["id", "name", "age"])
    
    if (!result) {
      return []
    }
    
    let data: Student[] = []
    
    while (result.goToNextRow()) {
      let id = result?.getLong(result.getColumnIndex("id"))
      let name = result?.getString(result.getColumnIndex("name"))
      let age = result?.getLong(result.getColumnIndex("age"))
      data.push({
        id: id,
        name: name,
        age: age
      })
    }
    return data
  } catch (err) {
  }
  return []
}

源码地址

https://gitee.com/zhongrui_developer/test-db

<think>好的,我现在需要回答用户关于HarmonyOS NEXT关系型数据库的使用方法、特性和示例的问题。首先,我需要整理已有的信息。根据用户提供的引用[1]和引用[2],HarmonyOS的关系型数据库基于SQLite,提供增删改查接口,并且可能有封装好的方法。 首先,使用方法方面,用户可能需要知道如何创建数据库、定义结构,以及如何进行基本的CRUD操作。根据引用[1],建需要定义信息,创建数据库操作对象。引用[2]提到系统API被封装,所以应该会有类似Android的Helper类。例如,RdbStore可能是核心类,需要配置上下文、数据库名称和版本等。 特性方面,应该包括事务支持、数据加密、多线程安全、SQL语法支持等。引用[1]和[2]都提到了分布式能力,可能支持跨设备数据同步,但需要确认是否是NEXT版本的新特性。数据加密在移动数据库中常见,所以可能是一个特性。 示例代码部分,可能需要展示如何初始化数据库、创建、插入数据、查询、更新和删除。引用[2]提到了封装后的增删改查接口,所以示例可能包括使用RdbStore的方法,比如insert、query、update、delete。需要注意代码的语法是否正确,是否符合HarmonyOS的API规范。 还需要考虑用户可能遇到的问题,比如数据库升级、性能优化、事务处理等,但用户主要问的是使用方法和示例,所以先集中在这些方面。需要确保引用的信息准确,比如引用[1]提到的relationalStore.RdbStore的使用步骤,可能需要分步骤说明:定义结构、创建数据库、获取操作对象,然后进行CRUD操作。 另外,要检查是否有HarmonyOS NEXT特有的功能,比如改进的分布式能力或新的API变化。如果有,需要明确说明。如果没有,可能沿用之前版本的特性,但需注明版本差异。 最后,生成相关问题时要围绕用户可能感兴趣的扩展点,比如事务处理、数据加密、跨设备同步、性能优化等。</think>### HarmonyOS NEXT 关系型数据库(relationalStore.RdbStore)解析 #### 一、**使用方法** 1. **定义结构** 需通过`TableInfo`类定义名、列名及数据类型,例如: ```typescript const tableInfo: relationalStore.TableInfo = { tableName: 'user', columns: [ { columnName: 'id', dataType: relationalStore.DataType.INTEGER, isPrimaryKey: true }, { columnName: 'name', dataType: relationalStore.DataType.TEXT }, { columnName: 'age', dataType: relationalStore.DataType.INTEGER } ] }; ``` 2. **创建数据库** 使用`getRdbStore`方法创建或打开数据库,需配置上下文、数据库名称和版本: ```typescript const config: relationalStore.StoreConfig = { name: 'myDatabase.db', securityLevel: relationalStore.SecurityLevel.S1 // 数据加密级别 }; const rdbStore = await relationalStore.getRdbStore(context, config); await rdbStore.createTable(tableInfo); // 创建 ``` 3. **CRUD操作** - **插入数据** ```typescript const valueBucket: relationalStore.ValuesBucket = { 'id': 1, 'name': '张三', 'age': 25 }; await rdbStore.insert(tableInfo.tableName, valueBucket); ``` - **查询数据** ```typescript const predicates = new relationalStore.RdbPredicates(tableInfo.tableName); predicates.equalTo('age', 25); const resultSet = await rdbStore.query(predicates, ['id', 'name', 'age']); ``` - **更新数据** ```typescript const updateBucket: relationalStore.ValuesBucket = { 'age': 26 }; await rdbStore.update(updateBucket, predicates); ``` - **删除数据** ```typescript await rdbStore.delete(predicates); ``` #### 二、**核心特性** 1. **SQL兼容性** 支持标准SQL语法,可通过`executeSql`直接执行复杂语句[^2]: ```typescript await rdbStore.executeSql('CREATE INDEX idx_age ON user(age)'); ``` 2. **事务支持** 使用`beginTransaction()`和`commit()`确保操作原子性: ```typescript await rdbStore.beginTransaction(); try { // 批量操作 await rdbStore.commit(); } catch (e) { await rdbStore.rollback(); } ``` 3. **数据加密** 通过`securityLevel`配置加密强度(S1-S4),保障本地存储安全[^1]。 4. **跨设备同步(需验证)** 早期版本支持分布式数据管理,NEXT可能强化跨设备数据自动同步能力。 #### 三、**完整示例** ```typescript // 初始化数据库 async function initRdbStore(context: Context) { const config = { name: 'test.db', securityLevel: SecurityLevel.S2 }; const rdbStore = await getRdbStore(context, config); // 建 const userTable = { tableName: 'user', columns: [...] }; await rdbStore.createTable(userTable); return rdbStore; } // 插入示例数据 async function addUser(rdbStore: relationalStore.RdbStore, user: User) { await rdbStore.insert('user', user); } ``` #### 四、**最佳实践** 1. **性能优化** - 批量操作使用事务 - 频繁查询字段建立索引 2. **兼容性处理** 通过`onUpgrade`回调实现数据库版本迁移: ```typescript const config = { version: 2, onUpgrade: (store, oldVersion, newVersion) => { if (oldVersion < 2) store.executeSql('ALTER TABLE user ADD COLUMN email TEXT'); } }; ``` §§ 相关问题 §§ 1. 如何实现HarmonyOS关系型数据库的跨设备数据同步? 2. 关系型数据库与用户首选项在应用场景上有何区别? 3. 如何处理数据库升级时的数据结构变更? 4. 如何通过加密提升HarmonyOS本地数据库的安全性? : 引用自HarmonyOS关系型数据库基础操作文档 : 参考鸿蒙开发者社区的关系型数据库封装实践
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Harmony钟睿

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值