鴻蒙OS 對象關(guān)系映射數(shù)據(jù)庫開發(fā)指導(dǎo)

場景介紹

關(guān)系型數(shù)據(jù)庫是在 SQLite 基礎(chǔ)上實(shí)現(xiàn)的本地?cái)?shù)據(jù)操作機(jī)制，提供給用戶無需編寫原生 SQL 語句就能進(jìn)行數(shù)據(jù)增刪改查的方法，同時(shí)也支持原生 SQL 操作。

接口說明

數(shù)據(jù)庫的創(chuàng)建和刪除

關(guān)系型數(shù)據(jù)庫提供了數(shù)據(jù)庫創(chuàng)建方式，以及對應(yīng)的刪除接口，涉及的 API 如下所示。

數(shù)據(jù)庫的加密

關(guān)系型數(shù)據(jù)庫提供數(shù)據(jù)庫加密的能力，創(chuàng)建數(shù)據(jù)庫時(shí)傳入指定密鑰、創(chuàng)建加密數(shù)據(jù)庫，后續(xù)打開加密數(shù)據(jù)庫時(shí)，需要傳入正確密鑰。

數(shù)據(jù)庫的增刪改查

關(guān)系型數(shù)據(jù)庫提供本地?cái)?shù)據(jù)增刪改查操作的能力，相關(guān) API 如下所示。

• 新增

關(guān)系型數(shù)據(jù)庫提供了插入數(shù)據(jù)的接口，通過 ValuesBucket 輸入要存儲(chǔ)的數(shù)據(jù)，通過返回值判斷是否插入成功，插入成功時(shí)返回最新插入數(shù)據(jù)所在的行號(hào)，失敗則返回 -1。

• 更新

調(diào)用更新接口，傳入要更新的數(shù)據(jù)，并通過AbsRdbPredicates 指定更新條件。該接口的返回值表示更新操作影響的行數(shù)。如果更新失敗，則返回0。

• 刪除

調(diào)用刪除接口，通過 AbsRdbPredicates 指定刪除條件。該接口的返回值表示刪除的數(shù)據(jù)行數(shù)，可根據(jù)此值判斷是否刪除成功。如果刪除失敗，則返回 0。

• 查詢

關(guān)系型數(shù)據(jù)庫提供了兩種查詢數(shù)據(jù)的方式：

• 直接調(diào)用查詢接口。使用該接口，會(huì)將包含查詢條件的謂詞自動(dòng)拼接成完整的 SQL 語句進(jìn)行查詢操作，無需用戶傳入原生的 SQL。
• 執(zhí)行原生的用于查詢的 SQL 語句。

數(shù)據(jù)庫謂詞的使用

關(guān)系型數(shù)據(jù)庫提供了用于設(shè)置數(shù)據(jù)庫操作條件的謂詞 AbsRdbPredicates，其中包括兩個(gè)實(shí)現(xiàn)子類 RdbPredicates 和 RawRdbPredicates：

• RdbPredicates：開發(fā)者無需編寫復(fù)雜的 SQL 語句，僅通過調(diào)用該類中條件相關(guān)的方法，如 equalTo、notEqualTo、groupBy、orderByAsc、beginsWith 等，就可自動(dòng)完成 SQL 語句拼接，方便用戶聚焦業(yè)務(wù)操作。
• RawRdbPredicates：可滿足復(fù)雜 SQL 語句的場景，支持開發(fā)者自己設(shè)置 where 條件子句和 whereArgs 參數(shù)。不支持 equalTo 等條件接口的使用。

查詢結(jié)果集的使用

關(guān)系型數(shù)據(jù)庫提供了查詢返回的結(jié)果集 ResultSet，他指向查詢結(jié)果中的一行數(shù)據(jù)，供用戶對查詢結(jié)果進(jìn)行遍歷和訪問。ReusltSet 的對外 API 如下表格。

事務(wù)

關(guān)系型數(shù)據(jù)庫提供事務(wù)機(jī)制，來保證用戶操作的原子性。對單條數(shù)據(jù)進(jìn)行數(shù)據(jù)庫操作時(shí)，無需開啟事務(wù)；插入大量數(shù)據(jù)時(shí)，開啟事務(wù)可以保證數(shù)據(jù)的準(zhǔn)確性。如果中途操作出現(xiàn)失敗，會(huì)執(zhí)行回滾操作。

事務(wù)和結(jié)果集觀察者

關(guān)系型數(shù)據(jù)庫提供了事務(wù)和結(jié)果集觀察者能力，當(dāng)對應(yīng)的事件被觸發(fā)時(shí)，觀察者會(huì)收到通知。

數(shù)據(jù)庫的備份和恢復(fù)

用戶可以將當(dāng)前數(shù)據(jù)庫的數(shù)據(jù)進(jìn)行保存進(jìn)行備份，還可以在需要的時(shí)候進(jìn)行數(shù)據(jù)恢復(fù)。

開發(fā)步驟

1. 創(chuàng)建數(shù)據(jù)庫。

1. 配置數(shù)據(jù)庫相關(guān)信息，包括數(shù)據(jù)庫的名稱、存儲(chǔ)模式、是否為只讀模式等。
2. 初始化數(shù)據(jù)庫表結(jié)構(gòu)和相關(guān)數(shù)據(jù)。
3. 創(chuàng)建數(shù)據(jù)庫。

示例代碼如下：

   StoreConfig config = StoreConfig.newDefaultConfig("RdbStoreTest.db");
   private static final RdbOpenCallback callback = new RdbOpenCallback() {
       @Override
       public void onCreate(RdbStore store) {
           store.executeSql("CREATE TABLE IF NOT EXISTS test (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, age INTEGER, salary REAL, blobType BLOB)");
       }
       @Override
       public void onUpgrade(RdbStore store, int oldVersion, int newVersion) {
       }
   };
   DatabaseHelper helper = new DatabaseHelper(context);
   RdbStore store = helper.getRdbStore(config, 1, callback, null);

1. 插入數(shù)據(jù)。

1. 構(gòu)造要插入的數(shù)據(jù)，以 ValuesBucket 形式存儲(chǔ)。
2. 調(diào)用關(guān)系型數(shù)據(jù)庫提供的插入接口。

示例代碼如下：

   ValuesBucket values = new ValuesBucket();
   values.putInteger("id", 1);
   values.putString("name", "zhangsan");
   values.putInteger("age", 18);
   values.putDouble("salary", 100.5);
   values.putByteArray("blobType", new byte[] {1, 2, 3});
   long id = store.insert("test", values);

1. 查詢數(shù)據(jù)。

1. 構(gòu)造用于查詢的謂詞對象，設(shè)置查詢條件。
2. 指定查詢返回的數(shù)據(jù)列。
3. 調(diào)用查詢接口查詢數(shù)據(jù)。
4. 調(diào)用結(jié)果集接口，遍歷返回結(jié)果。

示例代碼如下：

   String[] columns = new String[] {"id", "name", "age", "salary"};
   RdbPredicates rdbPredicates = new RdbPredicates("test").equalTo("age", 25).orderByAsc("salary"); 
   ResultSet resultSet = store.query(rdbPredicates, columns);
   resultSet.goToNextRow();