Android快速上手ObjectBox

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 getAll() {
        return getBlogItemBox().getAll();
    }

    public static void delete(long id) {
        getBlogItemBox().remove(id);
    }

    private static Box getBlogItemBox() {
        return App.getInstance().getBoxStore().boxFor(BlogItem.class);
    }
}

好了，简单使用就介绍到这里。