HarmonyOS对象关系映射(Object Relational Mapping,ORM)数据库是一款基于SQLite的数据库框架,屏蔽了底层SQLite数据库的SQL操作,针对实体和关系提供了增删改查等一系列的面向对象接口。应用开发者不必再去编写复杂的SQL语句, 以操作对象的形式来操作数据库,提升效率的同时也能聚焦于业务开发。
基本概念
- 对象关系映射数据库的三个主要组件:
- 数据库:被开发者用@Database注解,且继承了OrmDatabase的类,对应关系型数据库。
- 实体对象:被开发者用@Entity注解,且继承了OrmObject的类,对应关系型数据库中的表。
- 对象数据操作接口:包括数据库操作的入口OrmContext类和谓词接口(OrmPredicate)等。
- 谓词
数据库中用来代表数据实体的性质、特征或者数据实体之间关系的词项,主要用来定义数据库的操作条件。对象关系映射数据库将SQLite数据库中的谓词封装成了接口方法供开发者调用。开发者通过对象数据操作接口,可以访问到应用持久化的关系型数据。
- 对象关系映射数据库
通过将实例对象映射到关系上,实现操作实例对象的语法,来操作关系型数据库。它是在SQLite数据库的基础上提供的一个抽象层。
- SQLite数据库
一款轻型的数据库,是遵守ACID的关系型数据库管理系统。
运作机制
对象关系映射数据库操作是基于关系型数据库操作接口完成的,实际是在关系型数据库操作的基础上又实现了对象关系映射等特性。因此对象关系映射数据库跟关系型数据库一样,都使用SQLite作为持久化引擎,底层使用的是同一套数据库连接池和数据库连接机制。
使用对象关系映射数据库的开发者需要先配置实体模型与关系映射文件。应用数据管理框架提供的类生成工具会解析这些文件,生成数据库帮助类,这样应用数据管理框架就能在运行时,根据开发者的配置创建好数据库,并在存储过程中自动完成对象关系映射。开发者再通过对象数据操作接口,如OrmContext接口和谓词接口等操作持久化数据库。
对象数据操作接口提供一组基于对象映射的数据操作接口,实现了基于SQL的关系模型数据到对象的映射,让用户不需要再和复杂的 SQL语句打交道,只需简单地操作实体对象的属性和方法。对象数据操作接口支持对象的增删改查操作,同时支持事务操作等。

默认配置
- 如果不指定数据库的日志模式,那么系统默认日志方式是WAL(Write Ahead Log)模式。
- 如果不指定数据库的落盘模式,那么系统默认落盘方式是FULL模式。
- HarmonyOS数据库使用的共享内存默认大小是2MB。
约束与限制
- 当应用使用对象关系映射数据库接口时,应用包和类的命名需要遵循典型的Java风格(小写包名,大驼峰类名)。
- HarmonyOS对象关系映射数据库是建立在HarmonyOS关系型数据库的基础之上的,所以关系型数据库的一些约束与限制请参考约束与限制。
- 此外当开发者建立实体对象类时,对象属性的类型可以在下表的类型中选择。不支持使用自定义类型。
类型名称 |
描述 |
初始值 |
---|---|---|
Integer |
封装整型 |
null |
int |
整型 |
0 |
Long |
封装长整型 |
null |
long |
长整型 |
0L |
Double |
封装双精度浮点型 |
null |
double |
双精度浮点型 |
0 |
Float |
封装单精度浮点型 |
null |
float |
单精度浮点型 |
0 |
Short |
封装短整型 |
null |
short |
短整型 |
0 |
String |
字符串型 |
null |
Boolean |
封装布尔型 |
null |
boolean |
布尔型 |
0 |
Byte |
封装字节型 |
null |
byte |
字节型 |
0 |
Character |
封装字符型 |
null |
char |
字符型 |
‘ ‘ |
Date |
日期类 |
null |
Time |
时间类 |
null |
Timestamp |
时间戳类 |
null |
Calendar |
日历类 |
null |
Blob |
二进制大对象 |
null |
Clob |
字符大对象 |
null |