开发准备：

1.项目已经开启云数据库服务

2.拥有真机（目前端侧调用云数据库只有真机能使用）

没有满足这两个条件的可以先去完成再查看本篇文章

数据准备

在华为AppGrallery Connect 云数据库里建好表，并存入数据
这里以poem诗文表为例讲解云数据库的调用
例如：

表建立好后是不允许对字段进行修改的，只能添加新的字段，如需更改，请重新建一张新表

向数据库中插入数据

方法1：

在云工程模块上传数据，注意存储区和表结构
存储区最多只能有4个，超过会报错

方法2：将云工程的dataEntry目录下的d_Poem.josn文件复制放到桌面

在外部将数据导入d_Poem.josn

接着在AGC数据下选择导入,

数据就可以导入进云数据库了，导入的时候要注意存储区和表结构是否和AGC上的相等，json里的数据也要和表结构的想对应

Application端配置

1.在AGC中的项目项目设置中导出agconnect-services.json文件，并放到项目的entry模块的src/main/resources/rawfile目录下。

2.在数据模型界面将导出的表json文件重命名为schema.json,并放置在AppScope/resources/raw/file目录下，后期表结构改动时，这个文件也要同步更改

2.打开端侧工程项目，切换到entry目录下

下载云服务依赖

ohpm install @hw-agconnect/hmcore
ohpm install @hw-agconnect/cloud

在工程级的on-package.json5文件

看到这两个就说明安装成功了

3.初始化云模块
在Entry模块的EntryAbility.ets文件的onCreate方法下，调用数据库初始化

4.在项目中使用
在云工程将客户端的数据结构导出

import { cloudDatabase } from '@kit.CloudFoundationKit';

class Poem extends cloudDatabase.DatabaseObject {
  public naturalbase_ClassName(): string {
    return 'Poem';
  }
  public numId: number =0;
  public id: string ='';
  public title: string | undefined;
  public dynasty: string | undefined;
  public writer: string ='';
  public content: string | undefined;
  public type: string | undefined;
  public remark: string | undefined;
  public shangxi: string | undefined;
  public translation: string | undefined;
}

export { Poem };

import { Poem } from "../model/Poem" // 导入Poem模型
import { cloudDatabase } from "@kit.CloudFoundationKit" // 导入云数据库操作模块
import { BusinessError } from "@kit.BasicServicesKit" // 导入业务错误处理模块

// 定义PoemsPage组件
@Component
export struct PoemsPage {
  @State poemsList: Poem[] = [] // 状态变量，存储诗歌列表
  @State pageNumber: number = 1 // 状态变量，存储当前页码

  // 组件即将显示时触发的方法
  async aboutToAppear(): Promise<void> {
    let res: Poem[] | undefined = await fetchAllData(this.pageNumber) // 获取数据
    if (res) {
      res.forEach(poem => {
        this.poemsList.push(poem); // 将获取的数据添加到诗歌列表中
      });

    }
  }

  // 构建组件UI
  build() {
    Column() { // 创建一个垂直布局的容器

      List({ space: 10 }) { // 创建一个列表，设置间距为10
        ForEach(this.poemsList, (item: Poem) => { // 遍历诗歌列表
          ListItem() { // 创建列表项
            this.PoemItem(item) // 调用PoemItem方法渲染诗歌信息
          }
        })
      }
      .onReachEnd(async () => { // 列表滑动到底部时触发的事件
        this.pageNumber++; // 页码增加
        let res: Poem[] | undefined = await fetchAllData(this.pageNumber) // 获取下一页数据

        if (res) {
          res.forEach(poem => {
            this.poemsList.push(poem); // 将获取的数据添加到诗歌列表中
          });
        }
      })
    }
    .width('100%') // 设置容器宽度为100%
  }

