登录HarmonyOSNext 端云一体化（4）
HarmonyOSNext 端云一体化（4） 在上一章节我们讲了数据库数据表的一些基本操作。如query、upsert、delete和calculateQuery。这一章节主要来讲解各种查询条件操作。
HarmonyOS Next 端云一体化（3）
上一章我们主要讲解了如何新建数据库、新建数据表已经部署数据库。这一章主要学习如何对数据库、数据表进行 CRUD 的操作。
操作数据库的方式
我们操作数据库的方式一共有 4 种。
- 可视化 - AGC 平台上直接编辑数据
- 可视化 - DevEco Studio 中直接编辑数据
- 编程 - 客户端通过代码的方式操作数据
- 编程 - 云函数通过代码的方式操作数据
方式 1、2 都是为了让开发人员简单、方便管理数据。但是实际的业务场景中，我们更多要关注的是 3、4 的方式。那么本章主要讲的是 方式 3-客户端通过代码的方式操作数据 。后续再讲到云函数的时候再来补充方式 4。
生成客户端-数据模型
先解释下这个功能是做什么的。因为我们的目标是要在 客户端来查询数据库的数据，那必不可少需要在客户端中定义数据表实体的类型。然后 DevEco Studio 提供了比较便捷的根据数据实体生成客户端-数据模型。
我这里红色的提示是因为我之前已经生成过了，所以提示是否覆盖。
成功后边得到如下内容：entry/src/main/ets/common/types/Book.ts
/*
* Copyright (c) Huawei Technologies Co., Ltd. 2024-2024. All rights reserved.
* Generated by the CloudDB ObjectType compiler. DO NOT EDIT!
*/
import { cloudDatabase } from "@kit.CloudFoundationKit";
class Book extends cloudDatabase.DatabaseObject {
id: number;
name: string;
price: number;
publish: Date;
hot: boolean;
cover: string;
naturalbase_ClassName(): string {
return "Book";
}
}
export { Book };
简单使用
接下来我们就可以进入客户端查询数据库的步骤了。
- 首先我们需要创建一个数据库示例，每一个存储区就是一个数据库
cloudDatabase.DatabaseZone - 然后指定查询条件，比如全部查询、查询 id 等于 1 等等
condition - 进行查询，接收返回的数据
import { cloudDatabase } from '@kit.CloudFoundationKit';
import { Book } from '../common/types/Book';
import { promptAction } from '@kit.ArkUI';
@Entry
@Component
struct PageDB {
// 数据库实例，初始化时为 undefined
agcDataBase: cloudDatabase.DatabaseZone | undefined = undefined;
// 查询条件实例，初始化时为 undefined
condition: cloudDatabase.DatabaseQuery<cloudDatabase.DatabaseObject> | undefined = undefined;
// 初始化数据库连接的方法
fn1 = () => {
this.agcDataBase = cloudDatabase.zone('Study');
promptAction.showToast({ message: `初始化成功` });
}
// 查询数据库的方法
fn2 = async () => {
try {
// 创建查询条件实例
this.condition = new cloudDatabase.DatabaseQuery(Book);
// 设置查询结果的最大数量为 10
this.condition.limit(10);
// 执行查询并获取结果
const resultArray = await this.agcDataBase?.query(this.condition);
// 显示查询结果
AlertDialog.show({ message: JSON.stringify(resultArray, null, 2) });
} catch (e) {
promptAction.showToast({ message: `${e.message} ${e.code}` });
console.error(e.message, e.code);
}
}
build() {
Column({ space: 10 }) {
Button("初始化1")
.onClick(this.fn1)
Button("查询2")
.onClick(this.fn2)
}
.height('100%')
.width('100%')
}
}
对数据表的操作
端云一体提供了基本的对数据表的操作。主要分成以下几种
| 操作类型 | 说明 |
|---|---|
| query | 查询 |
| upsert | 新增或者编辑 |
| delete | 删除 |
| calculateQuery | 计算 |
query
就是查询，上面的示例中已经使用过了。
upsert - 新增
现在主要演示 使用 upsert 实现新增
upsert 方法可以接收一个或者多个数据实体。如果该数据之前不存在，这时的 upsert 表示新增，反之表示更新。
操作成功后，会返回成功影响了的数据的数量。
比如新增：
fn3 = async () => {
try {
const book = new Book();
book.id = parseInt(Date.now().toString().slice(0, 6)); // 正常应该是自增的，但是这个自增会出bug
book.name = "book";
book.price = 99;
book.publish = new Date();
book.hot = true;
book.cover = "xxxx";
const res = await this.agcDataBase?.upsert(book);
AlertDialog.show({ message: `新增成了${res}条` });
} catch (e) {
promptAction.showToast({ message: `${e.message} ${e.code}` });
console.error(e.message, e.code);
}
};
Button("新增3").onClick(this.fn3);
需要注意的是：我们当前的角色是 World，此时是没有 新增、编辑、删除权限的。所以为了方便操作，可以修改调整权限
clouddb/objecttype/Book.json
{
"role": "World",
"rights": [
"Read",
"Upsert",
"Delete"
]
},
当数据表信息发生了修改时，需要在 AGC 平台上删除之前的数据区+数据表。然后重新部署。
upsert - 编辑
这里我们可以根据 id 来编辑一下数据。 数据库里面存放着id：10 的数据，我们就来修改它。
fn4 = async () => {
try {
const book = new Book();
// 固定修改id为10的数据
book.id = 10;
book.name = "更新book";
book.price = 999;
book.publish = new Date();
book.hot = true;
book.cover = "更新 xxxx";
const res = await this.agcDataBase?.upsert(book); // 因为数据 id已经存在，所以此时是编辑
AlertDialog.show({ message: `编辑成功${res}条` });
} catch (e) {
promptAction.showToast({ message: `${e.message} ${e.code}` });
console.error(e.message, e.code);
}
};
Button("更新4").onClick(this.fn4);
delete - 删除
执行删除 delete 方法时，也是需要传入一个或者多个删除的元素。
我们这里就可以根据 id：10 的元素执行删除。
fn5 = async () => {
try {
const book = new Book();
// 固定修改id为10的数据
book.id = 10;
const res = await this.agcDataBase?.delete(book); // 因为数据 id已经存在，所以此时是编辑
AlertDialog.show({ message: `删除成功${res}条` });
} catch (e) {
promptAction.showToast({ message: `${e.message} ${e.code}` });
console.error(e.message, e.code);
}
};
Button("删除5").onClick(this.fn5);
calculateQuery - 计算
calculateQuery 从数据库中查询符合条件的数据，并对指定字段进行算术计算。主要提供了以下的计算功能。
| 名称 | 值 | 说明 |
|---|---|---|
| AVERAGE | 0 | 计算平均数。 |
| SUM | 1 | 计算总和。 |
| MAXIMUM | 2 | 计算最大值。 |
| MINIMUM | 3 | 计算最小值。 |
| COUNT | 4 | 计算记录总数。 |
fn6 = async () => {
try {
// 创建查询条件实例
this.condition = new cloudDatabase.DatabaseQuery(Book);
// 设置查询结果的最大数量为 10
this.condition.limit(10);
// 执行查询并获取结果
const resultArray = await this.agcDataBase?.calculateQuery(
this.condition,
"price",
cloudDatabase.QueryCalculate.SUM
);
// 显示查询结果
AlertDialog.show({ message: JSON.stringify(resultArray, null, 2) });
} catch (e) {
promptAction.showToast({ message: `${e.message} ${e.code}` });
console.error(e.message, e.code);
}
};
Button("计算6 总价格").onClick(this.fn6);
总结
本章主要介绍了在 HarmonyOS Next 中如何通过客户端代码操作云数据库，主要包含以下几个要点：
- 操作数据库的四种方式，重点介绍了客户端代码操作方式
- 使用 DevEco Studio 自动生成客户端数据模型，简化开发流程
- 详细讲解了数据库的基本操作：
- 初始化数据库连接(DatabaseZone)
- 查询数据(query)
- 新增/更新数据(upsert)
- 删除数据(delete)
- 数据计算(calculateQuery)
- 介绍了各种操作的参数说明和返回值，并提供了完整的示例代码
以上是对客户端操作数据库的基本功能演示。下一章会重点来讲解查询语法。condition。
如果你兴趣想要了解更多的鸿蒙应用开发细节和最新资讯，欢迎在评论区留言或者私信或者看我个人信息，可以加入技术交流群。
