部落格: 安卓之家
掘金: 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…
其中包括:
- objectbox-example: ObjectBox 基本使用, java
- objectbox-kotlin-example: ObjectBox Kotlin 使用
- daocompat-example: 對
greenDAO
的相容 - 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…
分享是一種美德,更是一種生活方式!!
也許你會說我是一個夢想者,但我不是唯一的一個。
悅分享,越快樂^_^
歡迎交流,轉載請註明出處,謝謝!