Realm学习笔记（二）——简单使用

• 目录

  • 前期准备知识
  • Realm模型
  • 写入操作
  • 读操作

• 前期准备知识

介绍

在这之前我们需要先记住一个类，它就是Realm类，现在你只需要记住它很重要就是了，可以说Realm的所有操作都是要通过它来完成的。

创建

最简单的一种创建一个Realm实例的方法如下：

RealmConfiguration realmConfig = new RealmConfiguration.Builder(context).build();
Realm realm = Realm.getInstance(realmConfig);

• Realm模型

Realm模型是什么？

个人理解，Realm模型就是对应着数据库中一张张表的实体。

如何创建一个Realm模型？

Realm模型的穿件十分简单，只需要继承RealmObject这个类就可以了,代码如下:

public class User extends RealmObject {
  private String name;
  private int age;
  private int sessionId; 
  // 标准的getter和setter方法，可以由IDE自动生成,此处省略
  ...
}

• 写操作

哪些是写操作？

对于数据表来说，写操作包括：添加、修改和删除。
PS：注意！所有的写操作，都必须被写入事物包裹

写入事物

写入事物可以是这样的：

// 获取一个Realm实例 
Realm realm = ...;// 获取一个Realm实例 
realm.beginTransaction(); //这是写入事物的头
// 你可以在这里执行各种写入操作
...
realm.commitTransaction();//这是写入事物的屁股

也可以是这样的：

    Realm realm = ...; // 获取一个Realm实例 
    realm.executeTransaction(new Realm.Transaction() { 
      @Override 
      public void execute(Realm realm) {
          //直接在这里执行写操作 
          ...
      }
});

还可以是这样的:

realm.executeTransactionAsync(new Realm.Transaction() {
        @Override 
        public void execute(Realm bgRealm) {
            //直接在这里执行写操作  
            ... 
        }
}, new Realm.Transaction.OnSuccess() { 
        @Override 
        public void onSuccess() {
            //写入成功时的回调
            ...
        }
}, new Realm.Transaction.OnError() { 
        @Override public void onError(Throwable error) {
            //写入失败时的回调
            ...
        }
});

很明显，第一二种方式是同步的方式，第三种是异步的方式。
为方便起见，接下来的示例都用第一种方式。

添加

要向数据表中添加一条数据你可以这样做：

realm.beginTransaction();
User user = realm.createObject(User.class); //利用realm实例创建一个对象
user.setName("jiangshi");
user.setAge(18);
realm.commitTransaction();

你还可以这样做：(利用Realm.copyToRealm()这个方法)

User user =new User("jiangshi");
user.setAge(18);
realm.beginTransaction();
User realmUser = realm.copyToRealm(user);
realm.commitTransaction();

更新

更新操作十分简单：

User user = ... //获取一个被realm管理的的realmObject对象
realm.beginTransaction();
user.setAge(188);
realm.commitTransaction();

这样便可一更新数据库中的一条数据。
注意：上面代码中的user对象必须是被realm管理的的对象，哪些是被realm管理的对象？
1.利用realm从数据表中查询出来的对象；
2.调用Realm.copyToRealm()时返回的对象，如上面添加中的realmUser(其他类似方法以此类推)；
3.调用Realm.createObject()时创建的对象;
4.自己new出来的对象不是被管理的对象。

删除

这是删除当条数据的代码

User user = ... //获取一个被realm管理的的realmObject对象
realm.beginTransaction();
user.deleteFromRealm();
realm.commitTransaction();

这里同样需要获取到一个被管理的realmObject对象。

• 读操作

显而易见，读操作便是查询操作了：
下面是一种最简单打查询方式

RealmResults<User> results;
results = realm.where(User.class) //定位要查询的表
                 .equalTo("name", "jiangshi")//查询的条件 
                 .findAll(); //执行查询操作，查询出所有符合条件的对象

返回值

返回值是一个RealmResults<E> 对象，我们可以这样取出所有被查出来的对象：

for(User user : results) {
      //对查询出来的用户进行处理
       ...
}

查询条件

下面这些条件大多都能根据名字很轻松的知道是干嘛的。
引用官方文档的内容：

Realm 支持以下查询条件：
* between()、greaterThan()、lessThan()、greaterThanOrEqualTo()和 lessThanOrEqualTo();

• equalTo()和 notEqualTo()
• contains()、beginsWith()和 endsWith()
• isNull()和 isNotNull()
• isEmpty()和 isNotEmpty()
  并非所有条件都适用于所有数据类型

本篇文章到此结束，下一篇文章将会详细介绍Realm这个类。