ObjectBox是一款高性能的NoSQL数据库,专为IoT和移动设备开发。背后的开发团队是开发了大名鼎鼎的GreenDao和EventBus的团队。跨平台支持Linux、Windows、Mac/iOS、Android,Raspberry Pi, ARM等。本文将介绍在Android平台上如何使用快速上手ObjectBox。
工程中引入ObjectBox
打开工程的build.gradle
文件,定义ObjectBox版本变量,以及加入ObjectBox Gradle插件:
buildscript {
ext.objectboxVersion = '2.2.0'
respositories {
jcenter()
}
dependencies {
// Android Gradle Plugin 3.0.0 or later supported
classpath 'com.android.tools.build:gradle:3.2.1'
classpath "io.objectbox:objectbox-gradle-plugin:$objectboxVersion"
}
}
在module的build.gradle文件中添加io.objectbox
插件。建议放到其他插件的最后面,比如
apply plugin: 'com.android.application'
apply plugin: 'io.objectbox' // 放最后面
OK,简单配置到这里结束,同步一下gradle文件。
实体配置
ObjectBox
同主流的DB库一样,采用注解来标注实体类,然后编译生成DAO相关类。
使用@Entity
标注需要存取的实体类。@Id
标记用于ObjectBox
进行ID自增。
@Entity
public class BlogItem {
@Id
public long id;
public int count;
public String url;
}
注解详述待后面文章介绍。
访问
ObjectBox
与其他DB库不同,不会为每个实体生成单独的DAO
类,而是用一套模板进行访问。
对实体类进行存取的操作需要用到支持泛型的Box
。每个实体类的Box
需要使用BoxStore
的boxFor
方法获取。整个应用保持一个BoxStore
的引用就好,通常在Application中进行初始化。
public class App extends Application {
private static App instance;
private BoxStore boxStore;
@Override
public void onCreate() {
super.onCreate();
instance = this;
boxStore = MyObjectBox.builder().androidContext(this).build();
if (BuildConfig.DEBUG) {
boolean started = new AndroidObjectBrowser(boxStore).start(this);
Log.i("ObjectBrowser", "Started: " + started);
}
}
public static App getInstance() {
return instance;
}
public BoxStore getBoxStore() {
return boxStore;
}
}
简单使用
public class BlogDao {
public static void insertOrUpdateBlogItem(BlogItem newItem) {
getBlogItemBox().put(newItem);
}
public static List<BlogItem> getAll() {
return getBlogItemBox().getAll();
}
public static void delete(long id) {
getBlogItemBox().remove(id);
}
private static Box<BlogItem> getBlogItemBox() {
return App.getInstance().getBoxStore().boxFor(BlogItem.class);
}
}
好了,简单使用就介绍到这里。