安卓超快數據庫ObjectBox使用及填坑指南

博客： 安卓之家
掘金： 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-v7a 和 arm64-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通知, 點擊就能夠在手機端瀏覽器查看數據庫了...

若是在電腦查看還須要添加一步:

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…

分享是一種美德，更是一種生活方式！！

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

悅分享，越快樂^_^

歡迎交流，轉載請註明出處，謝謝！