Realm Java 简明教程(1)

Realm Java 简明教程

Realm 是一个轻量的android版本的数据存储库

Realm 是一个轻量的android版本的数据存储库，快速简洁的操作方式，使得其优势得以凸显，我们来看下一个实例：

// 定义需要存储的类，继承自 RealmObject
public class Dog extends RealmObject {
@Required // Name cannot be null
private String name;
private int age;

// ... Generated getters and setters ...
}
public class Person extends RealmObject {
@Required // Name is not nullable
private String name;
private String imageUrl; // imageUrl is an optional field
private RealmList<Dog> dogs; // A person has many dogs (a relationship)

// ... Generated getters and setters ...
}

// 像一般的操作方式使用它
Dog dog = new Dog();
dog.setName("Rex");
dog.setAge("1");
Log.v(TAG, "Name of the dog: " + dog.getName());

// 获取一个Realm实例
Realm realm = Realm.getInstance(context);

// 查找Dog数据库中字段age小于2的所有数据
RealmResults<Dog> puppies = realm.where(Dog.class).lessThan("age", 2).findAll();
puppies.size(); // => 此时还没有插入存储，因此为0

// 保存这个数据
realm.beginTransaction();
realm.copyToRealm(dog);
realm.commitTransaction();

// 查询是自动同步更新的
puppies.size(); // => 1

//异步查询和更新数据
realm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
// 开始查询和修改数据
Dog theDog = realm.where(Dog.class).equals("age", 1).findFirst();
theDog.setAge(3);
}
}, new Realm.Transaction.Callback() {
@Override
public void onSuccess() {
// 原始的查询数据会自动更新
puppies.size(); // => 0 because there are no more puppies (less than 2 years old)
dog.getAge();   // => 3 数据已经修改
}
});

我们来看下如上的流程，发现处理过程比起我们之前使用的数据库方案简单了许多。像litepal的操作已经很简单，但是相对来说还是需要配置一些xml和app参数才可以使用。相对来说，Realm则非常轻量，简单易用，有同步和异步处理方案，代码相对也非常优雅。

开始

下载库或者去官网下载代码

Realm jar

Realm src

前期要求

我们仅支持android

Android Studio >= 0.8.6 — 使用Eclipse,往下看.

最新的Android SDK版本.

JDK 版本 >=7.

我们支持android2.3以上版本

使用

你可以选择手动添加或者使用maven工具实现。

Maven

1.请确保您的项目使用jcenter作为一个依赖库 (默认的是最新的android gradle plugin)

2.在你的工程依赖库增加compile ‘io.realm:realm-android:0.87.4’

3.使用工具->Android->同步即可

Jar

1.下载jar包解压

2.新建一个工程

3.复制jar文件夹到app/libs里面

4.在工程的依赖里面加入包含此库。

混淆要求

Realm 在编译时生成每个RealmObject 的代理类。为了确保这些类可以在混淆和静态分析工具能运行的，你的混淆语法需要如下去编写：

-keep class io.realm.annotations.RealmModule
-keep @io.realm.annotations.RealmModule class *
-keep class io.realm.internal.Keep
-keep @io.realm.internal.Keep class * { *; }
-dontwarn javax.**
-dontwarn io.realm.**

Api查询

你可以在官方地址查看到所有的api使用接口。

具体Models的使用规则，下一章节再来分析。