-
目录
- 前期准备知识
- 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这个类。
