前言

上文介绍了ObjectBox，属于神器，可是做为一个合格的码农，上的了厅堂，下得了猪圈，神器好用，菜刀也是要会使的嘛，这篇咱们就来介绍下鸿蒙系统的数据库如何使用鸿蒙的关系型数据库是基于SQLite的实现，官方提供了关系型数据库实现和基于对象的关系型数据库两种数据库操做，本文会指导你们如何分别使用这两种数据库操做，来对数据库进行简单的CRUD操做。数据库

关系型数据库

关系型数据库（Relational Database，RDB）是一种基于关系模型来管理数据的数据库。HarmonyOS关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制，对外提供了一系列的增、删、改、查接口，也能够直接运行用户输入的SQL语句来知足复杂的场景须要。运做机制如图：网络

一、建立数据库

//设置数据库为RdbStore.db
StoreConfig config = StoreConfig.newDefaultConfig("RdbStore.db");    
DatabaseHelper helper = new DatabaseHelper(getContext());
RdbStore rdbStore = helper.getRdbStore(config, 1, new RdbOpenCallback() {
    @Override
    public void onCreate(RdbStore rdbStore) {
        //建立表
        rdbStore.executeSql("create table if not exists User(userId integer primary key autoincrement,userName text)");
        //更多建表语句能够在这里写
    }

    @Override
    public void onUpgrade(RdbStore rdbStore, int i, int i1) {
        //升级数据库操做
    }
});

二、插入数据

//使用键值对方式插入数据库rdbCreateDb()获取的就是建立的时候生成的rdbStore
ValuesBucket values = new ValuesBucket();
values.putInteger("userId",1);
values.putString("userName","name1");
long id = rdbCreateDb().insert("User",values);

//使用最原始的sql语句插入数据
rdbCreateDb().executeSql("insert into User (userId,userName) values (2,'name2')");

三、删除数据

RdbPredicates rdbPredicates = new RdbPredicates("User").equalTo("userName","name1");
int i = rdbCreateDb().delete(rdbPredicates);

四、查询数据

String[] columns = new String[]{"userId","userName"};
RdbPredicates rdbPredicates = new RdbPredicates("User");//构建查询谓词
ResultSet resultSet = rdbCreateDb().query(rdbPredicates,columns);
while (resultSet.goToNextRow()){
    int userId = resultSet.getInt(resultSet.getColumnIndexForName("userId"));
    String userName = resultSet.getString(resultSet.getColumnIndexForName("userName"));
    HiLog.warn(new HiLogLabel(HiLog.LOG_APP, 0, "===demo==="), "查询到userId=" + userId + "  userName=" +userName);
}

五、修改数据

RdbPredicates rdbPredicates = new RdbPredicates("User").equalTo("userName","name2");
ValuesBucket values = new ValuesBucket();
values.putString("userName","name3");
//更新数据
rdbCreateDb().update(values,rdbPredicates);

增删改查操做均可以经过rdbStore的executeSql方法，直接执行sql语句执行。语句语法采用SQLite的语法。app

对象关系型数据库

HarmonyOS对象关系映射（Object Relational Mapping，ORM）数据库是一款基于SQLite的数据库框架，屏蔽了底层SQLite数据库的SQL操做，针对实体和关系提供了增删改查等一系列的面向对象接口。应用开发者没必要再去编写复杂的SQL语句，以操做对象的形式来操做数据库，提高效率的同时也能聚焦于业务开发。运做机制如图：框架

一、环境配置

一、添加相应的jar包到模块libs里面，相关文件能够在demo中找到。ide

二、在模块的build.gradle中的对应添加注解引用gradle

//开启注解
ohos {
    compileOptions {
        annotationEnabled true
    }
}

//添加注解处理引用
dependencies {
    annotationProcessor files("./libs/orm_annotations_java.jar", "./libs/orm_annotations_processor_java.jar")
}

二、初始化数据库配置

一、新建数据库实现类

//entities里放置的是表对应的javabean，version对应数据库版本
@Database(entities = {OrmUser.class}, version = 1)
public abstract class OrmDBTest extends OrmDatabase {
    @Override
    public RdbOpenCallback getHelper() {
        return new RdbOpenCallback() {
            @Override

            public void onCreate(RdbStore rdbStore) {
                //建立成功后执行操做
            }

            @Override
            public void onUpgrade(RdbStore rdbStore, int oldVersion, int newVersion) {
               //数据库升级须要执行的操做
            }
        };
    }
}

二、新建表对应的JavaBean

//对应的数据库表名写在注解里，另外记得get/set要写齐全
@Entity(tableName = "OrmUser")
public class OrmUser extends OrmObject {
    @PrimaryKey(autoGenerate = true)
    private int id;
    private int userId;
    private String userName;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public int getUserId() {
        return userId;
    }
    public void setUserId(int userId) {
        this.userId = userId;
    }
    public String getUserName() {
        return userName;
    }
    public void setUserName(String userName) {
        this.userName = userName;
    }
}

三、ORM对数据库的基本操做

一、建立数据库上下文操做对象

private OrmContext ormCreateDb() {
    DatabaseHelper databaseHelper = new DatabaseHelper(getContext());
    OrmContext ormContext = databaseHelper.getOrmContext("OrmDBTest", "OrmDBTest.db", OrmDBTest.class);
    return ormContext;
}

二、增

OrmUser ormUser = new OrmUser();
ormUser.setUserId(1);
ormUser.setUserName("name1");
boolean isSuccess = ormCreateDb().insert(ormUser);
ormCreateDb().flush();

三、查

//查询userId = 1的数据
OrmPredicates ormPredicates = ormCreateDb().where(OrmUser.class).equalTo("userId","1");
List<OrmUser> ormUsers =  ormCreateDb().query(ormPredicates);

四、改

//将查询出来的数据值修改后更新到数据库
OrmUser ormUser = ormQuery();
if (ormUser == null){
    return;
}
ormUser.setUserName("name2");
ormCreateDb().update(ormUser);
ormCreateDb().flush();

五、删

//将查询出来的数据值从数据库中删除
OrmUser ormUser = ormQuery();
if (ormUser == null){
    return;
}
ormCreateDb().delete(ormUser);
ormCreateDb().flush();

总结

数据库中链接池的最大数量是4个，同一时间只能支持一个写操做！对象关系型数据的数据库类型只支持基础数据类型及Date、Time、Timestamp、Calendar、Blob(二进制大对象)、Clob（字符大对象）文中相关的代码在git：https://github.com/maolinnan/HarmonyosClass

这是本系列的第五篇，后面还会为你们带来更多的鸿蒙干货，敬请期待......。

若是文章对您有一点启发的话，但愿您能点个赞，来一波关注。

鸿蒙开发实战系列之五：鸿蒙系统原生数据库

前言