HarmonyOS NEXT 中级开发笔记：旅行计划应用的数据库设计与操作实践

最新推荐文章于 2025-11-25 07:41:15 发布

原创最新推荐文章于 2025-11-25 07:41:15 发布 · 158 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #笔记 #华为

最近在尝试开发一款基于HarmonyOS NEXT的旅行计划应用，重点研究了HarmonyOS Design规范下的数据库设计与操作。在此记录一些关键实现思路和代码片段，供同行参考指正。

数据模型设计

遵循HarmonyOS Design的简洁性原则，将旅行计划核心数据分为三个实体：

Trip（行程主表）
Schedule（每日计划）
Checkpoint（打卡点）

使用@Database注解定义RDB关系型数据库（API12兼容写法）：

typescript

// database/TripDatabase.ts  
import { relationalStore } from '@ohos.data.relationalStore';  

@relationalStore.Database({  
  version: 1,  
  entities: [Trip, Schedule, Checkpoint],  
  autoCreate: true  
})  
export class TripDatabase extends relationalStore.RdbDatabase {  
  // 数据库初始化逻辑  
}

表结构实现

按HarmonyOS Design的"内容优先"原则设计字段：

typescript

// entity/Trip.ts  
export class Trip {  
  @relationalStore.Column({  
    fieldName: 'trip_name',  
    isIndex: true  
  })  
  name: string = '';  

  @relationalStore.Column({ fieldName: 'start_date' })  
  startDate: number = 0;  // 时间戳存储  

  @relationalStore.Column({ fieldName: 'cover_uri' })  
  coverUri: string = ''; // 封面图URI  
}

核心操作封装

采用HarmonyOS推荐的异步Promise风格：

typescript

// service/TripService.ts  
async function addNewTrip(trip: Trip): Promise<void> {  
  const rdb = await getRdbContext();  
  const bucket: relationalStore.Bucket = rdb.bucket;  
  await bucket.insert(trip);  
}  

async function queryTripsByDate(start: number, end: number): Promise<Array<Trip>> {  
  const predicate = relationalStore.Predicates.between('start_date', start, end);  
  return await bucket.query(Trip, predicate);  
}

开发体会