HarmonyOS 数据库系列之关系型数据库

数据库 其他数据库 OpenHarmony
移动端开发,数据存储是非常重要的,鸿蒙也不例外,说到数据存储,首要的就是数据库了,数据库的存储机制是否完善,提供的功能是否简单方便,直接影响开发者的开发速度和性能。

[[421539]]

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

前言

移动端开发,数据存储是非常重要的,鸿蒙也不例外,说到数据存储,首要的就是数据库了,数据库的存储机制是否完善,提供的功能是否简单方便,直接影响开发者的开发速度和性能。

作为鸿蒙开发者,最近就深入学习了鸿蒙的数据库知识点,了解了存储机制并且尝试了使用,发现鸿蒙的数据库真的做到了应有尽有,操作还简单的地步。

概念

先来看看 鸿蒙的 关系型数据库(Relational Database,RDB) 概念。

鸿蒙的RDB 是一种基于关系模型来管理数据的数据库。

HarmonyOS关系型数据库基于SQLite组件提供了一套完整的对本地数据库进行管理的机制,对外提供了一系列的增、删、改、查接口,也可以直接运行用户输入的SQL语句来满足复杂的场景需要。HarmonyOS提供的关系型数据库功能更加完善,查询效率更高。

概念中一句话很重要,HarmonyOS提供的关系型数据库功能更加完善,查询效率更高。看到这里我当时是非常激动的,作为开发者难道不是最希望 使用的api在什么情况下都适用吗?

下面看看鸿蒙数据库的运作机制,了解机制才能了解数据库开发的核心,也有利于扩展。

运作机制

HarmonyOS关系型数据库对外提供通用的操作接口,底层使用SQLite作为持久化存储引擎,支持SQLite具有的所有数据库特性,包括但不限于事务、索引、视图、触发器、外键、参数化查询和预编译SQL语句。

关系型数据库运作机制:

HarmonyOS 数据库系列之关系型数据库-鸿蒙HarmonyOS技术社区

看到上面的鸿蒙数据库的运行机制 不难发现,主要工作还是在framework层做的封装,然后调用JNI,使用的还是SQLite组件,不管 底层怎么做的开发,只要功能完善,体验到位,鸿蒙应用端直接使用不是很香吗?

约束与限制

1、数据库中连接池的最大数量是4个,用以管理用户的读写操作。

连接池的数量是有限制的 ,最大时4个,不过4个已经足够使用了。

2、为保证数据的准确性,数据库同一时间只能支持一个写操作。

同一时间支持一个写操作时非常重要的,为了防止数据存储的正确性,鸿蒙做了这一个限制,但是作为多年的移动端开发者,一般这种多操作或者大数据操作,都会使用多线程,异步线程,或者放在线程池中,这样就更完美了。

数据库操作DataAbility

鸿蒙在创建类的时候 有一个 DataAbility,不知道各位开发者使用过了没,其实这个就是为了数据库操作尔来的。

添加步骤很简单:

添加类的时候 选择Empty DataAbility即可。

一、 配置:

添加类后 会自动生成如下配置:

  1.   "permissions": [ 
  2.     "com.huawei.codelab.DataAbilityShellProvider.PROVIDER" 
  3.   ], 
  4.   "name""com.hadiidbouk.databasemanager.database.DataAbility"
  5.   "icon""$media:icon"
  6.   "description""$string:dataability_description"
  7.   "type""data"
  8.   "uri""dataability://com.huawei.codelab.PersonDataAbility" 

 1、操作数据库需要权限信息

  1. "permissions": [ 
  2.         "com.huawei.codelab.DataAbilityShellProvider.PROVIDER" 
  3.       ] 

 2、需要配置url,url很重要,在进行数据库表操作的时候 需要保持一致

二 、DataAbility操作内容

