Android数据库之Realm快速入门教程

—————————-官网—————————

1 介绍

安卓开发的最新趋势,Realm是一个可以替代SQLite以及ORMlibraries的轻量级数据库。

相比SQLite,Realm更快并且具有很多现代数据库的特性,比如支持JSON,流式api,数据变更通知,以及加密支持,这些都为安卓开发者带来了方便。

在这篇快速入门教程中,将学到Android版Realm的基础知识。本教程我们使用的是Realm v0.84.1。

2 添加Realm远程包,并添加Realm到工程

要在安卓工程中使用Realm,你需要在module的build.gradle文件中添加一个添加一个依赖:

compile 'io.realm:realm-android:0.84.1'

3 创建一个Realm

一个Realm相当于一个SQLite数据库。它有一个与之对应的文件,一旦创建将持久保存在安卓的文件系统中。

3.1 要创建一个新的Realm

可以在任意Activity中调用静态方法Realm.getInstance。

Realm myRealm = Realm.getInstance(context);

注意,调用Realm.getInstance,而没有传入RealmConfiguration,会创建一个叫做 default.realm的Realm文件。

3.2 如果你想向app中添加另一个Realm

必须使用一个RealmConfiguration.Builder对象,并为 Realm file 指定一个独有的名字。

Realm myOtherRealm =
    Realm.getInstance(new    RealmConfiguration.Builder(context)
                      .name("myOtherRealm.realm")
                        .build()
);

4 创建一个RealmObject

只要继承了RealmObject类,任意JavaBean都能存储在Realm中。不知道JavaBean是什么?它就是一个可序列化的java类,有默认构造器,成员变量有相应的getter/setter方法。比如,下面这个类的实例就能轻松的存储在一个Realm中:

public class Country extends RealmObject {

    private String name;
    private int population;

    public Country() { }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getPopulation() {
        return population;
    }

    public void setPopulation(int population) {
        this.population = population;
    }

}

如果你想让RealmObject的一个成员变量作为主键,你可以使用@PrimaryKey注解。比如,这里演示了如何为Country类添加一个主键code:

@PrimaryKey
private String code;

public String getCode() {
    return code;
}

public void setCode(String code) {
    this.code = code;
}

5 创建transaction

Realm遵循 ACID (数据库事务正确执行的四个基本要素的缩写)规范,为了确保原子性和一致性,它强制所有的写入操作都在一个事务中执行。

要开始一个新的事务,使用beginTransaction方法。类似地,要结束这个事务,使用commitTransaction方法。注:事务即英文里面的transaction。

5.1 不使用Country类的构造器创建country1的。

对于一个Realm来说,管理一个RealmObject的实例,这个实例必须用createObject方法创建。这里演示了如何创建和保存一个Country类的实例:

myRealm.beginTransaction();

// Create an object
Country country = myRealm.createObject(Country.class); 
// Set its fields
country.setName("Norway");
country.setPopulation(5165800);
country.setCode("NO");

myRealm.commitTransaction();

5.1 必须使用构造器创建country2的。

在提交事务前使用相关Realm对象的copyToRealm方法。这里是示例:

// Create the object
Country country = new Country();
country.setName("Russia");
country.setPopulation(146430430);
country.setCode("RU");

myRealm.beginTransaction();
Country copyOfCountry = myRealm.copyToRealm(country2);
myRealm.commitTransaction();

6 书写查询

Realm为创建查询提供了一套非常直观和流式的API。要创建一个查询,使用相关Realm对象的where方法并传入你感兴趣的对象的类。创建完查询之后,你可以使用返回一个RealmResults对象的findAll方法获取所有的结果,findAll。

6.1 findAll()

在下面的例子中,我们获取并打印Country的所有对象:

RealmResults<Country> results =
        myRealm.where(Country.class).findAll();

for(Country c:results) {
    Log.d("results", c.getName());
}

6.2 beginsWith, endsWith,lesserThan 和 greaterThan

Realm提供了几个命名非常贴切的方法,比如beginsWith, endsWith,lesserThan 和 greaterThan,可以用来过滤,筛选结果。下面的代码演示了如何使用greaterThan方法来获取population(人口)大于1亿的Countryobjects:

RealmResults<Country> results =
        myRealm.where(Country.class)
                .greaterThan("population", 100000000)
                .findAll();

6.3 findAllSorted

如果你想查询结果被归类,你可以使用findAllSorted方法。在它的参数中,用一个String指定被归类field的名字,并用一个boolean指定归类顺序。

RealmResults<Country> results =
        myRealm.where(Country.class)
                .findAllSorted("name", false);

总结

在这篇快速入门中,你学到了如何在安卓项目中使用Realm。可以看到创建一个Realm数据库、存储查询数据是多么的容易。

你可能感兴趣的:(android,数据库)