提要
ObjectBox版本: v2.3.1（ 2019/01/08）
Android Studio版本: 3.3
- ObjectBox由greenrobot开发，其他产品有GreenDao、EventBus。ObjectBox是基于noSql的ORM数据库, 支持表关系的定义以及事务的处理, 在性能上官网称优于对比测试的所有嵌入型数据库5-15倍。
1.集成方法
- ①
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
ext.objectboxVersion = '2.3.1'
repositories {
google()
jcenter()
maven { url "http://objectbox.net/beta-repo/" }
}
dependencies {
classpath 'com.android.tools.build:gradle:3.3.0'
//ObjectBox
classpath "io.objectbox:objectbox-gradle-plugin:$objectboxVersion"
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
google()
jcenter()
maven { url "http://objectbox.net/beta-repo/" }
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
- ②在app Model里的build.gradle文件里添加插件
apply plugin: 'com.android.application'
apply plugin: 'io.objectbox'
......
......
dependencies {
//ObjectBox
annotationProcessor "io.objectbox:objectbox-processor:$objectboxVersion"
//正式版
implementation "io.objectbox:objectbox-android:$objectboxVersion"
}
此时需要先立刻同步一下项目，点击Sync Now下载依赖文件
使用方法
- 添加一个Bean类，使用@Entity注解, 进行表映射
/**
* id必须使用使用注解 @Id，表示自增长
* 如需手动管理应该用 @Id(assignable = true)
* 不需要写get、set方法，否则会报错
* 变量用public修饰符，总之我用private 时Build会报错
*/
@Entity
public class UserEntity {
@Id
public long id;
public String name;
public String age;
}
- 完成以上步骤后,请点击Build→Make Project，这样MyObjectBox就自动生成了。
- 把ObjectBox对象单例并实例化, 一般放在application的onCreate()中
public class MyApplication extends Application{
private static BoxStore mBoxStore;
@Override
public void onCreate() {
mBoxStore = MyObjectBox.builder().androidContext(this).build();
if (BuildConfig.DEBUG) {
new AndroidObjectBrowser(mBoxStore).start(this);
}
XLog.e("App===", "Using ObjectBox :" + BoxStore.getVersion() + " (" + BoxStore.getVersionNative() + ")");
}
public BoxStore getBoxStore() {
return mBoxStore;
}
}
- 4.此时可以通过Box<UserEntity>对象来针对这张表做增删改查了（put, get, remove, query）。
Box<UserEntity> beanBox= ((MyApplication) getApplication()).boxFor(UserEntity.class).build();
//新增和修改，put 的参数可以是 list
beanBox.put(bean);
//删除 id 为 2 的数据
beanBox.remove(2);
//查询，名字为 T 开头或者 age为 10 的数据
List<TestObjectBoxBean> item = beanBox.query()
.startsWith(UserEntity_.name,"T")
.or().equal(UserEntity_.age,"10").build().find();
//查询时，用到了生成类 UserEntity_通常是实体类加一个下划线。使用 builder.equal() 进行设置匹配，调用 startWith() 设置查询条件，find() 可以用于分页。
数据库升级
- 首先，在要修改的字段添加 @Uid 注解。
- 然后 Build -> Make Project，
- 此时就可以直接修改字段的名称
官方有这样一个提示，假如需要插入或修改多条数据，可以这样做：
for(User user: allUsers) {
modify(user); // modifies properties of given user
box.put(user);
}
//但这种做法可能会需要较多的时间、花费更多的性能，正确做法
for(User user: allUsers) {
modify(user); // modifies properties of given user
}
box.put(allUsers);
调试
apply plugin: 'com.android.application'
//apply plugin: 'io.objectbox' //注释此行
dependencies {
//ObjectBox
annotationProcessor "io.objectbox:objectbox-processor:$objectboxVersion"
//调试 api
debugImplementation "io.objectbox:objectbox-android-objectbrowser:$objectboxVersion"
releaseImplementation "io.objectbox:objectbox-android:$objectboxVersion"
}
- 清单文件申请权限
<uses-permission android:name="android.permission.INTERNET"/>
- 重新Build运行后, 就可以从设备的通知栏点击进入查看数据库, 通过在cmd中输入
adb forward tcp:8090 tcp:8090, 打开浏览器, 输入http://localhost:8090/index.html 网址即可查看数据库信息
