subtitle: “让你的应用迅速带上存储的翅膀
简介
Realm是一个可以替代SQLite以及ORMlibraries的轻量级数据库。相比SQLite,Realm更快并且具有很多现代数据库的特性,比如支持JSON,流式api,数据变更通知,以及加密支持,这些都为安卓开发者带来了方便。
准确来说,它是专门为移动应用所设计的数据持久化解决方案之一。
Realm 可以轻松地移植到您的项目当中,并且绝大部分常用的功能(比如说插入、查询等等)都可以用一行简单的代码轻松完成!
Realm 并不是对 Core Data 的简单封装,相反地, Realm 并不是基于 Core Data ,也不是基于 SQLite 所构建的。它拥有自己的数据库存储引擎,可以高效且快速地完成数据库的构建操作。
优点
跨平台 :现在绝大多数的应用开发并不仅仅只在 iOS 平台上进行开发,还要兼顾到 Android 平台的开发。为两个平台设计不同的数据库是愚蠢的,而使用 Realm 数据库, iOS 和 Android 无需考虑内部数据的架构,调用 Realm 提供的 API 就可以完成数据的交换,实现 “ 一个数据库,两个平台无缝衔接 ” 。
简单易用 : Core Data 和 SQLite 冗余、繁杂的知识和代码足以吓退绝大多数刚入门的开发者,而换用 Realm ,则可以极大地减少学习代价和学习时间,让应用及早用上数据存储功能。
可视化 : Realm 还提供了一个轻量级的数据库查看工具,借助这个工具,开发者可以查看数据库当中的内容,执行简单的插入和删除数据的操作。毕竟,很多时候,开发者使用数据库的理由是因为要提供一些所谓的 “ 知识库 ” 。
使用
CURD操作
Realm规定所有改动操作必须在事务中进行, 即改动操作必须在Realm的beginTransaction()和commitTransaction()方法之间进行 或者在executeTransaction方法的参数的回调中执行. 改动操作有: createObject/copyXxx/insert/deleteXxx 等
引入
dependencies {
compile 'io.realm:realm-android:0.87.0'
}
初始化
/*初始化*/
RealmConfiguration realmConfiguration = new RealmConfiguration.Builder(this)
.name("test1.realm")// 存储文件名称,类似db文件名
.migration(new RealmMigration() { // 当本地已经存在的数据版本跟当前运行的不一致会调用此方法
@Override
public void migrate(DynamicRealm realm, long oldVersion, long newVersion) {
newVersion = oldVersion + 1;
}
})
.build();
final Realm myRealm = Realm.getInstance(realmConfiguration);// 设置配置
类的定义
我们定义的类,必须继承于RealmObject。看下我们定义的Person类
加了@PrimaryKey 的为主键,当然,我们也可以不加
public class Person extends RealmObject {
@PrimaryKey
private int id;
private String name;
private int age;
public Person() {
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
}
清空表
//清空表
myRealm.beginTransaction();
myRealm.clear(Person.class);
myRealm.commitTransaction();
增
//两种添加方式
myRealm.beginTransaction();
Person person = myRealm.createObject(Person.class);
person.setId(10);
person.setAge(10);
person.setName("xiamin");
myRealm.commitTransaction(); //有主键的表,这种操作要是主键重复了可是会报异常的
person = new Person();
person.setId(13);
person.setAge(13);
person.setName("xiamin");
myRealm.beginTransaction();
myRealm.copyToRealmOrUpdate(person); // 若是没有主键的表,则不能执行该操作哦 通过主键查询它的对象,如果查询到了,则更新它,否则新建一个对象来代替。
myRealm.commitTransaction();
删
//删
Log.i("xiamin", "删除第一个");
final RealmResults<Person> list= myRealm.where(Person.class).findAll();
myRealm.beginTransaction();
list.get(0).removeFromRealm();
myRealm.commitTransaction();
改
//改
Log.i("xiamin", "修改age = 7的名字为xiamin2");
myRealm.beginTransaction();
person = myRealm.where(Person.class).equalTo("age",7).findFirst();
person.setName("xiamin2");
myRealm.commitTransaction();
查
//查 + 排序
Log.i("xiamin", "查询结果");
RealmResults<Person> results =
myRealm.where(Person.class).findAllSorted("age");
for (Person s: results) {
Log.i("xiamin", "id:" + s.getId() + " name:" + s.getName() + " age:" + s.getAge());
}
常见的条件如下(详细资料请查官方文档):
between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()
equalTo() & notEqualTo()
contains(), beginsWith() & endsWith()
isNull() & isNotNull()
isEmpty() & isNotEmpty()
常见问题
A RealmObject with no @PrimaryKey cannot be updated: class com.jerey.realmdemo.Person
一个没有主键的类是不使用copyToRealmOrUpdate的Android Realm: Primary key constraint broken. Value already exists: 0
有主键的类,主键重复了the xxx RealmMigration must be provided
出现这个问题的时候是因为,没有初始化时没有提供migration没有在beginTransaction();与commitTransaction(); 就进行了事物修改等
谢谢大家阅读,如有帮助,来个喜欢或者关注吧!
本文作者:Anderson/Jerey_Jobs
博客地址 : 夏敏的博客/Anderson大码渣/Jerey_Jobs
简书地址 : Anderson大码渣
CSDN地址 : Jerey_Jobs的专栏
github地址 : Jerey_Jobs