CloudKit使用教程<一>
CloudKit使用教程<二>
CloudKit 基础对象类型
CloudKit 的基础对象类型有 7 种。这些对象类型可能和你在其他编程领域了解的类似对象类型稍有差别。
CKContainer: Containers 就像应用运行的沙盒一样，一个应用只能访问自己沙盒中的内容而不能访问其他应用的。Containers 就是最外层容器，每个应用有且仅有一个属于自己的 container。（事实上，经过开发者授权配置 CloudKit Dashboard 之后，一个应用也可以访问其他应用的 container,即共享容器）
CKDatabase: Database 即数据库，私有数据库用来存储敏感信息，比如说用户的性别年龄等，用户只能访问自己的私有数据库。应用也有一个公开的数据库来存储公共信息，例如你在构建一个根据地理位置签到的应用，那么地理位置信息就应该存储在公共数据库里以便所有用户都能访问到。
CKRecord: 即数据库中的一条数据记录。CloudKit 使用 record 通过 k/v 结构来存储结构化数据。关于键值存储，目前值的架构支持 NSString、NSNumber、NSData、NSDate、CLLocation，和 CKReference、CKAsset（这两个下面我们会说明），以及存储以上数据类型的数组。
CKRecordZone: Record 不是以零散的方式存在于 database 之中的，它们位于 record zones 里。每个应用都有一个 default record zone，你也可以有自定义的 record zone。
CKRecordIdentifier: 是一条 record 的唯一标识，用于确定该 record 在数据库中的唯一位置。
CKReference: Reference 很像 RDBMS 中的引用关系。还是以地理位置签到应用为例，每个地理位置可以包含很多用户在该位置的签到，那么位置与签到之间就形成了这样一种包含式的从属关系。
CKAsset: 即资源文件，例如二进制文件。还是以签到应用为例，用户签到时可能还包含一张照片，那么这张照片就会以 asset 形式存储起来。
可存储的数据类型
- NSData (single bytes)
- NSDate (date and time)
- NSNumber (both Int and Double)
- NSString (or String in Swift)
- NSArray (list)
- CKReference (used to create relationships between objects)
- CLLocation (location)
- CKAsset (file)
支持的索引类型:
- NSString
- NSDate
- NSNumber
- NSArray
- CKReference
- CLLocation
如何匹配查询:
%@用于对象的值,%K用于对象的字段
@"self contains 'blue'" 会搜索所有字段对应的值是否包含blue,但是只能搜索字段是NSString类型的.
- 匹配favoriteColors 有 red 的记录
NSPredicate predicate = nil;
predicate = [NSPredicate predicateWithFormat:@"ANY favoriteColors = 'red'"];
predicate = [NSPredicate predicateWithFormat:@"favoriteColors CONTAINS 'red'"];
predicate = [NSPredicate predicateWithFormat:@"'red' IN favoriteColors"];
predicate = [NSPredicate predicateWithFormat:@"%K CONTAINS %@", @"favoriteColors", @"red"];
- 同时匹配多个词
NSPredicate predicate = nil;
predicate = [NSPredicate predicateWithFormat:@"ANY { 'red', 'green' } = favoriteColor"];
predicate = [NSPredicate predicateWithFormat:@"favoriteColor IN { 'red', 'green' }"];
- 匹配以某个字符串开始的记录
NSString* matchString = @"red";
NSPredicate predicate = nil;
predicate = [NSPredicate predicateWithFormat:@"ANY favoriteColors BEGINSWITH 'red'"]
predicate = [NSPredicate predicateWithFormat:@"ANY favoriteColors BEGINSWITH %@", matchString]
- 匹配当前记录(的所有字段对应的值)是否包含某个字符串
NSPredicate predicate = nil;
predicate = [NSPredicate predicateWithFormat:@"self contains 'bob smith'"];
- 匹配当前记录(的所有字段对应的值)是否包含多个字符串
NSPredicate predicate = nil;
predicate = [NSPredicate predicateWithFormat:@"self contains 'bob' AND self contains ‘smith’”];
- 根据地理位置查询
CLLocation* fixedLoc = [[CLLocation alloc] initWithLatitude:37.331913 longitude:-122.030210];
CGFloat radius = 10000; // meters
NSPredicate predicate = [NSPredicate predicateWithFormat:@"distanceToLocation:fromLocation:(location, %@) < %f", fixedLoc, radius]];
线程依赖处理
CKRecordID *firstID = [[CKRecordID alloc] initWithRecordName:@"115"];
CKRecordID *secondID = [[CKRecordID alloc] initWithRecordName:@"116"];
[public_db fetchRecordWithID:firstID completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
[public_db fetchRecordWithID:secondID completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
[public_db saveRecord:record completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
}];
}];
}];
这些复杂的嵌套行为很容易让你陷入两难：有超过三个（或者更多）的 block 和错误要处理，那么要在哪一层处理哪种错误呢，如果产生了错误，应该在哪一层等待到什么时候重试呢？在这些恼人的嵌套中处理错误和重试，简直就是一场灾难。
幸运的是,苹果给我们提供了NSOperation的子类来管理,使用 NSOperation 的依赖来管理互相依赖的任务.
- 主要有以下几个类,用法基本与NSOperation一致,非常简单
CKFetchRecordsOperation;
CKModifyRecordsOperation;
CKQueryOperation;
CKDatabaseOperation;
CKModifyBadgeOperation;
CKOperation;
CKSubscriptionOptions;
CKModifySubscriptionsOperation;
CKFetchSubscriptionsOperation;
CKFetchRecordsOperation *firstFetchOperateion = [[CKFetchRecordsOperation alloc] init];
firstFetchOperateion.database = public_db;
firstFetchOperateion.recordIDs = @[@"115"];
[firstFetchOperateion setFetchRecordsCompletionBlock:^(NSDictionary<CKRecordID *,CKRecord *> *recordsByRecordID, NSError * operationError) {
if (operationError) {
NSLog(@"处理错误 - 1");
}else{
NSLog(@"success - 1");
}
}];
CKFetchRecordsOperation *secondFetchOperateion = [[CKFetchRecordsOperation alloc] init];
secondFetchOperateion.database = public_db;
secondFetchOperateion.recordIDs = @[@"116"];
[secondFetchOperateion setFetchRecordsCompletionBlock:^(NSDictionary<CKRecordID *,CKRecord *> *recordsByRecordID, NSError * operationError) {
if (operationError) {
NSLog(@"处理错误 - 2");
}else{
NSLog(@"success - 2");
}
}];
CKRecordID *saveRecordID = [[CKRecordID alloc] initWithRecordName:@"save"];
CKRecord *saveRecord = [[CKRecord alloc] initWithRecordType:@"Artwork" recordID:saveRecordID];
CKModifyRecordsOperation *modifyOperation = [[CKModifyRecordsOperation alloc] initWithRecordsToSave:@[saveRecord] recordIDsToDelete:nil];
[modifyOperation setModifyRecordsCompletionBlock:^(NSArray<CKRecord *> *savedRecords , NSArray<CKRecordID *> *deletedRecordIDs, NSError *operationError) {
//....
NSLog(@"3333");
}];
