Relam数据库（OC版本）

1. cocopods 导入

    platform :ios, '11.0'
    target 'TestRealm' do
    use_frameworks!
     pod 'Realm', '~> 10.15.0'
    end
   
    target 'TestRealmTests' do
    use_frameworks!
    pod 'Realm', '~> 10.15.0'
    end
   

2.使用

2.1 头文件 #import <Realm/Realm.h>

2.2

      #import <Foundation/Foundation.h>
      #import <Realm/Realm.h>
      NS_ASSUME_NONNULL_BEGIN
    //注意这里属性的写法 不写策略
    @interface Student : RLMObject
    @property long num;
    @property int age;
    @property NSString *name;
    @end
    RLM_ARRAY_TYPE(Student)

    NS_ASSUME_NONNULL_END

.m

    #import "Student.h"

    @implementation Student
      //  主键
    +(NSString*)primaryKey{
        return @"num";
    }
  //+(NSDictionary*)defaultPropertyValues{
  //    return @{};
  //}
  //+(NSArray*)ignoredProperties{
  //    return @[];
//}
  @end

3 操作

3.1 保存

          创建一个对象
          Student * stu2 = [[Student alloc]initWithValue:@{@"age":@(20),@"name":@"帅哥",@"num":@(4)}];
      生成一rlm
         RLMRealm * rlm = [RLMRealm defaultRealm];

      保存和跟新
       [rlm transactionWithBlock:^{
       // [rlm addObject:stu]; //保存
        [rlm addObject:stu2];//更新
       [rlm addOrUpdateObject:stu2];//保存或者更新
}];
  // 由于realm 有映射关系，下面的代码也能更新数据库表
    [rlm transactionWithBlock:^{
        stu.age = 30;
    }];

3.2 查询

RLMResults<RLMObjectType> : NSObject<RLMCollection, NSFastEnumeration> 可以看成是一个装有RLMObject 模型的数组

    //  根据主键查找
 Student* stu =    [Student objectForPrimaryKey:@(1)];
 [Student objectsInRealm:rlm withPredicate:@"age = 30"];


    // 更具条件查找
   RLMResults *results=  [Student objectsWhere:@"age = 30"]
          [Student objectsInRealm:rlm where:@"age = 30"];

    RLMResults *results= [Student allObjects];
    stu = results.fristObject;
       // 由于realm 有映射关系，下面的代码也能更新数据库表

    [rlm transactionWithBlock:^{
    stu.age = 10;
    }];

删除数据

注意： 删除的模型必须是数据库管理的，不能是自己创建的，应该是从数据库中读取的。

  [rlm transactionWithBlock:^{  
    [rlm deleteObject:stu2];删除一个
    [rlm deleteObjects:@[]];删除多个
    [rlm deleteAllObjects];// 删除所有
}];

分页

第一个3 ，跳过3条
第二个3 ，是取3条
select * from db limit 3,3

兼容的数据类型

1.imge
用连个属性来表示，一个用来外界来读，一个imageData外界用来取

    h 文件
  @property NSData*imageData;
  @property (readonly)UIImage *image;
   m 文件
  -(UIImage*)image{
return [UIImage imageWithData:self.imageData];
}

2 集合 NSArray 字典，集合都不支持，（用imge的方法，或者存字符串）

对应关系

####### 一对一

    #import <Foundation/Foundation.h>
    #import <Realm/Realm.h>
    #import "Dog.h"
    NS_ASSUME_NONNULL_BEGIN

    @interface Student : RLMObject
    @property long num;
    @property int age;
    @property NSString *name;
  @property NSData*imageData;
  @property (readonly)UIImage *image;
  @property  RLMArray<Dog*><Dog> *pet;
  @end
  RLM_ARRAY_TYPE(Student)

  NS_ASSUME_NONNULL_END


    #import "Student.h"
    @implementation Student

    -(UIImage*)image{
      return [UIImage imageWithData:self.imageData];
  }
    +(NSString*)primaryKey{
      return @"num";
  }
  //+(NSDictionary*)defaultPropertyValues{
//    return @{};
//}
//+(NSArray*)ignoredProperties{
//    return @[];
//}
@end


    #import <Foundation/Foundation.h>
    #import <realm/Realm.h>
  @class Student;
  NS_ASSUME_NONNULL_BEGIN

  @interface Dog : RLMObject
  @property int num;
  @property NSString *name;
  @property (readonly) RLMLinkingObjects *master;//定义的这个类型 readlony 是会忽略的
@end

RLM_ARRAY_TYPE(Dog)
NS_ASSUME_NONNULL_END

  #import "Dog.h"

