Realm DB

  • Realm:
    是我们对数据库的称谓:它包含多个不同的对象,并对应磁盘中的一个文件。

Realm.getInstance(this)来访问我们已初始化的realm变量。该静态方法会为你的当前线程返回一个Realm实例,它对应了您Context.getFilesDir()目录中的default.realm文件。
默认情况下的Realm使用内部存储(internal storage),您的应用并不需要取得任何读写权限。一般来说,这个文件位于/data/data/<packagename>/files/。
可以通过realm.getPath()来获得该Realm的绝对路径。
Realm的实例是线程单例化的,也就是说,在同一个线程内多次调用静态方法获得针对同路径的Realm,会返回同一个Realm实例。

  • RealmConfiguration
    使用 builder 模式构造实例:
    name(String filename): 文件名
    encryptionKey(byte[] key):加密
    schemaVersion(long schemaVersion): 版本号。如果版本号比现有的高,必须提供一个 migration,否则抛异常
    migration(RealmMigration migration): 迁移
    deleteRealmIfMigrationNeeded():不再抛异常,直接删除以前的数据构造版本号,会造成数据丢失。
    inMemory(): 内存数据库,停止后数据删除。
  • Realm方法简析:
    createAllFromJson(Class<E> clazz, JSONArray json): 从 Json 数组中创建 Realm 对象,必须在一个事务中进行。

createObject(Class<E> clazz):向 Realm中实例化并添加一个对象。

copyToRealm(E object): 向 Realm 中copy 一个对象。以后原始对象改变,不会影响 copy的部分,这是个深层 copy,所有被引用的对象都会被 copy。
copyToRealmOrUpdate(E object):
copyToRealm(Iterable<E> objects)

copyFromRealm(Iterable<E> realmObjects):深层 copy,

RealmQuery<E> where(Class<E> clazz) :用于查询
allObjects(Class<E> clazz):返回所有对象。

clear(Class<? extends RealmObject> clazz): 清除指定类的所有对象。

  • 字段类型
    Realm支持以下字段类型:boolean、byte、short、int、long、float、double、String、Date和byte []。整数类型short,int和long都被映射到realm内的相同类型(实际上为long)。再者,还可以使用RealmObject的子类和RealmList<? extends RealmObject>来表示模型关系。
    Realm对象中还可以声明包装类型(boxed type)属性,包括:Boolean、Byte、Short、Integer、Long、Float和Double。通过使用包装类型,可以使这些属性存取空值(null)。

  • @Required 修饰类型和空值(null)
    某些时候,空值(null)对于属性并不合适。这时可以使用注解@Required告诉Realm强制禁止空值(null)被存储。基本数据类型(primitive types)不需要使用注解@Required,因为他们本身就不可为空。

  • 忽略的属性
    注解@Ignore意味着一个字段不应该被保存到Realm。某些时候输入的信息包含比模型更多的字段,而您不希望处理这些未使用的数据字段,您可以用@Ignore来标识这些您希望被Realm忽略的字段。

  • 主键
    @PrimaryKey可以用来定义字段为主键,该字段类型必须为字符串或整数(short、int或long)。不可以存在多个主键。使用支持索引的属性类型作为主键同时意味着为该字段建立索引。
    主键不可被赋予空值(null),使用@PrimaryKey时即同时隐式声明了@Required。

  • 事务
    在任何时间都可以对对象进行访问和查询
    所有的写操作(添加、修改和删除对象),必须包含在写入事务(transaction)中。
    当您在写入事务内处理Realm对象时,您可能会遇到想要放弃更改的情况。您可以简单地取消写入事务:

    realm.beginTransaction();
    User user = realm.createObject(User.class);
    // ...
    ralm.cancelTransaction();

写入事务之间会互相阻塞,如果一个写入事务正在进行,那么其他的线程的写入事务就会阻塞它们所在的线程。
由但得益于 Realm 的 MVCC 架构,当正在进行一个写入事务时读取操作并不会被阻塞!

  • 写入
    当使用realm.copyToRealm()时,请注意只有返回的对象是由Realm管理的,这非常重要。对原始对象(Standalone Object)的任何改变都不会写入Realm.

  • 事务执行块(Transaction blocks)
    除手动调用realm.beginTransaction()、realm.commitTransaction()和realm.cancelTransaction()之外你可以使用realm.executeTransaction()方法,它会自动处理写入事物的开始和提交,并在错误发生时取消写入事物。
    realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
    User user = realm.createObject(User.class);
    user.setName("John");
    user.setEmail("john@corporation.com");
    }
    });

  • 查询
    Realm 中的所有读取(包括查询)操作都是延迟执行的,且数据绝不会被拷贝。

  • 查询条件:
    Realm支持以下查询条件:
    between、greaterThan()、lessThan()、greaterThanOrEqualTo()和lessThanOrEqualTo()
    equalTo()和notEqualTo()
    contains()、beginsWith()和endsWith()
    并非所有条件都适用于所有数据类型,具体请参考RealmQuery API。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,445评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,889评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,047评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,760评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,745评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,638评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,011评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,669评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,923评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,655评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,740评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,406评论 4 320
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,995评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,961评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,023评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,483评论 2 342

推荐阅读更多精彩内容