简介
接触Realm已经有一段时间了，但是一直忙着项目，一直没有时间做一下笔记。趁着项目闲着之际，我开始着手记录我自己使用Realm过程遇到的坑。Realm是一个跨平台的数据库，就拿iOS来说，数据库常用的几种无非是Sqlite、FMDB、CoreData这几种，每一种数据库都在某些方面有着特别的优势。对于coreData,在每次使用的时候都要创建一大堆的代码，个人是累觉不爱。而对于Sqlite是基于C语言的，用起来也是相对麻烦，FMDB是基于Sqlite的封装，用起来还相对友好一点，但是还是要写一大堆的sql语句，但是无可否认的是，在API上FMDB还是蛮简单上手的。但是今天重点介绍的是Realm.
Realm是由Y Combinator孵化的创业团队开源出来的一款可以用于iOS(同样适用于Swift&Objective-C)和Android的跨平台移动数据库。目前最新版是Realm 2.0.2，支持的平台包括Java，Objective-C，Swift，React Native，Xamarin。
安装方法主要有四种（在这就不做说明） 1.Dynamic Framework(动态库) 2.CocoaPod 3.Carthage(仅支持iOS8以上) 4.Static Framework
Realm 中的相关术语
为了能更好的理解Realm的使用，先介绍一下涉及到的相关术语。
RLMRealm：Realm是框架的核心所在，是我们构建数据库的访问点，就如同Core Data的管理对象上下文（managed object context）一样。出于简单起见，realm提供了一个默认的defaultRealm( )的便利构造器方法。
RLMObject：这是我们自定义的Realm数据模型。创建数据模型的行为对应的就是数据库的结构。要创建一个数据模型，我们只需要继承RLMObject，然后设计我们想要存储的属性即可。
关系(Relationships)：通过简单地在数据模型中声明一个RLMObject类型的属性，我们就可以创建一个“一对多”的对象关系。同样地，我们还可以创建“多对一”和“多对多”的关系。
写操作事务(Write Transactions)：数据库中的所有操作，比如创建、编辑，或者删除对象，都必须在事务中完成。“事务”是指位于write闭包内的代码段。
查询(Queries)：要在数据库中检索信息，我们需要用到“检索”操作。检索最简单的形式是对Realm( )数据库发送查询消息。如果需要检索更复杂的数据，那么还可以使用断言（predicates）、复合查询以及结果排序等等操作。
RLMResults：这个类是执行任何查询请求后所返回的类，其中包含了一系列的RLMObject对象。RLMResults和NSArray类似，我们可以用下标语法来对其进行访问，并且还可以决定它们之间的关系。不仅如此，它还拥有许多更强大的功能，包括排序、查找等等操作。
Realm 的基本使用
1.创建数据库
- 1.使用系统默认的数据库
- 2.自定义数据库（代码实现的是自定义的数据库）
Object-C
RLMRealm *realm = [RLMRealm defaultRealm];复制代码
- (BOOL) initRealm { RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration]; config.fileURL = [[[config.fileURL URLByDeletingLastPathComponent] URLByAppendingPathComponent:[NSString stringWithFormat:@"Message%lu",(unsigned long)self.messageType]] URLByAppendingPathExtension:@"realm"]; debugLog(@"Realm file path: %@", config.fileURL); NSError *error; _realm = [RLMRealm realmWithConfiguration:config error:&error]; if (nil != error) { NSLog(@"Create Realm Error"); return NO; } debugLog(@"create realm success"); return YES;}复制代码 Swift
// MARK: - 初始化Rleam数据库 func createDataBase() { var config = Realm.Configuration() config.fileURL = config.fileURL?.deletingLastPathComponent().appendingPathComponent("HJQ").appendingPathExtension("Realm") var realm: Realm? do { realm = try Realm.init(configuration: config) } catch { debugLog(error) } debugLog(realm) }复制代码 2.建表
Object-C
#import#import @interface UserMessageList : RLMObject@property NSString *title;@property NSInteger linkType;@property NSInteger messageId;@property BOOL readStatus;@property NSString *content;@property long long createTime;@property NSString *picUrl;@endRLM_ARRAY_TYPE(UserMessageList);@interface GFBUserMessageMD : RLMObject@property NSString *username;@property RLMArray *userMessageList;@endRLM_ARRAY_TYPE(GFBUserMessageMD);复制代码
注意，RLMObject 官方建议不要加上 Objective-C的property attributes(如nonatomic, atomic, strong, copy, weak 等等）假如设置了，这些attributes会一直生效直到RLMObject被写入realm数据库。
RLM_ARRAY_TYPE宏创建了一个协议，从而允许 RLMArray语法的使用。如果该宏没有放置在模型接口的底部的话，您或许需要提前声明该模型类。
关于RLMObject的的关系
1.对一(To-One)关系
对于多对一(many-to-one)或者一对一(one-to-one)关系来说，只需要声明一个RLMObject子类类型的属性即可
2.对多(To-Many)关系(重点介绍) 通过 RLMArray类型的属性您可以定义一个对多关系。如上面代码例子，@property RLMArray *userMessageList;
3.反向关系(Inverse Relationship)
#import "GFBUserMessageMD.h"@implementation GFBUserMessageMD// 为了保证表的唯一性，设置主键+ (NSString *)primaryKey { return @"username";}@end@implementation UserMessageList@end复制代码 Swift
import UIKitimport RealmSwift>class UserMessageMD: Object { dynamic var title: String? dynamic var messageID: String!}>class UserMD: Object { dynamic var userID: String! dynamic var name: String! > // List 是个泛型 var userMessages = List () > // MARK: - 设置主键 override static func primaryKey() -> String? { return "userID" }}复制代码 3.数据的插入
Object-C
- (void) insertOrCreateData:(GFBSysMessageListMD *)md { GFBUserMessageMD *userMD; NSString *userId = [QFUserInfo shareInfo].username; if (! userId) { return; } // 查询当前是否有这个表 if ([GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]) { userMD = [GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]; }else { userMD = [GFBUserMessageMD new]; userMD.username = userId; } [_realm transactionWithBlock:^{ for (int i = 0; i < md.data.content.count; i++) { SysMessageListContent *model = md.data.content[i]; UserMessageList *userMessageMD; NSPredicate *pred = [NSPredicate predicateWithFormat:@"messageId = %li",model.id]; if([userMD.userMessageList indexOfObjectWithPredicate:pred] != NSNotFound) { // 如果该数据已经存在则无需重新插入 NSUInteger index = [userMD.userMessageList indexOfObjectWithPredicate:pred]; userMessageMD = userMD.userMessageList[index]; debugLog(@"我是查询的结果%lu",index); }else{ // 插入新的数据 userMessageMD = [UserMessageList new]; userMessageMD.title = model.title; userMessageMD.messageId = model.id; userMessageMD.content = model.content; userMessageMD.createTime = model.createTime; userMessageMD.readStatus = NO; userMessageMD.linkType = model.linkType; userMessageMD.picUrl = model.picUrl; [userMD.userMessageList addObject:userMessageMD]; } } [GFBUserMessageMD createOrUpdateInRealm:_realm withValue:userMD]; }];}复制代码 Swift
// MARK: - 建表插入数据 func insertData() { let realm = try! Realm() // 通过主键查找到对应的数据 var userMD = realm.object(ofType: UserMD.self,forPrimaryKey: "") if userMD == nil { userMD = UserMD() } let messageID = "10000" try! realm.write { var userMessageMD: UserMessageMD? = nil let pred = NSPredicate(format: "messageID = \(messageID) ") let resultIndex = userMD!.userMessages.index(matching: pred) if resultIndex != NSNotFound { // 已经存在 userMessageMD = userMD!.userMessages[resultIndex!] }else { userMessageMD = UserMessageMD() // 不存在则继续追加 userMD?.userMessages.append(userMessageMD!) } realm.add(userMD!, update: true) } }复制代码 4.数据的更新
- (void) updateReadStatus:(NSInteger) index { GFBUserMessageMD *userMD; NSString *userId = [QFUserInfo shareInfo].username; if (! userId) { return; } // 查询当前是否有这个表 if ([GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]) { userMD = [GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]; } if (userMD) { [_realm transactionWithBlock:^{ UserMessageList *userMessageMD = userMD.userMessageList[index]; userMessageMD.readStatus = YES; [GFBUserMessageMD createOrUpdateInRealm:_realm withValue:userMD]; }]; }}复制代码 5.数据的查询
Object-C
// 查找所有的数据- (void) queryAllData { GFBUserMessageMD *userMD; NSString *userId = [QFUserInfo shareInfo].username; if (! userId) { return; } // 查询当前是否有这个表 if ([GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]) { userMD = [GFBUserMessageMD objectInRealm:_realm forPrimaryKey:userId]; } if (userMD) { debugLog(@"当前存在的数据%@",userMD.userMessageList); }}复制代码 Swift
// MARK: - 查询数据 func queriesDatas() { let realm = try! Realm() // 通过主键查找到对应的数据 let userMD = realm.object(ofType: UserMD.self,forPrimaryKey: "") debugLog(userMD) }复制代码