Realm Java 官方教程翻译 (一)：Getting Started

//定义你的model类，并且继承自RealmObject
public class Dog extends RealmObject {
    private String name;
    private int age;

    //...生成相应属性的getters 和 setters方法...
}

public class Person extends RealmObject {
    @PrimaryKey
    private long id;
    private String name;
    private RealmList dogs; // 声明一对多的关系  
    //...生成相应属性的getters 和 setters方法...
}

//像使用标准的java对象一样使用它们
Dog dog = new Dog();
dog.setName("Rex");
dog.setAge(1);

//初始化 Realm
Realm.init(context);

//在该线程中获取一个Realm实例
Realm realm = Realm.getDefaultInstance();

//在Realm中查询所有的大于2岁的狗
final RealmResults puppies = realm.where(Dog.class).lessThan("age", 2).findAll();
puppies.size(); //小狗数量结果为0，因为现在Realm中还没有添加狗



// 在事务中存留你的数据
realm.beginTransaction();
final Dog managedDog = realm.copyToRealm(dog); // Persist unmanaged objects
Person person = realm.createObject(Person.class); // Create managed objects directly
person.getDogs().add(managedDog);
realm.commitTransaction();

//当数据改变的时候，Listener将会被调用
puppies.addChangeListener(new RealmChangeListener>() {
    @Override
    public void onChange(RealmResults results) {
         //查询到的小狗的数量结果也会在同一时间被更新掉
        puppies.size(); // 小狗数量为1
    }
});

//在后台进程中异步更新对象
realm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm bgRealm) {
        Dog dog = bgRealm.where(Dog.class).equalTo("age", 1).findFirst();
        dog.setAge(3);
    }
}, new Realm.Transaction.OnSuccess() {
    @Override
    public void onSuccess() {
         //原始查询和Realm对象会被自动更新
        puppies.size(); // 小狗的数量为0，因为没有比2岁更年轻的小狗了
        managedDog.getAge();   // 小狗的年龄已经被更新为3了
    }
});

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:2.2.1"
    }
}