腾讯云开发者社区

腾讯云开发者社区 HarmonyOs开发：关系型数据库封装之增删改查

HarmonyOs开发：关系型数据库封装之增删改查

前言数据量较少的持久化存储，我们可以选择用户首选项或者是分布式键值数据库进行操作，如果前两种无法满足，在鸿蒙当中，也给我们提供了关系型数据库进行数据之间的操作，和Android中类似，关系型数据库基于SQLite组件，提供了一套完整的对本地数据库进行管理的机制，也对外提供一系列的增、删、改、查等接口，非常的方便，为了针对数...

egzosn

1095人浏览 · 2024-10-23 14:22:31
egzosn  ·  2024-10-23 14:22:31 发布

前言

数据量较少的持久化存储，我们可以选择用户首选项或者是分布式键值数据库进行操作，如果前两种无法满足，在鸿蒙当中，也给我们提供了关系型数据库进行数据之间的操作，和Android中类似，关系型数据库基于SQLite组件，提供了一套完整的对本地数据库进行管理的机制，也对外提供一系列的增、删、改、查等接口，非常的方便，为了针对数据更加方便的操作，目前对系统的Api做了一层简单的封装。

本篇的内容大致如下：

1、远程地址依赖

2、数据库创建和表创建

3、数据库增删改查

4、使用总结

一、远程地址依赖

在工程的oh-package.json5中设置三方包依赖，配置示例如下：

"dependencies": { "@abner/datastore": "^1.0.0"}
  • 1.

OpenHarmony三方库中心仓地址：

 https://ohpm.openharmony.cn/#/cn/detail/@abner%2Fdatastore

二、数据库创建和表创建

1、数据库创建

数据库创建，在初始化的时候，会默认创建，在AbilityStage里初始化即可。

DbUtil.getInstance().init(this.context)
  • 1.
属性介绍

属性

类型

概述

context

Context

上下文

storeConfig

relationalStore.StoreConfig

数据库相关配置，可默认不传，会创建一个默认的abner_data.db数据库，securityLevel为S3，encrypt为true。

storeConfig

属性

类型

概述

name

string

数据库文件名，也是数据库唯一标识符。

securityLevel

SecurityLevel

设置数据库安全级别。

encrypt

boolean

指定数据库是否加密，默认不加密。true:加密。false:非加密。

dataGroupId

string

应用组ID，需要向应用市场获取。模型约束： 此属性仅在Stage模型下可用。从API version 10开始，支持此可选参数。指定在此dataGroupId对应的沙箱路径下创建RdbStore实例，当此参数不填时，默认在本应用沙箱目录下创建RdbStore实例。

customDir

string

数据库自定义路径。使用约束： 数据库路径大小限制为128字节，如果超过该大小会开库失败，返回错误。

autoCleanDirtyData

boolean

指定是否自动清理云端删除后同步到本地的数据，true表示自动清理，false表示手动清理，默认自动清理。

2、数据表创建

数据表的创建有两种方式，一种是sql语句执行，一种是对象形式执行。

sql语句执行
DbUtil.getInstance()
          .executeSql("CREATE TABLE table_name(id INTEGER PRIMARY KEY AUTOINCREMENT,name VARCHAR(50),age INT)")
  • 1.
  • 2.
对象形式执行【推荐】

对象形式，弱化了sql语句，但本身还是以sql的形式进行创建数据表，只是业务层的操作，没有了sql操作，执行很是简单直观，第一个参数是数据表的名字也就是table_name，第二个参数是一个对象，也就是数据表的字段，每个字段，需要指定其数据类型等必要的参数，比如主键，自增，长度等等。

DbUtil.getInstance().createTable("table_name", {
    "id": { type: DbTableFieldType.INTEGER, isPrimaryKey: true, isAutoIncrement: true },
     "name": { type: DbTableFieldType.VARCHAR, length: 120 },
     "age": { type: DbTableFieldType.INT, length: 30 }
})
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

三、数据库增删改查

1、增

普通存储

需要定义ValuesBucket对象进行传递。

const valueBucket1: ValuesBucket = {
          'name': "AbnerMing",
          'age': 18,
        }
DbUtil.getInstance().insert("table_name", valueBucket1)
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
对象存储
let bean = new DbDataBean()
 bean.name = "AbnerMing"
 bean.age = 18
 DbUtil.getInstance().insertBean("table_name", bean)
  • 1.
  • 2.
  • 3.
  • 4.

2、删

普通删除

需要用RdbPredicates对象进行设置过滤条件，可以直接查看官网Api即可。

let deleteRdbPredicates = new relationalStore.RdbPredicates("table_name");
deleteRdbPredicates.equalTo("id", 1);

DbUtil.getInstance().delete(deleteRdbPredicates)
  • 1.
  • 2.
  • 3.
  • 4.
对象删除

和普通删除类似，只不过RdbPredicates对象做了简单封装，需要调用filterRdbPredicates方法进行设置过滤条件。

