鸿蒙项目云捐助第十五讲云数据库的初步使用
在华为云技术使用中,前面使用了云函数,接下来看一下华为云技术中的另外一个技术云数据库的使用。
一、云数据库的创建
这里使用华为云数据库也需要登录到AppGallery Connect平台中,点击进入到之前创建的云项目myjuanproject的项目信息目录,在左侧会显示出“云数据库”的选项,点击左侧的“云数据库”选项,右侧点击“立即开通”按钮。也就是云数据使用也里需要在华为云中进行开通的。操作如下图所示。
开通后在云数据库界面中点击“新增”来创建一个应用的数据库,如下图所示。
这里可以先创建用户表, 实现用户的登录和注册功能。点击点击“新增”按钮后弹出的界面如下图所示。
在这个界面中输入应用数据库的名称,在登录和注册逻辑中需要一个数据表myuser,这里输入应用数据库的名称myuser,如下图所示。
点击下一步进入到字段设置的界面,这里的用户表myuser设置3个字段,一个是用户名username,一个是密码password,还有一个性别sex,加入性别可以在应用中根据性别决定不同的头像。具体字段设置如下图所示。
这里的username用户名设置为String字符串类型,这里的password密码设置为String字符串类型,这里的sex性别设置为Boolean布尔类型,当sex值为true表示男性,当sex值为false表示女性。同时需要设置主键,为了保证用户名不重复,username字段设置为主键和非空,相关的字段配置建立后,点击“下一步”进入到下一个页面。如下图所示。
这个页面中需要指定数据库表查询的索引,这里以主键的username建立索引,并指定用户索引的方式为ASC的升序排列。设置成功后,点击“下一步”进入到下一个页面,如下图所示。
这里进入操作用户表myuser的权限,为了保证每个用户都可以进行注册和登录,也就是对用户表增删改查的处理,这里把用户表myuser的权限设置为增删改查的全部权限,设置成功后“确定”即可。
这里才完成了华为云数据使用的第一步数据类型建立成功。
接下来进行华为云数据库第二步的操作建立云存储区。这里需要点击
“存储区”,如下图所示。
进入存储区的选项卡后,点击“新增”按钮用来建立存储区,这里点击“新增”按钮后出现的界面如下图所示。
这里输入名字为one的存储区,存储区与后面的开发有一定的关系,其表征了数据在服务器存储的分区。输入名称one后,直接确定即可。
这样也完成了华为云数据库的第二步操作。接下来进行华为云数据库的第三步操作,建立数据表中的数据,这里点击“数据”的选项卡。如下图所示。
进入到“数据”的选项卡后,从存储名称的下拉框中选择之前创建的存储区“One”,在对象类型的下拉框中选择之前创建的“myuser”数据表,然后点击“数据”的选项卡界面中最右边的“新增”按钮,出现的界面如下图所示。
这里可以输入当前数据表myuser的数据,输入其中的数据后直接“确定”即可,如下图所示。
这里输入了一条数据,用户名username为admin,密码password为123456,性别sex为true,表示男性。这样在对应的存储区,在对应的数据类型中存在了一条数据,这条数据可以点击“数据”选项卡中的查看得到结果。如下图所示。
操作到这里,我们华为云的云数据库界面操作宣告结束。操作结束后的界面如下所示。
云端界面操作结束后,在开发过程中,需要把创建的数据库相关内容导出到文件中。这里回到“对象类型”的选项卡,点击刚刚创建的对象类型myuser前面的复选框,然后点击“对象类型”的选项卡界面右侧的“导出”按钮。如下图所示。
点击“导出”按钮后在弹出的对话框中需要首先导出“js格式”,如下图所示。
这里先点击导出的格式是“js格式”,然后点击导出的场景为“客户端”,点击“确定”实现js格式文件的导出。
接下来还需要导出json格式的文件,继续点击“对象类型”的选项卡界面右侧的“导出”按钮。在弹出的界面中选择“json格式”,如下图所示。
这里点击“json格式”,然后点击“确定”即可。
二、华为云数据库的开发
之前已下载两种不同格式的文件,一个是json格式的华为云数据库文件,一个是js格式的华为云数据库客户端文件。需要把下载的文件在鸿蒙的项目中进行分配。如下图所示。
这里把导出的json文件改名为mytest.json,并且放在main主文件夹下的rawfile文件夹中,接下来还需要创建一个model文件夹,把下载的js格式的客户端文件拷贝到这里。如下图所示。
这里在main主文件夹下ets目录中新建一个model的文件夹,在model文件夹中存放之前华为云AppGallery Connect下载的myuser.js的js格式客户端文件。有了文件后,在之前开发云函数的组件MyComponent中引入json文件,如下图所示。
导入文件后,也就是导入了华为云数据库myuser的数据类型,根据类型就可以使用cloud.database方法连接远程华为云数据库,代码如下所示。
这里我们在MyComponent组件中添加一个按钮,按钮作用是测试云数据库的连接,点击后进行云数据库的定义,在定义中使用cloud.database方法,在cloud.database方法中也需要传入参数,一个参数是存储区zoneName,其值为one,一个参数是ObjectTypeInfo,也就是对象数据类型,其值为导入的MyUser对象。这样,代码中定义了数据库,相当于配置数据库成功,接下来需要对数据库进行连接和数据查询,这里再导入之前华为云平台导出的js格式的文件,如下图所示。
这里在导入用到了不同大小写的MyUser ,防止这种做法出现问题,这里把之前的MyUser改成MyUserInfo以区别不同的导入对象。如下图所示。
接下来完善华为云数据库连接查询的代码,如下图所示。
在代码中,通过定义的数据库database进行myuser的collection数据集的收集,其后跟上query()方法查询数据库的所有数据,最后get()方法取出查询结果。
在代码的最后输出result的结果,这里使用JSON.stringify进行输出结果的JSON数据化。
需要注意的是,代码中的数据库collection(myuser).query().get需要使用异步处理,不然得不到结果,这里在database.collection(myuser).query().get()语句前添加await异步处理,这样就需要在onClick点击事件中使用async的导步处理。代码修改如下图所示。
完成代码后,启动模拟器,再运行应用,在应用中的“测试云数据库的连接”按钮上进行点击,在DevEco Studio编辑器的Log日志中可以看到输出的查询云数据库结果,如下图所示。
华为云数据库和云函数的使用测试成功后,就可以把鸿蒙云捐助项目变成与华为云融合的云捐助项目,后续会带来云数据库登录注册及捐赠功能的实现,欢迎关注。