鸿蒙 HarmonyOS NEXT端云一体化开发-云数据库篇

varin

发布于 2025-09-28 12:37:57

15300

代码可运行

文章被收录于专栏：/root/root

运行总次数：0

代码可运行

一、概述

云数据库是一款基于对象模型的数据库，采用存储区、对象类型和对象三级结构。

数据模型

存储区

存储区是一个独立的数据存储区域，多个数据存储区之间相互独立，每个存储区拥有完全相同的对象类型定义
--类似于关系型数据库中的database

对象类型

用户定义存储对象的集合，不同的对象类型对应不同的数据结构
--类似于关系型数据库中的表

对象

对象是云数据库的基本操作单元，每一个对象，都是一条完整的数据记录。
--类似于关系型数据库中的一条记录

角色和权限

角色
World所有人
Authenticated 已认证
Creator 创建者
Administrator管理者
权限：Read（查询）、upsert（增和改）、Delete（删）

二、初始化云数据库-AGC网站版本

创建存储区

步骤一：开发AGC网站，进入到我的项目中，左侧菜单选择数据库

步骤二：选择存储区》新增》输入存储区名称，点击确定后，等待进度条加载完毕

创建对象类型

步骤一：切换到数据类型并点击新增

步骤二：输入对象类型名后，点击下一步

步骤三：输入需要的字段，设置主键后，点击下一步

步骤四：添加索引并设置升序后，点击下一步

步骤五：设置数据权限（根据需要自行设置）>默认 》点击确定

创建对象数据

切换到数据并点击新增

步骤二：选择t_test对象类型，添加数据后，点击确定

步骤三（查询数据）：页面选择存储区名称和对象类型后，点击查询

三、初始化云数据-本地项目版本

TODO：存储区直接使用之前创建的test

项目结构说明

对象类型存储在objecttype目录中
对象存储在datntry目录中

创建t_content对象类型

选中objecttype目录后右键>>new >> Cloud DB Object Type

输入t_content

{
  "objectTypeName": "t_content",
  "fields": [
    {"fieldName": "id", "fieldType": "IntAutoIncrement", "notNull": true, "belongPrimaryKey": true},
    {"fieldName": "title", "fieldType": "String"}
  
  ],
  "indexes": [
    {"indexName": "id", "indexList": [{"fieldName":"id","sortType":"ASC"}]}
  ],
  "permissions": [
    {"role": "World", "rights": ["Read"]},
    {"role": "Authenticated", "rights": ["Read", "Upsert"]},
    {"role": "Creator", "rights": ["Read", "Upsert", "Delete"]},
    {"role": "Administrator", "rights": ["Read", "Upsert", "Delete"]}
  ]
}

创建t_content对象

选中dataentry目录右键>new > cloud DB Data Entry

选择t_content

{
  "cloudDBZoneName": "test",
  "objectTypeName": "t_content",
  "objects": [
    {
      "id": 1,
      "title": "测试1"
    },
    {
      "id": 2,
      "title": "测试2"
    }
  ]
}

更新

选中clouddb右键》Deploy Cloud DB

四、端侧调用云数据库

前提

TOOD：因为云数据库不支持使用Long类型，所以自行添加依赖

// 添加依赖

 "dependencies": {
    "@hw-agconnect/cloud": "^1.0.0",
    "@hw-agconnect/hmcore": "^1.0.0",
    "@hw-agconnect/auth-component": "^1.0.0",
    "long": "5.2.1" 
  }

// 初始化SDK
import {initialize} from  "@hw-agconnect/hmcore"
import jsonStr from "../../resources/rawfile/agconnect-services.json"

 async onCreate(){
 //   初始化
    try {
      initialize(this.context,jsonStr)
    }catch (e){
      console.error(JSON.stringify(e))
    }

  }

建立模型

TODO: 类似：数据表实体类

将生成的js文件放入到项目中

导出schema

TODO：导出选择JSON格式后，放入到项目中

初始化database并查询数据

import { Database } from '@hw-agconnect/cloud/src/main/ets/database/Database';
import cloud from '@hw-agconnect/cloud';
import info from "../../resources/rawfile/cloudFunction_2_cn.json"
import { t_test } from '../model/t_test';

@Entry
@Component


struct DataBasePage {
  @State message: string = 'Hello World';
  private database:Database |null= null
 // 接收数据集
  @State testList :t_test[] = []

  async aboutToAppear(): Promise<void> {
    // 初始化
    this.database= cloud.database({
      zoneName:'test',
      objectTypeInfo:info
    })

   this.testList = await this.database.collection(t_test).query().get()
  }



  build() {
   Column(){
     ForEach(this.testList,(test:t_test)=>{
     Row(){
       Text(`${test.getId()}`)
       Text(test.getName())
     }
     })
   }.width("100%").height("100%")
  }
}