DbUtil.getInstance()
          .filterRdbPredicates({ equalTo: { "id": 2 } })
          .deleteBean("table_name")
  • 1.
  • 2.
  • 3.

3、改

普通修改
const valueBucket: ValuesBucket = {
          'name': "ming",
          'age': 28,
        }

let upDataRdbPredicates = new relationalStore.RdbPredicates("table_name");
upDataRdbPredicates.equalTo("id", 1)

DbUtil.getInstance().update(upDataRdbPredicates, valueBucket)
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
对象修改

filterRdbPredicates方法为过滤条件，也就是你要更改哪一条数据。

let uBean = new DbDataBean()
 uBean.name = "Ming"
 uBean.age = 20
 DbUtil.getInstance()
  .filterRdbPredicates({ equalTo: { "id": 2 } })
  .updateBean("table_name", uBean)
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.

4、查

普通查询
let predicates = new relationalStore.RdbPredicates("table_name");

 DbUtil.getInstance().query(predicates, (resultSet: relationalStore.ResultSet) => {
          // resultSet是一个数据集合的游标，默认指向第-1个记录，有效的数据从0开始。
          while (resultSet.goToNextRow()) {
            const id = resultSet.getLong(resultSet.getColumnIndex("id"));
            const name = resultSet.getString(resultSet.getColumnIndex("name"));
            const age = resultSet.getLong(resultSet.getColumnIndex("age"));
          }
        })
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
对象查询

获取全部

DbUtil.getInstance()
          .queryAllBean<DbDataBean>("table_name", (data) => {
           
          })
  • 1.
  • 2.
  • 3.
  • 4.

获取单个

DbUtil.getInstance()
          .filterRdbPredicates({ equalTo: { "id": 1 } })
          .queryBean<DbDataBean>("table_name", (data) => {
            
          })
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

5、filterRdbPredicates

在对象操作的增删改查中，这个方法忽视不得，可执行属性如下：

属性

类型

概述

orderByDesc

string

配置谓词以匹配数据表的field列中值按降序排序的列。

orderByAsc

string

配置谓词以匹配数据表的field列中值按升序排序的列。

limitAs

number

设置最大数据记录数的谓词

offsetAs

number

配置谓词以指定返回结果的起始位置

equalTo

{}

配置谓词以匹配数据表的field列中值为value的字段。

notEqualTo

{}

配置谓词以匹配数据表的field列中值不为value的字段

contains

{}

配置谓词以匹配数据表的field列中包含value的字段

between

{}

配置谓词以匹配数据表的field列中值在给定范围内的字段(包含范围边界)，例如：low=high，必须要带等号。

四、使用总结

每个方法都预留了多种调用方式，比如使用callback异步回调或者使用Promise异步回调，亦或者同步执行，大家在使用的过程中，可以根据自身业务需要进行选择性调用，也分别暴露了成功和失败的方法，可以针对性的判断在执行的过程中是否执行成功。

如下案例：

DbUtil.getInstance().delete(deleteRdbPredicates,
          (rows: number)=>{
            //成功
          },
          (err: BusinessError)=>{
            //失败
        })
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
# harmonyos # 数据库 # 华为
Logo
腾讯云开发者社区

腾讯云面向开发者汇聚海量精品云计算使用和开发经验，营造开放的云计算技术生态圈。

更多推荐

Js分割字符串(单个分割符、多个分割符、正则)

1.单个分割符1.1定义和用法split() 方法用于把一个字符串分割成字符串数组。1.2语法stringObject.split(separator,howmany)参数描述separator必需。字符串或正则表达式，从该参数指定的地方分割 stringObject。howmany可选。该参数可指定返回的数组的最大长度。如果设置了该参数，返回的子串不会多于这个参数指定的数组。如果没有设置该参数，

avatar 腾讯云开发者社区

curl

什么是curl命令？curl是利用URL语法在命令行方式下工作的开源文件传输工具。它被广泛应用在Unix、多种Linux发行版中，并且有DOS和Win32、Win64下的移植版本。如何在windows下使用curl命令？第一步： 进入curl下载官网，下载合适的版本，我这里下载的是windows 64位的curl。其中我下载的zip文件。 另外CAB文件也是压缩文件，这...

avatar 腾讯云开发者社区

Zynq7000 USB2.0协议解析及USB控制器详解

USB 2.0规范及控制器文章目录USB 2.0规范及控制器USB2.0Univerasl Serial BusUSBHostUSB总线接口标准总线信号USB拓扑结构数据流模型数据编解码和位填充USB逻辑部件USB时间基准USB 描述符USB设备USB设备供电方式USB设备分层USB设备插入检测机制USB设备状态USB总线枚举USB传输传输类型包(Packet)事务(transaction)传输(

avatar 腾讯云开发者社区
  • 浏览量 1095
  • 收藏 0
  • 0

所有评论(0)

查看更多评论 

egzosn

@cnzzs
已为社区贡献11条内容