鸿蒙端云一体化开发实战：云对象与云数据库应用

具体步骤可参考官方文档中的手动签名指南。

神器一：云对象 (Cloud Object)

告别繁琐的 HTTP 请求和 Axios 封装。云对象让你像调用本地类的方法一样调用云端逻辑。

云端实现

在 CloudProgram/cloudfunctions 下右键创建云对象，例如 id-generator。

生成的目录包含配置文件 function-config.json，其中 handler 指定入口模块，functionType 设为 1 表示云对象。

代码编写与普通 TypeScript 类无异，无需处理 req 和 res：

// CloudProgram/cloudfunctions/id-generator/idGenerator.ts
import * as crypto from 'crypto';

export class IdGenerator {
  // 生成 UUID 的方法
  randomUUID() {
    const uuid = crypto.randomUUID();
    console.info(`Generate random UUID: ${uuid}`);
    return { code: 0, desc: 'success', data: { uuid } };
  }

  // 获取列表的方法
  getList() {
    return [
      { id: 0, title: 'html', price: 10 },
      { id: 1, title: 'css', price: 20 }
    ];
  }
}

端侧调用

右击云对象，选择'生成调用接口'。DevEco Studio 会自动在端侧生成代理类 ImportObject.ts 和模型文件。

回到 entry/src/main/ets/pages/Index.ets，直接导入并使用：

// Application/entry/src/main/ets/pages/Index.ets
import { IdGenerator, importObject } from 'cloud_objects';

@Entry
@Component
struct Index {
  @State msg: string = 'hello world!'

  build() {
    Column() {
      Text(this.msg)
      Button("调用云对象")
        .onClick(async () => {
          // 1. 实例化云对象
          const idGenerator = importObject(IdGenerator)
          // 2. 像调本地方法一样调用云端逻辑
          idGenerator.randomUUID().then((res) => {
            console.log("云端返回的 UUID:", res.data.uuid)
            this.msg = res.data.uuid
          })
        })
        .width('100%')
        .height('100%')
        .justifyContent(FlexAlign.Center)
        .alignItems(HorizontalAlign.Center)
    }
  }
}

没有 URL，没有 HTTP Method，IDE 还能提供类型提示。底层通信由鸿蒙框架接管。

神器二：云数据库 (Cloud Database)

如果你不想折腾 SQL 或连接池，云数据库是基于对象模型的存储方案，支持端云数据同步。

1. 定义对象类型

右击 clouddb/objecttype 目录，新建云数据库对象类型。输入名称（如 objecttype1），确认后会生成 JSON 描述文件。

这里用 JSON 描述数据结构，无需编写 CREATE TABLE：

// CloudProgram/clouddb/objecttype/objecttype1.json
{
  "objectTypeName": "objecttype1",
  "fields": [
    { "fieldName": "author", "fieldType": "String", "notNull": true, "belongPrimaryKey": true },
    { "fieldName": "shadowFlag", "fieldType": "Boolean", "notNull": true, "defaultValue": true },
    { "fieldName": "bookName", "fieldType": "String" },
    { "fieldName": "id", "fieldType": "Integer" },
    { "fieldName": "price", "fieldType": "Double" },
    { "fieldName": "publish", "fieldType": "Date" }
  ],
  "indexes": [
    { "indexName": "id_Index", "indexList": [{ "fieldName": "id", "sortType": "ASC" }] },
    { "indexName": "price_index", "indexList": [{ "fieldName": "price", "sortType": "DESC" }] }
  ],
  "permissions": [
    { "role": "World", "rights": ["Read"] },
    { "role": "Authenticated", "rights": ["Read", "Upsert"] },
    { "role": "Creator", "rights": ["Read", "Upsert", "Delete"] },
    { "role": "Administrator", "rights": ["Read", "Upsert", "Delete"] }
  ]
}

2. 部署与同步

右击 clouddb 目录选择'部署云数据库'，或在菜单栏选择'工具 > CloudDev'进入控制台。

部署完成后，需在端侧引入生成的 Client Model 才能访问。

添加初始数据条目（d_objecttype1.json）：

{
  "cloudDBZoneName": "objecttype1",
  "objectTypeName": "objecttype1",
  "objects": [
    { "author": "Nancy", "shadowFlag": true, "bookName": "My Favorite book", "id": 10, "price": 10.5, "publish": 20241212 },
    { "author": "Peter", "shadowFlag": false, "bookName": "Your First English Book", "id": 20, "price": 20.5, "publish": 20251212 }
  ]
}

3. 端侧查询

确保 module.json5 中已申请网络权限：

"requestPermissions": [
  { "name": "ohos.permission.INTERNET" }
]

在端侧代码中直接查询：

// Application/entry/src/main/ets/pages/Index.ets
import { cloudDatabase } from '@kit.CloudFoundationKit';
import { objecttype1 } from './objecttype1';

Button("查询云数据库")
  .onClick(async () => {
    try {
      // 1. 获取数据库区域
      let databaseZone = cloudDatabase.zone('objecttype1');
      // 2. 构造查询条件
      let condition = new cloudDatabase.DatabaseQuery(objecttype1);
      // 3. 直接查询
      this.list = await databaseZone.query(condition);
      console.log("查询结果:", JSON.stringify(this.list));
    } catch (err) {
      console.error("数据库异常:", err);
    }
  })

权限控制在 JSON 配置中即可，普通用户只能读，管理员可写删，无需额外编写 API。

方案评估

优势

1. 极速开发：一人即一支队伍，无需等待后端排期，想法验证极快。
2. 统一语言：端侧 ArkTS，云侧 TS/JS，思维无需切换。
3. 免运维：Serverless 架构，不用担心服务器宕机或扩容。

局限

1. 厂商绑定：迁移到 AWS 或阿里云需重构云侧代码。
2. 冷启动：云函数长时间未调用，首次可能有几百毫秒延迟。
3. 复杂业务：超复杂事务处理或海量关联查询，传统微服务架构目前仍更稳健。

总结

对于快速上线 App、小程序或独立开发者而言，鸿蒙端云一体化是提升生产力的利器。它砍掉了繁琐的胶水代码和运维工作，让你专注于业务逻辑。打开 DevEco Studio，新建一个端云一体化项目，体验一把全栈开发的快感吧。