  // 构建单个诗歌项的UI
  @Builder
  PoemItem(poem: Poem) {
    Column({ space: 10 }) { // 创建一个垂直布局的容器，设置间距为10
      Text(poem.title) // 显示诗歌标题
        .fontSize($r('app.float.normal_text_size1')); // 设置字体大小
      Text(poem.writer) // 显示诗人
        .fontSize($r('app.float.normal_text_size1')); // 设置字体大小
      Text(poem.dynasty) // 显示朝代
        .fontSize($r('app.float.normal_text_size1')); // 设置字体大小
      Text(poem.content) // 显示诗歌内容
        .fontSize($r('app.float.normal_text_size1')); // 设置字体大小
    }
    .borderRadius(25) // 设置圆角为25
    .backgroundColor('#fff5eee6') // 设置背景颜色
    .padding(20) // 设置内边距
    .justifyContent(FlexAlign.Center) // 设置垂直居中
    .width('100%') // 设置宽度为100%
  }
}

// 异步函数，用于从数据库中获取诗歌数据
async function fetchAllData(pageNumber: number = 1): Promise<Poem[] | undefined> {
  try {
    let databaseZone = cloudDatabase.zone('Travel'); // 获取数据库区域
    let condition = new cloudDatabase.DatabaseQuery(Poem); // 创建数据库查询条件

    // 设置查询参数：每次查询15条记录
    const limit = 15;
    // 计算跳过的记录数，用于分页
    const skip = (pageNumber - 1) * limit;

    // 设置查询条件：限制查询结果数量和跳过的记录数
    condition.limit(15, skip)

    // 返回一个Promise对象，用于处理异步查询结果
    return new Promise((resolve, reject) => {
      databaseZone.query(condition, (err: BusinessError, poemArray: Poem[]) => {
        if (err) {
          console.error(`查询失败，错误代码: ${err.code}, 错误信息:${err.message}`); // 打印错误信息
          reject(err); // 拒绝Promise
        } else {
          console.info(`查询成功，结果: ${JSON.stringify(poemArray)}`); // 打印查询结果
          resolve(poemArray); // 解决Promise
        }
      });
    });
  } catch (err) {
    console.error(`捕获到错误: ${err.message}`); // 打印捕获到的错误信息
    return undefined; // 返回undefined，表示查询失败
  }
}

效果

查询数据
如果我们想自定义查询条件，可以使用官方的API,

例如：

async function fetchAllData(pageNumber: number = 1): Promise<Poem[] | undefined> {
  try {
    let databaseZone = cloudDatabase.zone('Travel');
    let condition = new cloudDatabase.DatabaseQuery(Poem);

    // 每次查询 15 条记录
    const limit = 15;
    // 计算跳过多少条记录，公式：skip = (pageNumber - 1) * limit
    const skip = (pageNumber - 1) * limit;

    // 设置查询条件：分页查询
    condition.limit(15, skip)

    condition.equalTo('writer', '李白') // 查询writer == 李白  的数据
    condition.contains('type', '爱国') // 查询 type这个string里，包含爱国的 数据，即字符串匹配
    condition.contains('type', '爱国').and().equalTo('dynasty', '唐代') // 复合查询，查询唐代的爱国诗词

    return new Promise((resolve, reject) => {
      databaseZone.query(condition, (err: BusinessError, poemArray: Poem[]) => {
        if (err) {
          console.error(`查询失败，错误代码: ${err.code}, 错误信息: ${err.message}`);
          reject(err);
        } else {
          console.info(`查询成功，结果: ${JSON.stringify(poemArray)}`);
          resolve(poemArray);
        }
      });
    });
  } catch (err) {
    console.error(`捕获到错误: ${err.message}`);
    return undefined; // 确保函数返回 undefined
  }
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门视频，帮助大家在技术的道路上更进一步。

• 《鸿蒙 (OpenHarmony)开发学习视频》
• 《鸿蒙生态应用开发V2.0白皮书》
• 《鸿蒙 (OpenHarmony)开发基础到实战手册》
• OpenHarmony北向、南向开发环境搭建
• 《鸿蒙开发基础》
• 《鸿蒙开发进阶》
• 《鸿蒙开发实战》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