realm是跨平台开发,使用C++编写,并是不对sqlite的封装,是有独立的数据库存储引擎.比sqlite和coredate性能还好.
官网介绍的realm支持的数据类型
1-4.png
说明:为方便测试,这里我使用Xcode自带的单元测试来操作.
准备工作:
1.去官网下载realm,我这里选择的是realm-Objc
2.下载realm-objc安装包,打开realm-objc-2.9.1-->plugin-->RealmPlugin,安装realm的插件.直接编译运行即可,安装完成后即有个realm的模型
1-1.png
realm简单使用步骤
1.新建一个工程,通过cocoapods方式继承到项目中.
首次安装时间可能久点,看到以下信息代表安装成功
Sending stats
- Realm, 3.0.0-beta.2
-> Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.
2创建单元测试模块
1-2.png
这里我们直接在RealmDemoTests文件中导入#import <Realm/Realm.h>可能会报
Realm/Realm.h file not found 的错(如果没有报错,请自动忽略.)
1-3.png
解决办法只需修改Podfile文件,只需pod install即可.
原Podfile文件内容
platform :ios, '9.0'
target 'RealmDemo' do
use_frameworks!
# Pods for RealmDemo
pod 'Realm', '~> 3.0.0-beta.2'
end
修改方案1:(推荐方法)
target 'RealmObjc' do
# Pods for RealmObjc
pod 'Realm', '~> 3.0.0-beta.2'
target 'RealmObjcTests' do
inherit! :search_paths
# Pods for testing
end
end
修改方案2:
platform :ios, '9.0'
target 'RealmDemo' do
use_frameworks!
# Pods for RealmDemo
pod 'Realm', '~> 3.0.0-beta.2'
end
target 'RealmDemoTests' do
use_frameworks!
# Pods for RealmDemoTests
pod 'Realm', '~> 3.0.0-beta.2'
end
3.创建一个继承于RLMObject的model,我们在.h文件中生命对应的属性.
注意:这里生命属性的时候最好不要有(nonatomic,strong)属性的修饰,官网也建议我们不要有修饰,避免出错.
例:官网标准写法
// Define your models like regular Objective‑C classes
interface Dog : RLMObject
property NSString *name;
property NSData *picture;
property NSInteger age;
@end
@implementation Dog
@end
RLM_ARRAY_TYPE(Dog)
所以我们的生命也是如下的写法:
@interface Stu : RLMObject
@property int num;
@property NSString *name;
@end
4.数据库操作
4..1创建模型------增
//方法1:
Stu *stu = [[Stu alloc]initWithValue:@[@2,@"土豆"]];
RLMRealm *realm = [RLMRealm defaultRealm];
[realm beginWriteTransaction];
[realm addObject:stu];
[realm commitWriteTransaction];
//方法2:
Stu *stu = [[Stu alloc]initWithValue:@[@2,@"土豆"]];
RLMRealm *realm = [RLMRealm defaultRealm];
[realm transactionWithBlock:^{
[realm addObject:stu];
}];
//方法3:
RLMRealm *realm = [RLMRealm defaultRealm];
[realm transactionWithBlock:^{
[Stu createInRealm:realm withValue:@{@"num":@3,@"name":@"哈哈"}];
}];
4.2.删除数据 ------ 删
//1.删除所有模型
RLMRealm *realm = [RLMRealm defaultRealm];
//删除的模型,一定要求是被realm所管理的
[realm transactionWithBlock:^{
[realm deleteAllObjects];
}];
//2.删除某条数据
RLMRealm *realm = [RLMRealm defaultRealm];
Stu *stu = [[Stu alloc]initWithValue:@[@2,@"土豆"]];
//删除的模型,一定要求是被realm所管理的
[realm transactionWithBlock:^{
[realm deleteObject:stu];
}];
//3. 删除某一特定类型的所有模型
RLMRealm *realm = [RLMRealm defaultRealm];
RLMResults *stuRes = [Stu allObjects];
for (Stu *stu in stuRes) {
[realm transactionWithBlock:^{
[realm deleteObject:stu];
}];
}
//4. 根据主键 删除一个模型
//1.根据主键,查询到这个模型(这个模型,就是被realm数据库管理的模型)
Stu *stuDel = [Stu objectInRealm:realm forPrimaryKey:@2];
//2.删除该模型
[realm transactionWithBlock:^{
[realm deleteObject:stuDel];
}];
4.3.更新模型属性的值 ------改
//写法1:
- (void)testUpdate{
Stu *stu = [[Stu alloc]initWithValue:@[@2,@"土豆"]];
RLMRealm *realm = [RLMRealm defaultRealm];
//这个模型stu已经被realm管理,而且已经和磁盘上的对象进行了地址映射
[realm transactionWithBlock:^{
[realm addObject:stu];
NSLog(@"num:%d name: %@",stu.num,stu.name);
}];
//这里面修改的模型,一定是被realm所管理的模型
[realm transactionWithBlock:^{
stu.name = @"拉阿拉";
NSLog(@"num:%d name: %@",stu.num,stu.name);
}];
}
//写法2:
RLMResults *results = [Stu objectsWhere:@"name = '拉阿拉'"];
Stu *stu = results.firstObject;
[realm transactionWithBlock:^{
stu.name = @"xxxxxxx拉阿拉xxxxxxxx";
NSLog(@"num:%d name: %@",stu.num,stu.name);
}];
//方法3:
Stu *stu = [[Stu alloc]initWithValue:@[@2,@"土豆"]];
RLMRealm *realm = [RLMRealm defaultRealm];
[realm transactionWithBlock:^{
[realm addOrUpdateObject:stu];
NSLog(@"num:%d name: %@",stu.num,stu.name);
}];
//方法4:
RLMRealm *realm = [RLMRealm defaultRealm];
[realm transactionWithBlock:^{
[Stu createOrUpdateInRealm:realm withValue:@{@"num":@3,@"name":@"哈哈"}];
}];
4.4.查找数据 ------查
方法1:
//查询所有对象
//所有的查询(包括查询和属性访问)在realm中都是延迟加载的,终于当属性被访问时,才能够读取相应的数据
RLMResults *result = [Stu allObjects];
NSLog(@"%@",result);
方法2:
//带条件的查询
RLMResults <Stu *> *result2 = [Stu objectsWhere:@"name = '土豆'"];
NSLog(@"%@",result2);
方法3:
//对查询结果升序降序
RLMResults *sorRes = [result sortedResultsUsingKeyPath:@"name" ascending:YES];
NSLog(@"%@",sorRes);
方法4:
//链式查询 在sorRes的结果集里查找结果.
RLMResults *subRes = [sorRes objectsWhere:@"name = '哈哈'"];
NSLog(@"%@",subRes);
小结:
常见错误总结:
错误1:
bug01.png
一般这种错误的原因都是因为你修改了模型的属性,或者增加了模型的属性字段造成的.
解决办法:详见5.数据库迁移操作--适用于修改了表结构的情况
错误2:
这种错误的原因一般都是因为模型中有必填的字段,而你却没有给该字段赋值造成的.
解决办法:给改字段赋值即可.
bug03.png
小技巧:
realm中如果想要更改数据库的名字,只需要在保存对象前调用一下这个方法即可
tips02.png
tips01.png
- (void)setDefaultRealmForUser:(NSString *)username{
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//使用默认的目录,使用用户名来替换默认的文件名
config.fileURL = [[[config.fileURL URLByDeletingLastPathComponent]URLByAppendingPathComponent:username]URLByAppendingPathExtension:@"realm"];
//将这个配置应用到默认的realm数据库中
[RLMRealmConfiguration setDefaultConfiguration:config];
}
5.数据库迁移操作--适用于修改了表结构的情况
5.1数据结构的迁移
操作步骤:
1.创建一个Stu的模型,并声明一个name的属性
@interface Stu : RLMObject
@property NSString *name;
@end
RLMRealm *realm = [RLMRealm defaultRealm];
Stu *stu = [[Stu alloc]initWithValue:@{@"name":@"Allison"}];
[realm transactionWithBlock:^{
[realm addObject:stu];
NSLog(@" ------- name: %@,stu.name);
}];
此时运行数据库中会多一个名字为Allison的数据.
但是如果此时我们修改了Stu的模型,如在模型中加一个@property int age;的字段,修改代码中 *Stu stu = [[Stu alloc]initWithValue:@{@"name":@"Allison",@"age":@20}];,再次运行,会报一下的错误信息
bug03.png
这里提示需要迁移数据,原因是因为表的结构变化了,所以需要迁移数据.
5.2.数据迁移
在APPdelegate里的didFinishLaunchingWithOptions方法里面写数据迁移.
//1.获取默认配置
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//2.叠加版本号(要比上一次的版本号高) 默认版本号0
int newVersion = 1;
config.schemaVersion = newVersion;
//3.具体怎样迁移
[config setMigrationBlock:^(RLMMigration *migration, uint64_t oldSchemaVersion){
if (oldSchemaVersion < newVersion) {
NSLog(@"需要做迁移操作");
}
}];
//4.让配置生效
[RLMRealmConfiguration setDefaultConfiguration:config];
//5.如果需要立即生效
[RLMRealm defaultRealm];
这里运行此处的代码,即可完成数据迁移的操作,表结构就会多一个age字段,之前的数据也存在.block中无需做任何事情,就可以完成数据结构和数据的迁移.
但是如果是这样的场景比如说我想合并两列的内容到一列,如fullName = preName + lastName
修改Stu的模型 ,增加preName,lastName和fullName属性.
@interface Stu : RLMObject
@property int age;
@property NSString *name;
@property NSString *preName;
@property NSString *lastName;
@property NSString *fullName;
@end
修改刚代码如下
RLMRealm *realm = [RLMRealm defaultRealm];
Stu *stu = [[Stu alloc]init];
stu.age = 20;
stu.name = @"Allison";
stu.preName = @"XXXXX";
stu.lastName = @"wangjiaojiao";
[realm transactionWithBlock:^{
[realm addObject:stu];
}];
运行数据库中即有preName何lastName数据信息.
修改迁移代码如下
//1.获取默认配置
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
//2.叠加版本号(要比上一次的版本号高) 0
int newVersion = 9;
config.schemaVersion = newVersion;
//3.具体怎样迁移
[config setMigrationBlock:^(RLMMigration *migration, uint64_t oldSchemaVersion){
if (oldSchemaVersion < newVersion) {
[migration enumerateObjects:@"Stu" block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
newObject[@"fullName"] = [NSString stringWithFormat:@"%@%@",newObject[@"preName"],newObject[@"lastName"]];
}];
}
}];
//4.让配置生效
[RLMRealmConfiguration setDefaultConfiguration:config];
//5.如果需要立即生效
[RLMRealm defaultRealm];
5.3.属性重命名---更名动作
比如说将刚刚的fullName更名为fullName2
只需要修改block中的代码如下
//执行更名动作
[migration renamePropertyForClass:@"Stu" oldName:@"fullName" newName:@"fullName2"];
5.4.多版本增量式迁移
比如:我们线上的版本1.0,数据库版本1.1,用户A,B.C分别装在手机上了,后期我线上的版本升级到了2.0,数据库版本也升级到了2.0,用户A升级到了2.0,但是用户B,C没有升级,手机上依旧是1.0.这个时候我们又迭代了一个版本3.0,数据库版本3.0,这个时候就是这样子
用户A: 数据库版本 2.0
用户B: 数据库版本 1.0
用户C: 数据库版本 1.0
这个时候数据库版本1.0升级到3.0,和2.0升级到3.0操作是不一样的
所以在升级操作的block中应该分开来操作
if (oldSchemaVersion < 1) {
//迁移第一个版本
}
if (oldSchemaVersion < 2) {
//迁移第二个版本
}
//等等...
