ObjectBox是什么
前几天升级 EventBus的时候, 看到了 ObjectBox, 然后进去看了下, 发现这是一个超级快的数据库, 于是在项目里进行了集成, 踩了一些坑, 下面一一介绍.
1. greenDAO 作者另一力作, 超快的数据库: objectbox.io/
2. 还是快, 对sqlite, realm, greenDAO, room堪称碾压: github.com/objectbox/o…
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…
作者：jp1017