默认创建的DataAbility类会自动重写 数据库的增,删,改,查 几种操作的函数。可以看下面:

  1. public class DataAbility extends Ability { 
  2.     private static final HiLogLabel LABEL_LOG = new HiLogLabel(3, 0xD001100, "Demo"); 
  3.     private static final String DB_NAME = "persondataability.db"
  4.     private static final String DB_TAB_NAME = "person"
  5.     private static final String DB_COLUMN_PERSON_ID = "id"
  6.     private static final String DB_COLUMN_NAME = "name"
  7.     private static final String DB_COLUMN_GENDER = "gender"
  8.     private static final String DB_COLUMN_AGE = "age"
  9.     private static final int DB_VERSION = 1; 
  10.  
  11.     private StoreConfig config = StoreConfig.newDefaultConfig(DB_NAME); 
  12.     private RdbStore rdbStore; 
  13.     private RdbOpenCallback rdbOpenCallback = new RdbOpenCallback() { 
  14.         @Override 
  15.         public void onCreate(RdbStore store) { 
  16.             store.executeSql("create table if not exists " 
  17.                     + DB_TAB_NAME + " (" 
  18.                     + DB_COLUMN_PERSON_ID + " integer primary key, " 
  19.                     + DB_COLUMN_NAME + " text not null, " 
  20.                     + DB_COLUMN_GENDER + " text not null, " 
  21.                     + DB_COLUMN_AGE + " integer)"); 
  22.         } 
  23.         @Override 
  24.         public void onUpgrade(RdbStore store, int oldVersion, int newVersion) { 
  25.         } 
  26.     }; 
  27.  
  28.     @Override 
  29.     public void onStart(Intent intent) { //创建数据库操作 
  30.         super.onStart(intent); 
  31.         HiLog.info(LABEL_LOG, "DataAbility onStart"); 
  32.         DatabaseHelper databaseHelper = new DatabaseHelper(this); 
  33.         rdbStore = databaseHelper.getRdbStore(config, DB_VERSION, rdbOpenCallback, null); 
  34.     } 
  35.  
  36. // 数据库 查询操作 
  37.     @Override 
  38.     public ResultSet query(Uri uri, String[] columns, DataAbilityPredicates predicates) { 
  39.         RdbPredicates rdbPredicates = DataAbilityUtils.createRdbPredicates(predicates, DB_TAB_NAME); 
  40.         ResultSet resultSet = rdbStore.query(rdbPredicates, columns); 
  41.         if (resultSet == null) { 
  42.             HiLog.info(LABEL_LOG, "resultSet is null"); 
  43.         } 
  44.         return resultSet; 
  45.     } 
  46.  
  47. // 数据库 插入操作 
  48.     @Override 
  49.     public int insert(Uri uri, ValuesBucket value) { 
  50.         HiLog.info(LABEL_LOG, "DataAbility insert"); 
  51.         String path = uri.getLastPath(); 
  52.         if (!"person".equals(path)) { 
  53.             HiLog.info(LABEL_LOG, "DataAbility insert path is not matched"); 
  54.             return -1; 
  55.         } 
  56.         ValuesBucket values = new ValuesBucket(); 
  57.         values.putInteger(DB_COLUMN_PERSON_ID, value.getInteger(DB_COLUMN_PERSON_ID)); 
  58.         values.putString(DB_COLUMN_NAME, value.getString(DB_COLUMN_NAME)); 
  59.         values.putString(DB_COLUMN_GENDER, value.getString(DB_COLUMN_GENDER)); 
  60.         values.putInteger(DB_COLUMN_AGE, value.getInteger(DB_COLUMN_AGE)); 
  61.         int index = (int) rdbStore.insert(DB_TAB_NAME, values); 
  62.         DataAbilityHelper.creator(this, uri).notifyChange(uri); 
  63.         return index
  64.     } 
  65.  
  66. // 数据库 删除操作 
  67.     @Override 
  68.     public int delete(Uri uri, DataAbilityPredicates predicates) { 
  69.         RdbPredicates rdbPredicates = DataAbilityUtils.createRdbPredicates(predicates, DB_TAB_NAME); 
  70.         int index = rdbStore.delete(rdbPredicates); 
  71.         HiLog.info(LABEL_LOG, "delete: " + index); 
  72.         DataAbilityHelper.creator(this, uri).notifyChange(uri); 
  73.         return index
  74.     } 
  75.  
  76. // 数据库 更新操作 
  77.     @Override 
  78.     public int update(Uri uri, ValuesBucket value, DataAbilityPredicates predicates) { 
  79.         RdbPredicates rdbPredicates = DataAbilityUtils.createRdbPredicates(predicates, DB_TAB_NAME); 
  80.         int index = rdbStore.update(value, rdbPredicates); 
  81.         HiLog.info(LABEL_LOG, "update: " + index); 
  82.         DataAbilityHelper.creator(this, uri).notifyChange(uri); 
  83.         return index
  84.     } 
  85.  
  86.     @Override 
  87.     public FileDescriptor openFile(Uri uri, String mode) { 
  88.         return null
  89.     } 
  90.  
  91.     @Override 
  92.     public String[] getFileTypes(Uri uri, String mimeTypeFilter) { 
  93.         return new String[0]; 
  94.     } 
  95.  
  96.  
  97.     @Override 
  98.     public PacMap call(String method, String arg, PacMap extras) { 
  99.         return null
  100.     } 
  101.  
  102.     @Override 
  103.     public String getType(Uri uri) { 
  104.         return null
  105.     } 

1、添加DataAbility 会自动重写四个接口函数,有关数据库的增,删,改,查。

2、该DataAbility在运行项目后会自行执行onStart 方法 进行数据库及其数据表的创建工作

3、通过RdbPredicates 数据库进行数据库关系的关联进行操作。

三 、数据库操作

这里的数据库操作 时开发需求做的数据库操作,可以通过自己的需求来开发数据库的调用操作,最终还是通过使用 DataAbility直接调用系统的数据库。

  1. public class DataBaseAbilitySlice extends AbilitySlice { 
  2.     private static final HiLogLabel LABEL_LOG = new HiLogLabel(3, 0xD001100, "Demo"); 
  3.     private DataAbilityHelper databaseHelper; 
  4.  
  5.     private static final String BASE_URI = "dataability:///com.huawei.codelab.PersonDataAbility"
  6.     private static final String DATA_PATH = "/person"
  7.     private static final String DB_COLUMN_PERSON_ID = "id"
  8.     private static final String DB_COLUMN_NAME = "name"
  9.     private static final String DB_COLUMN_GENDER = "gender"
  10.     private static final String DB_COLUMN_AGE = "age"
  11.  
  12.     @Override 
  13.     public void onStart(Intent intent) { 
  14.         super.onStart(intent); 
  15.         super.setUIContent(ResourceTable.Layout_ability_data_base); 
  16.         databaseHelper = DataAbilityHelper.creator(this); 
  17.  
  18.         Text text = (Text)findComponentById(ResourceTable.Id_text_helloworld); 
  19.         text.setClickedListener(new Component.ClickedListener() { 
  20.             @Override 
  21.             public void onClick(Component component) { 
  22.                 query(); 
  23.                 insert(100, "Tom""male", 20); 
  24.                 insert(101, "Jerry""female", 21); 
  25.                 insert(102, "Bob""male", 22); 
  26.                 query(); // 查看插入后的结果 
  27.                 update(); 
  28.                 query(); // 查看更新后的结果 
  29.                 delete(); 
  30.                 query(); // 查看删除后的结果 
  31.             } 
  32.         }); 
  33.     } 
  34.  
  35.     @Override 
  36.     public void onActive() { 
  37.         super.onActive(); 
  38.     } 
  39.  
  40.     @Override 
  41.     public void onForeground(Intent intent) { 
  42.         super.onForeground(intent); 
  43.     } 
  44.  
  45.     private void insert(int id, String name, String gender, int age) { 
  46.         ValuesBucket valuesBucket = new ValuesBucket(); 
  47.         valuesBucket.putInteger(DB_COLUMN_PERSON_ID, id); 
  48.         valuesBucket.putString(DB_COLUMN_NAME, name); 
  49.         valuesBucket.putString(DB_COLUMN_GENDER, gender); 
  50.         valuesBucket.putInteger(DB_COLUMN_AGE, age); 
  51.         try { 
  52.             if (databaseHelper.insert(Uri.parse(BASE_URI + DATA_PATH), valuesBucket) != -1) { 
  53. //            if (databaseHelper.insert(Uri.parse(BASE_URI + DATA_PATH), valuesBucket) != -1) { 
  54.                 HiLog.info(LABEL_LOG, "insert successful"); 
  55.             } 
  56.         } catch (DataAbilityRemoteException | IllegalStateException exception) { 
  57.             HiLog.error(LABEL_LOG, "insert: dataRemote exception|illegalStateException"); 
  58.         } 
  59.     } 
  60.  
  61.     private void delete() { 
  62.         DataAbilityPredicates predicates = new DataAbilityPredicates() 
  63.                 .equalTo(DB_COLUMN_PERSON_ID, 100); 
  64.         try { 
  65.             if (databaseHelper.delete(Uri.parse(BASE_URI + DATA_PATH), predicates) != -1) { 
  66.                 HiLog.info(LABEL_LOG, "delete successful"); 
  67.             } 
  68.         } catch (DataAbilityRemoteException | IllegalStateException exception) { 
  69.             HiLog.error(LABEL_LOG, "delete: dataRemote exception | illegalStateException"); 
  70.         } 
  71.     } 
  72.  
  73.     private void update() { 
  74.         DataAbilityPredicates predicates = new DataAbilityPredicates(); 
  75.         predicates.equalTo(DB_COLUMN_PERSON_ID, 102); 
  76.         ValuesBucket valuesBucket = new ValuesBucket(); 
  77.         valuesBucket.putString(DB_COLUMN_NAME, "ZhangSanPlus"); 
  78.         valuesBucket.putInteger(DB_COLUMN_AGE, 28); 
  79.         try { 
  80.             if (databaseHelper.update(Uri.parse(BASE_URI + DATA_PATH), valuesBucket, predicates) != -1) { 
  81.                 HiLog.info(LABEL_LOG, "update successful"); 
  82.             } 
  83.         } catch (DataAbilityRemoteException | IllegalStateException exception) { 
  84.             HiLog.error(LABEL_LOG, "update: dataRemote exception | illegalStateException"); 
  85.         } 
  86.     } 
  87.  
  88.     private void query() { 
  89.         String[] columns = new String[] {DB_COLUMN_PERSON_ID, 
  90.                 DB_COLUMN_NAME, DB_COLUMN_GENDER, DB_COLUMN_AGE}; 
  91.         // 构造查询条件 
  92.         DataAbilityPredicates predicates = new DataAbilityPredicates(); 
  93.         predicates.between(DB_COLUMN_AGE, 15, 40); // 查询时间段 
  94.         try { 
  95.             ResultSet resultSet = databaseHelper.query(Uri.parse(BASE_URI + DATA_PATH), 
  96.                     columns, predicates); 
  97.             if (resultSet == null || resultSet.getRowCount() == 0) { 
  98.                 HiLog.info(LABEL_LOG, "query: resultSet is null or no result found"); 
  99.                 return
  100.             } 
  101.             resultSet.goToFirstRow(); 
  102.             do { 
  103.                 int id = resultSet.getInt(resultSet.getColumnIndexForName(DB_COLUMN_PERSON_ID)); 
  104.                 String name = resultSet.getString(resultSet.getColumnIndexForName(DB_COLUMN_NAME)); 
  105.                 String gender = resultSet.getString(resultSet.getColumnIndexForName(DB_COLUMN_GENDER)); 
  106.                 int age = resultSet.getInt(resultSet.getColumnIndexForName(DB_COLUMN_AGE)); 
  107.                 HiLog.info(LABEL_LOG, "query: Id :" + id + " Name :" + name + " Gender :" + gender + " Age :" + age); 
  108.             } while (resultSet.goToNextRow()); 
  109.         } catch (DataAbilityRemoteException | IllegalStateException exception) { 
  110.             HiLog.error(LABEL_LOG, "query: dataRemote exception | illegalStateException"); 
  111.         } 
  112.     } 

1、数据插入 使用 对象类 ValuesBucket

2、使用 DataAbilityPredicates 实例 进行数据查询的条件设置

到此有关数据库的关系型数据库操作 基本就完成了,是不是非常,非常简单,可以直接拿来主义 验证一下。

想了解更多内容,请访问:

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com

 

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2021-09-03 15:41:00

鸿蒙HarmonyOS应用

2018-07-18 09:16:39

关系型非关系型数据库

2020-12-29 11:26:22

鸿蒙HarmonyOS数据库

2010-12-10 10:17:21

关系型数据库

2022-06-13 08:30:01

数据库管理系统

2017-03-17 14:44:04

关系型数据库原理

2013-06-28 11:28:21

Facebook数据库大数据

2021-01-26 13:31:48

数据库关系型数据库冗余

2022-12-27 08:38:45

关系型数据库设计

2023-05-22 16:10:51

动态共享包数据库

2016-08-23 14:25:19

MySQL约束数据库

2021-07-28 14:40:57

鸿蒙HarmonyOS应用

2023-05-20 08:11:55

2022-07-27 08:32:01

数据库MySQL

2013-04-26 16:18:29

大数据全球技术峰会

2018-03-26 12:58:52

数据库OracleMySQL

2017-01-04 16:18:05

非数据库NoSql关系型数据库

2011-06-07 17:14:15

关系型数据库压缩技术

2011-04-13 16:13:53

云计算关系型数据库

2013-01-08 14:24:23

点赞
收藏

51CTO技术栈公众号