安卓超快資料庫ObjectBox使用及填坑指南

南無大乘妙法蓮華經發表於2017-11-17

部落格: 安卓之家
掘金: jp1017
微博: 追風917
CSDN: 蔣朋的家
簡書: 追風917

每日一景
每日一景

ObjectBox是什麼

前幾天升級 EventBus的時候, 看到了 ObjectBox, 然後進去看了下, 發現這是一個超級快的資料庫, 於是在專案裡進行了整合, 踩了一些坑, 下面一一介紹.

1 greenDAO 作者另一力作, 超快的資料庫: objectbox.io/
2 還是快, 對sqlite, realm, greenDAO, room堪稱碾壓: github.com/objectbox/o…
下面是在堅果pro上操作200000條資料的結果:

Starting tests with 200000 entities at Mon Nov 20 09:35:31 GMT+08:00 2017

ObjectBox Basic operations (CRUD) (1/1)
------------------------------
ObjectBox 1.2.0-2017-10-31
insert: 2635 ms (thread: 2006 ms)
update: 2577 ms (thread: 2155 ms)
load: 1838 ms (thread: 1811 ms)
access: 100 ms (thread: 98 ms)
delete: 570 ms (thread: 539 ms)

Tests done at Mon Nov 20 09:35:45 GMT+08:00 2017
Starting tests with 200000 entities at Mon Nov 20 09:35:45 GMT+08:00 2017

Realm Basic operations (CRUD) (1/1)
------------------------------
insert: 11395 ms (thread: 10308 ms)
update: 6757 ms (thread: 5998 ms)
load: 11 ms (thread: 4 ms)
access: 6656 ms (thread: 6542 ms)
delete: 2014 ms (thread: 1930 ms)

Tests done at Mon Nov 20 09:36:17 GMT+08:00 2017
Starting tests with 200000 entities at Mon Nov 20 09:36:17 GMT+08:00 2017

greenDAO Basic operations (CRUD) (1/1)
------------------------------
SQLite version 3.9.2
insert: 8452 ms (thread: 8172 ms)
update: 12213 ms (thread: 11024 ms)
load: 9811 ms (thread: 9729 ms)
access: 125 ms (thread: 125 ms)
delete: 5302 ms (thread: 4721 ms)
DB deleted: true

Tests done at Mon Nov 20 09:36:59 GMT+08:00 2017
Starting tests with 200000 entities at Mon Nov 20 09:36:59 GMT+08:00 2017

Room Basic operations (CRUD) (1/1)
------------------------------
SQLite version 3.9.2
insert: 9553 ms (thread: 9144 ms)
update: 13038 ms (thread: 11900 ms)
load: 9398 ms (thread: 9316 ms)
access: 119 ms (thread: 115 ms)
delete: 6137 ms (thread: 5665 ms)
DB deleted: true

Tests done at Mon Nov 20 09:37:43 GMT+08:00 2017複製程式碼

3 完美支援 Kotlin: objectbox.io/documentati…
4 介面簡單, 使用方便, 可由 greenDAO 快速替換
5 提供響應式介面: objectbox.io/documentati…
6 除錯方便, 可在安卓手機及電腦端進行除錯: objectbox.io/objectbox-1…

快速接入

demo我就不提供了, 官方有多個demo可供參考: github.com/objectbox/o…
其中包括:

  1. objectbox-example: ObjectBox 基本使用, java
  2. objectbox-kotlin-example: ObjectBox Kotlin 使用
  3. daocompat-example: 對 greenDAO 的相容
  4. objectbox-relation-example: 高階用法, 一對一, 一對多等

接入很簡單, 官方也有介紹:

Gradle 新增依賴

1 根gradle 新增遠端倉庫及倉庫名

buildscript {
    ext.objectboxVersion = '1.2.1'
    repositories {
        maven { url "http://objectbox.net/beta-repo/" }
    }
    dependencies {
        classpath "io.objectbox:objectbox-gradle-plugin:$objectboxVersion"
    }
}

allprojects {
    repositories {
        maven { url "http://objectbox.net/beta-repo/" }
    }
}複製程式碼

2 app 下的 gradle 新增外掛

apply plugin: 'io.objectbox' // 注意放到安卓外掛後面複製程式碼

3 app 下的 gradle 新增依賴:

debugCompile 'io.objectbox:objectbox-android-objectbrowser:1.2.1'
releaseCompile 'io.objectbox:objectbox-android:1.2.1'複製程式碼

專案使用

1 先來一個資料類, 比如 Student, 用 @Entity 註解
2 在 Application 下獲取一個 BoxStore:

boxStore = MyObjectBox.builder().androidContext(this).build();複製程式碼

3 然後獲取進行增刪改查的 Box

Box<Student> box = boxStore.boxFor(Student.class);複製程式碼

4 進行增刪改查: put, get, remove, and query.

填坑

找不到 MyObjectBox

編譯一下專案即可自動生成

資料庫儲存到了哪裡

預設儲存位置在 /data/data/包名/files/objectbox/data.mdb

可以在 BoxStore 初始化的時候設定儲存位置

ToMany 怎麼使用

這裡的 ToMany 繼承自 List, 使用很方便, 參考這個demo: github.com/objectbox/o…

查詢時設定查詢個數

使用 Query.find(long offset, long limit), 參考這個issue: github.com/objectbox/o…

找不到 "libobjectbox.so"

作者認為 armeabi 已經過時, 僅提供 armeabi-v7aarm64-v8a的so, 請檢查你的應用設定

升級

主要包括更改實體類名及實體類裡的變數名或型別, 很簡單, 要使用註解 @Uid

以更改實體類名為例:

1 要更改的實體類新增註解 @Uid
2 編譯, 會報錯, 點選as右下 Gradle Console 會有類似報錯資訊:

注: [ObjectBox] Starting ObjectBox processor (debug: false)
錯誤: [ObjectBox] UID operations for property "LocationEntity.locationTime": [Rename] apply the current UID using @Uid(3939342872662404404L) - [Change/reset] apply a new UID using @Uid(7349095691908173825L)複製程式碼

3 把報錯資訊裡後面一個新的數填寫到註解裡, 此處為: @Uid(3939342872662404404L)
4 更改你的類名, 編譯即可完成

除錯

1 配置你的gradle:

dependencies {
    debugCompile "io.objectbox:objectbox-android-objectbrowser:$objectboxVersion"
    releaseCompile "io.objectbox:objectbox-android:$objectboxVersion"
}複製程式碼

2 外掛 `apply plugin: 'io.objectbox'` 放到 gradle 檔案最後一行

3 Application 裡開啟除錯資訊:

new AndroidObjectBrowser(boxStore).start(this);複製程式碼

完成這兩步, 編譯執行後在通知欄會有個OB通知, 點選就可以在手機端瀏覽器檢視資料庫了...

安卓超快資料庫ObjectBox使用及填坑指南

如果在電腦檢視還需要新增一步:

4 在電腦終端執行一個 adb 命令:

adb forward tcp:8090 tcp:8090複製程式碼

這樣開啟網址 http://localhost:8090/index.html 就可以檢視資料庫

先到這裡了, 有問題可以留言或者官方提 issue: github.com/objectbox/o…

Cooooooooooooooooooooool!

最後,非常感謝您的閱讀,有任何疑問,可以後面評論,謝謝!

神奇的安卓開發網站:androidcat.com/

安卓開源庫收集整理:github.com/XXApple/And…

分享是一種美德,更是一種生活方式!!

也許你會說我是一個夢想者,但我不是唯一的一個。

悅分享,越快樂^_^

歡迎交流,轉載請註明出處,謝謝!

相關文章