【Android -- 开源库】数据库 Realm 的基本使用
简介
Realm 是一个 MVCC (多版本并发控制)数据库,由Y Combinator公司在2014年7月发布一款支持运行在手机、平板和可穿戴设备上的嵌入式数据库,目标是取代 SQLite。Realm 本质上是一个嵌入式数据库,他并不是基于 SQLite 所构建的。它拥有自己的数据库存储引擎,可以高效且快速地完成数据库的构建操作。和 SQLite 不同,它允许你在持久层直接和数据对象工作。在它之上是一个函数式风格的查询 API,众多的努力让它比传统的SQLite 操作更快 。
GitHub 地址:realm-java
优点
易用
Ream 不是在SQLite基础上的ORM,它有自己的数据查询引擎。并且十分容易使用。快速
由于它是完全重新开始开发的数据库实现,所以它比任何的ORM速度都快很多,甚至比SLite速度都要快。跨平台
Realm 支持 iOS & OS X (Objective‑C & Swift) & Android。我们可以在这些平台上共享Realm数据库文件,并且上层逻辑可以不用任何改动的情况下实现移植。高级
Ream支持加密,格式化查询,易于移植,支持JSON,流式api,数据变更通知等高级特性可视化
Realm 还提供了一个轻量级的数据库查看工具,在Mac Appstore 可以下载“Realm Browser”这个工具,开发者可以查看数据库当中的内容,执行简单的插入和删除数据的操作。
使用
1. 添加依赖
- 在
project
的build
中加入依赖
buildscript {repositories {jcenter()}dependencies {classpath "io.realm:realm-gradle-plugin:2.2.1"}
}
- 在
module
中加入
apply plugin: 'realm-android'
2. 创建 model
创建一个 User 类,需要继承 RealmObject 。支持public, protected和 private的类以及方法
public class User extends RealmObject {private String name;private int age;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;}
}
除了直接继承于 RealmObject
来声明 Realm 数据模型之外,还可以通过实现 RealmModel
接口并添加 @RealmClass
修饰符来声明。
@RealmClass
public class User implements RealmModel {...
}
3. 初始化
使用默认配置:
Realm.init(this);Realm mRealm = Realm.getDefaultInstance();
这时候会创建一个叫做 default.realm
的Realm文件,一般来说,这个文件位于/data/data/包名/files/。通过realm.getPath()
来获得该Realm的绝对路径。
注意:模拟器上运行时,Realm.getDefaultInstance()抛出异常,真机上没问题
当然,我们还可以使用 RealmConfiguration
来配置 Realm
RealmConfiguration config = new RealmConfiguration.Builder() .name("myrealm.realm") //文件名.schemaVersion(0) //版本号.build();
Realm realm = Realm.getInstance(config);
4. 关闭 Realm
记得使用完后,在 onDestroy 中关闭 Realm
@Override
protected void onDestroy() { super.onDestroy();// Close the Realm instance. realm.close();
}
5. 版本升级
当数据结构发生变化是,需要升级数据库。对于Realm来说,数据库升级就是迁移操作,把原来的数据库迁移到新结构的数据库。
例1:User类发生变化,移除age,新增个@Required的id字段。
User版本:version 0
String name;
int age;
User版本:version 1
@Required
String id;
String name;
创建迁移类 CustomMigration
,需要实现RealmMigration
接口。执行版本升级时的处理:
/*** 升级数据库*/class CustomMigration implements RealmMigration {@Overridepublic void migrate(DynamicRealm realm, long oldVersion, long newVersion) {RealmSchema schema = realm.getSchema();if (oldVersion == 0 && newVersion == 1) {RealmObjectSchema personSchema = schema.get("User");//新增@Required的idpersonSchema.addField("id", String.class, FieldAttribute.REQUIRED).transform(new RealmObjectSchema.Function() {@Overridepublic void apply(DynamicReal
mObject obj) {obj.set("id", "1");//为id设置值}}).removeField("age");//移除age属性oldVersion++;}}}
使用Builder.migration
升级数据库,将版本号改为1(原版本号:0)。当Realm发现新旧版本号不一致时,会自动使用该迁移类完成迁移操作。
RealmConfiguration config = new RealmConfiguration.Builder() .name("myrealm.realm") //文件名.schemaVersion(1) .migration(new CustomMigration())//升级数据库.build();
6. 增
写入操作需要在事务中进行,可以使用executeTransaction
方法来开启事务。
- 使用executeTransaction方法插入数据
mRealm.executeTransaction(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {User user = realm.createObject(User.class);user.setName("Gavin");user.setAge(23);}});
注意:如果在UI线程中插入过多的数据,可能会导致主线程拥塞。
- 使用copyToRealmOrUpdate或copyToRealm方法插入数据
当Model中存在主键的时候,推荐使用copyToRealmOrUpdate方法插入数据。如果对象存在,就更新该对象;反之,它会创建一个新的对象。若该Model没有主键,使用copyToRealm方法,否则将抛出异常。
final User user = new User();user.setName("Jack");user.setId("2");mRealm.executeTransaction(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {realm.copyToRealmOrUpdate(user);}});
- 使用
executeTransactionAsync
该方法会开启一个子线程来执行事务,并且在执行完成后进行结果通知。
RealmAsyncTask transaction = mRealm.executeTransactionAsync(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {User user = realm.createObject(User.class);user.setName("Eric");user.setId("4");}
});
注意:如果当Acitivity或Fragment被销毁时,在OnSuccess或OnError中执行UI操作,将导致程序奔溃 。用RealmAsyncTask .cancel();可以取消事务
7. 删
- 使用deleteFromRealm()
//先查找到数据
final RealmResults userList = mRealm.where(User.class).findAll();
mRealm.executeTransaction(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {userList.get(0).deleteFromRealm();}
});
- 使用deleteFromRealm(int index)
mRealm.executeTransaction(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {userList.deleteFromRealm(0);}
});
8. 改
mRealm.executeTransaction(new Realm.Transaction() {@Overridepublic void execute(Realm realm) {//先查找后得到User对象User user = mRealm.where(User.class).findFirst();user.setAge(26);}
});
9. 查
- findAll ——查询
RealmResults userList = mRealm.where(User.class).findAll();
- findAllAsync——异步查询
RealmResults userList = mRealm.where(User.class).equalTo("name", "Kevin").findAllAsync();
- findFirst ——查询第一条数据
User user2 = mRealm.where(User.class).findFirst();
- equalTo ——根据条件查询
RealmResults userList = mRealm.where(User.class).equalTo("name", "Kevin").findAll();
- equalTo ——多条件查询
RealmResults userList = mRealm.where(User.class).equalTo("name", "Kevin").findAll();
RealmResults userList = user5.where().equalTo("dogs.name", "二哈").findAll();
想了解更多请查看 :
encryptionExample
【Android -- 开源库】数据库 Realm 的基本使用相关推荐
- 《Android开源库》 Realm For Android~ Queries(译文)
查询 Realm 中的所有读取(包括查询)操作都是延迟执行的,且数据绝不会被拷贝. Realm 的查询引擎使用 Fluent interface 来构造多条件查询. 使用 User 类 - publi ...
- GitHub 上排名前 100 的 Android 开源库介绍
转自:http://www.codeceo.com/article/github-top-100-android-libs.html 本项目主要对目前 GitHub 上排名前 100 的 Androi ...
- 排名前100的Android开源库
本项目主要对目前GitHub上排名前100的Android开源库进行简单的介绍,至于排名完全是根据GitHub搜索Java语言选择「BestMatch」得到的结果,然后过滤了跟Android不相关的项 ...
- GitHub 上排名前 100 的 Android 开源库进行简单的介绍
本文转载于:https://github.com/Freelander/Android_Data/blob/master/Android-Librarys-Top-100.md 本项目主要对目前 Gi ...
- GitHub上排名前100的Android开源库介绍
摘要: 本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍,至于排名完全是根据 GitHub 搜索 Java 语言选择 (Best Match) 得到的结果,然 ...
- 我的Android进阶之旅】GitHub 上排名前 100 的 Android 开源库进行简单的介绍
GitHub Android Libraries Top 100 简介 本文转载于:https://github.com/Freelander/Android_Data/blob/master/And ...
- 《Android开源库 ~ 1》 GitHub Android Libraries Top 100 简介
转载自GitHub Android Libraries Top 100 简介 本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍, 至于排名完全是根据 GitH ...
- GitHub上排名前100的Android开源库(201603)
https://github.com/Freelander/Android_Data/blob/master/Android-Librarys-Top-100.md 本项目主要对目前 GitHub 上 ...
- 【基础学习】GitHub 上100 的 Android 开源库分享
本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍, 至于排名完全是根据GitHub搜索Java语言选择 (Best Match) 得到的结果, 然后过滤了跟A ...
- GitHub上排名前100的Android开源库
转载于:https://github.com/Freelander/Android_Data/blob/master/Android-Librarys-Top-100.md 本项目主要对目前 GitH ...
最新文章
- 白话Elasticsearch62-进阶篇之Highlighting高亮显示
- python lib head,使用Python 2中的urllib2发出HTTP HEAD请求
- 转:Xcode下的GDB调试命令
- 我对软件测试的理解以及我的职业规划
- 关于从EXCEL中导入到SQL server中的问题
- HTML wbr元素
- 使用Java处理大文件
- easypoi list中的map导出_EasyPOI简单用例,简单有效
- vue rem移动端适配
- idea重写接口没有@override_【自学C#】|| 笔记 19 接口
- 开机时无法进入系统,提示windows system32/winload.exe 无法加载
- ITIL 4 Foundation-指导原则
- HEAD detached at ---
- jenkins编译java项目时无法读取pom.xml文件
- 如何做好公众号编辑—壹间网络
- 今天考了关于java认证的OCJP,特此谈谈个人java学习过程及心得
- win10硬盘锁怎么解除_如何解锁BitLocker加密的Win10系统【图文教程】
- 给水管网漏损控制策略国内外差异与思考
- 容器化与无状态微服务等
- 区块链的基本概念和工作原理
热门文章
- AWS 中文入门开发教学 35- MySQL@RDS - 建立MySQL数据库服务
- 电脑如何同时远程控制多台手机
- HAL库开发—基于stm32的智能小家电
- Session | web应用的session机制、session的实现原理
- 联想x3650服务器安装硬盘,IBM x3650 M2服务器系统安装攻略(组图)
- 学生成绩测评系统python_python实现学生成绩测评系统
- XP系统电脑开机桌面上什么文件都没有啦怎么办
- 关于win10中视频文件不显示缩略图的问题
- 渗透测试-11种绕过CDN查找真实IP的方法
- webpack打包图片资源问题