Realm大致使用:
一、Realm简介
数据库Realm,是用来替代sqlite的一种解决方案,它有一套自己的数据库存储引擎,比sqlite更轻量级,拥有更快的速度,并且具有很多现代数据库的特性,比如支持JSON,流式api,数据变更通知,自动数据同步,简单身份验证,访问控制,事件处理,并且在github上拥有极多star
本篇文章用的版本为Realm 2.0.2(官方文档)
二、环境配置
(1) 在项目的build文件加上
buildscript {
repositories {
jcenter()
}
dependencies {
classpath "io.realm:realm-gradle-plugin:2.0.2"
}
}
(2) 在app的build文件加上
apply plugin: 'realm-android'
三、初始化Realm
(1) 在Application的oncreate()方法中Realm.init()
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
Realm.init(this);
}
}
(2)在Application的oncreate()方法中对Realm进行相关配置
①使用默认配置
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// The Realm file will be located in Context.getFilesDir() with name "default.realm"
Realm.init(this);
RealmConfiguration config = new RealmConfiguration.Builder().build();
Realm.setDefaultConfiguration(config);
}
}
②使用自定义配置
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// The Realm file will be located in Context.getFilesDir() with name "default.realm"
Realm.init(this);
RealmConfiguration config = new RealmConfiguration.Builder().build();
Realm.setDefaultConfiguration(config);
}
}
(3)在AndroidManifest.xml配置自定义的Application
<application
android:name=".MyApplication"
...
/>
四、创建实体
(1)新建一个类继承RealmObject
public class Person extends RealmObject {
private String name;
private int age;
@PrimaryKey
private String id;
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 String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
}
(2)其他相关说明
1、支持的数据类型:
boolean, byte, short, int, long, float, double, String, Date and byte[]
在Realm中byte, short, int, long最终都被映射成long类型
2、注解说明
@PrimaryKey
①字段必须是String、 integer、byte、short、 int、long 以及它们的封装类Byte, Short, Integer, and Long
②使用了该注解之后可以使用copyToRealmOrUpdate()方法,通过主键查询它的对象,如果查询到了,则更新它,否则新建一个对象来代替。
③使用了该注解将默认设置@index注解
④使用了该注解之后,创建和更新数据将会慢一点,查询数据会快一点。
@Required
数据不能为null
@Ignore
忽略,即该字段不被存储到本地
@Index
为这个字段添加一个搜索引擎,这将使插入数据变慢、数据增大,但是查询会变快。建议在需要优化读取性能的情况下使用。
五、增
(1)实现方法一:事务操作
类型一 :新建一个对象,并进行存储
Realm realm=Realm.getDefaultInstance();
realm.beginTransaction();
Person person = realm.createObject(Person.class); // Create a new object
person.setName("John");
realm.commitTransaction();
类型二:复制一个对象到Realm数据库
Realm realm=Realm.getDefaultInstance();
Person person = new Person();
// Copy the object to Realm. Any further changes must happen on realmUser
realm.beginTransaction();
realm.copyToRealm(person);
realm.commitTransaction();
(2)实现方法二:使用事务块
Realm mRealm=Realm.getDefaultInstance();
final Person person = new Person();
person.setName("John");
mRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.copyToRealm(user);
}
});
六、删
Realm mRealm=Realm.getDefaultInstance();
final RealmResults<Person> person= mRealm.where(Person.class).findAll();
mRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
person.deleteFromRealm();
//删除第一个数据
person.deleteFirstFromRealm();
//删除最后一个数据
person.deleteLastFromRealm();
//删除位置为1的数据
person.deleteFromRealm(1);
//删除所有数据
person.deleteAllFromRealm();
}
});
同样也可以使用同上的beginTransaction和commitTransaction方法进行删除
七、改
Realm mRealm=Realm.getDefaultInstance();
Person person = mRealm.where(Person.class).equalTo("id", id).findFirst();
mRealm.beginTransaction();
person.setName(newName);
mRealm.commitTransaction();
同样也可以用事物块来更新数据
八、查
(1)查询全部
查询结果为RealmResults,可以使用mRealm.copyFromRealm(person)方法将它转为List
public List<Person> queryAll() {
Realm mRealm=Realm.getDefaultInstance();
RealmResults<Person> person = mRealm.where(Person.class).findAll();
return mRealm.copyFromRealm(person);
}
(2)条件查询
public Person queryPersonById(String id) {
Realm mRealm=Realm.getDefaultInstance();
Person person = mRealm.where(Person.class).equalTo("id", id).findFirst();
return person;
}
常见的条件如下(详细资料请查官方文档):
between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()
equalTo() & notEqualTo()
contains(), beginsWith() & endsWith()
isNull() & isNotNull()
isEmpty() & isNotEmpty()