Realm 是一个全新的移动数据库引擎,它既不是基于ios平台的Core Data,也不是基于SQLite,它拥有自己的数据库存储引擎,并实现了高效快速的数据库构建操作,相比Core Data和SQLite,Realm操作要快很多,跟ORM框架相比就更不用说了。
数据库Realm,是用来替代sqlite的一种解决方案,它有一套自己的数据库存储引擎,比sqlite更轻量级,拥有更快的速度,并且具有很多现代数据库的特性,比如支持JSON,流式api,数据变更通知,自动数据同步,简单身份验证,访问控制,事件处理,最重要的是跨平台,目前已有Java,Objective C,Swift,React-Native,Xamarin这五种实现。
开发者应该尝试使用Realm的理由如下:
- 跨平台:Android和ios已经是事实上的两大移动互联网操作系统,绝大部分应用都会支持这两个平台。使用Realm,Android和ios无需考虑内部数据的架构,调用Realm的Api即可轻松完成数据的交互,实现“一个数据库,两个平台之间的无缝衔接”
- 用法简单:相比Core Data和SQLite所需要的入门知识,Relam可以极大降低开发者的学习成本,快速实现数据库存贮功能。
- 可视化操作:Relam为开发者提供了一个轻量级的数据库可视化操作工具,开发者可以轻松查看数据库里的内容,并实现简单的插入和删除操作。
环境搭建:
xxxxxxxxxx
buildscript {
repositories {
jcenter()
google()
maven {
url 'http://oss.jfrog.org/artifactory/oss-snapshot-local'
}
}
dependencies {
classpath "io.realm:realm-gradle-plugin:<version>-SNAPSHOT"
}
}
allprojects {
repositories {
jcenter()
google()
maven {
url 'http://oss.jfrog.org/artifactory/oss-snapshot-local'
}
}
}
使用默认配置
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();
Realm.init(this);
RealmConfiguration config = new RealmConfiguration.Builder()
.name("myRealm.realm")
.deleteRealmIfMigrationNeeded()
.build();
Realm.setDefaultConfiguration(config);
}
}
在AndroidManifest.xml配置自定义的Application
<application
android:name=".MyApplication"
...
/>
创建实体
新建一个类继承RealmObject
public class User extends RealmObject {
public String userName;
public String addr;
public int age;
@PrimaryKey
public long userId;
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public String getAddr() {
return addr;
}
public void setAddr(String addr) {
this.addr = addr;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public long getUserId() {
return userId;
}
public void setUserId(long userId) {
this.userId = userId;
}
@Override
public String toString() {
return "User{" +
"userName='" + userName + '\'' +
", addr='" + addr + '\'' +
", age=" + age +
", userId=" + userId +
'}';
}
}
(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();
User user = realm.createObject(User.class); // Create a new object
user.setUserName("John");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
realm.commitTransaction();
类型二:复制一个对象到Realm数据库
Realm realm=Realm.getDefaultInstance();
User user = new User();
user.setUserName("john");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
// Copy the object to Realm. Any further changes must happen on realmUser
realm.beginTransaction();
realm.copyToRealm(user);
realm.commitTransaction();
(2)实现方法二:使用事务块
Realm mRealm=Realm.getDefaultInstance();
final User user = new User();
user.setUserName("john");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
mRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
realm.copyToRealm(user);
}
});
删
Realm mRealm=Realm.getDefaultInstance();
final RealmResults<User> users= mRealm.where(User.class).findAll();
mRealm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
User user=users.get(5);
user.deleteFromRealm();
//删除第一个数据
users.deleteFirstFromRealm();
//删除最后一个数据
users.deleteLastFromRealm();
//删除位置为1的数据
users.deleteFromRealm(1);
//删除所有数据
users.deleteAllFromRealm();
}
});
同样也可以使用同上的beginTransaction和commitTransaction方法进行删除
改
Realm mRealm=Realm.getDefaultInstance();
Dog dog = mRealm.where(User.class).equalTo("userId", 2).findFirst();
mRealm.beginTransaction();
dog.setName("asd");
mRealm.commitTransaction();
同样也可以用事物块来更新数据
查
(1)查询全部
查询结果为RealmResults,可以使用mRealm.copyFromRealm(users)方法将它转为List
public List<User> queryAllUser() {
Realm mRealm=Realm.getDefaultInstance();
RealmResults<User> usres = mRealm.where(User.class).findAll();
return mRealm.copyFromRealm(usres);
}
(2)条件查询
public User queryUserById(int id) {
Realm mRealm=Realm.getDefaultInstance();
User user = mRealm.where(User.class).equalTo("userId", id).findFirst();
return user;
}
常见的条件如下(详细资料请查官方文档):
between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()
equalTo() & notEqualTo()
contains(), beginsWith() & endsWith()
isNull() & isNotNull()
isEmpty() & isNotEmpty()
(3)对查询结果进行排序
/**
* query (查询所有)
*/
public List<User> queryAllUser() {
RealmResults<User> users = mRealm.where(User.class).findAll();
/**
* 对查询结果,按Id进行排序,只能对查询结果进行排序
*/
//增序排列
users=users.sort("userId");
//降序排列
users=users.sort("userId", Sort.DESCENDING);
return mRealm.copyFromRealm(users);
}
(4)其他查询
sum,min,max,average只支持整型数据字段
/**
* 查询平均年龄
*/
private void getAverageAge() {
double avgAge= mRealm.where(User.class).findAll().average("age");
}
/**
* 查询总年龄
*/
private void getSumAge() {
Number sum= mRealm.where(User.class).findAll().sum("age");
int sumAge=sum.intValue();
}
/**
* 查询最大年龄
*/
private void getMaxId(){
Number max= mRealm.where(User.class).findAll().max("age");
int maxAge=max.intValue();
}
这里就介绍到这里,对于Realm的异步操作,以及数据库的数据迁移(版本升级)可以参考这篇博客
原来不同的CPU架构平台的.so文件增加了整个包的大小,由于arm平台的so在其他平台上面使能够以兼容模式运行的,虽然会损失性能,但是这样可以极大的减少函数库占用的空间。因此,可以选择只保留armeabi-v7a和x86两个平台的.so文件,直接删除无用的.so文件,或者通过在工程的build.gradle文件增加ndk abi过滤 语法如下:
android{
defaultConfig{
ndk{
abiFilters "armeabi-v7a","x86"
}
}
}