@implementation Dog

    +(NSDictionary<NSString *,RLMPropertyDescriptor *>       *)linkingObjectsProperties{

return  @{@"master":[RLMPropertyDescriptor descriptorWithClass:NSClassFromString(@"Student") propertyName:@"pets"]};//实现了这个，如果student 中的pets 中有这个dog的话，dog 中就会有一个student 反向的对应
}
@end

不能为空的属性

在.m 重实现这个协议，实现了这个协议，如果name 为nil 没有值，在写入数据库的时候会报错，修改的时候也不能改成空。

+(NSArray<NSString *> *)requiredProperties{
    return @[@"name"];// name 必须有值
}

设置默认值

+(NSDictionary*)defaultPropertyValues{
return @{@"name":@"baby"};// 
}

通知

    @interface TestRealmTests : XCTestCase
  // 保存属性
  @property(nonatomic,strong)RLMNotificationToken *token; 
  @end

  @implementation TestRealmTests

  - (void)setUp {
[super setUp];
RLMRealm *real = [RLMRealm defaultRealm];
 self.token =  [real addNotificationBlock:^(RLMNotification  _Nonnull notification, RLMRealm * _Nonnull realm) {
   NSLog(@"接受到了通知 %@ %@",real,notification);
}];

// 这个通知更加牛 RLMCollectionChange 这里面有删除的，插入的，和改变的
self.token2 = [[Student allObjects]addNotificationBlock:^(RLMResults * _Nullable results, RLMCollectionChange * _Nullable change, NSError * _Nullable error) {

}];
// Put setup code here. This method is called before the invocation of each test method in the class.
}

- (void)tearDown {
[self.token invalidate];
[super tearDown];
// Put teardown code here. This method is called after the invocation of each test method in the class.
}

- (void)testExample {

Student * stu = [[Student alloc]initWithValue:@{@"age":@(18),@"name":@"帅哥",@"num":@(1)}];
RLMRealm *real = [RLMRealm defaultRealm];

[real transactionWithBlock:^{
    [real addOrUpdateObject:stu];//这里会发出通知
}];
[real transactionWithBlock:^{
    stu.age = 30; // 这里也会发出通知
}];

用户机制

// 新增一个方法来改边存储表的名字

-(void)setDefaultRealmForuUser:(NSString*)userId{

RLMRealmConfiguration * config = [RLMRealmConfiguration defaultConfiguration];
config.fileURL = [[[config.fileURL URLByDeletingLastPathComponent] URLByAppendingPathComponent:userId]URLByAppendingPathExtension:@"realm"];
[RLMRealmConfiguration setDefaultConfiguration:config];

}

使用

 [self setDefaultRealmForuUser:@"王武"];
  //这里调用的时候就更新林要操作的表的名字
  RLMRealm *real = [RLMRealm defaultRealm];

后面通过调用realm 来操作

删除指定用户的数据库

就是删除指定目录下的文件

-(void)testDelete{
[self setDefaultRealmForuUser:@"lisi"];
NSFileManager *fileManger = [NSFileManager defaultManager];
RLMRealmConfiguration *config = [RLMRealmConfiguration defaultConfiguration];
NSArray*realmfileUrls = @[config.fileURL,
                          [config.fileURL URLByAppendingPathExtension:@"lock"],
                          [config.fileURL URLByAppendingPathExtension:@"management"],
                          [config.fileURL 
        ];
for (NSURL *url in realmfileUrls) {
    [fileManger removeItemAtPath:url error:nil];
}
}

数据库的迁移

    RLMRealmConfiguration * config = [RLMRealmConfiguration defaultConfiguration];
config.schemaVersion = 1;

[config setMigrationBlock:^(RLMMigration * _Nonnull migration, uint64_t oldSchemaVersion) {
    if (config.schemaVersion > oldSchemaVersion) {

        这里不需要做什么就会自动实现数据迁移
  //更名操作，将Student 中的name1 改成name2
 [migration renamePropertyForClass:@"Student" oldName:@"name1" newName:@"name2"];

  // 下面的操作是将 Student模型中的fullNmae 用老的name1 和老的name2 的数据拼接起来，到达数据库迁移的时候合成fullNmae 的值
[migration enumerateObjects:@"Student" block:^(RLMObject * _Nullable oldObject, RLMObject * _Nullable newObject) {
            newObject[@"fullNmae"] = [NSString stringWithFormat:@"%@%@",oldObject[@"name1"],oldObject[@"name2"]];
        }]
    }
}];
[RLMRealmConfiguration setDefaultConfiguration:config];
[RLMRealm defaultRealm];