上篇文章[iCloud]项目内启用iCloud及CloudKit Dashboard介绍简单介绍了怎样在项目中启用iCloud,以及一个web端的预览存储数据的工具.今天我来介绍一下实现数据存储到iCloud的框架: CloudKit.framework.
CloudKit存储数据的结构类似数据库,下面的很多操作你都会有似曾相识的感觉;
首先.我们来看一下,它能存储哪些类型的数据:
- 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)
CK开头的数据类型,是CloudKit.framework的一部分.这里我主要介绍字符串的处理,日期和资源(一种特殊情况),上面的CKReference和CLLocation(特殊类型)暂且不在讨论范围,如果有兴趣,可以参考官网资料学习...
本次讨论,主要是实现数据的增删改查操作,更多功能可参考官方API.
1. 添加数据
CloudKit给应用程序分配部分空间,用于存储数据,首先要获取这个存储空间,这里我们直接获取了默认的存储器(可以自定义存储器):
CKContainer *container = [CKContainer defaultContainer];
然后获取他的数据种类,也就是你要存的数据是隐私数据,还是对外公开的公共数据:
CKDatabase *database = container.publicCloudDatabase;//公共数据
CKDatabase *database = container.privateCloudDatabase;//隐私数据
接着,就要设置要保存的数据,每一个数据库都有一个唯一的字段来标识唯一的一条数据,这里也不例外,就是CKRecordID:
//创建主键id
CKRecordID *noteId = [[CKRecordID alloc]initWithRecordName:@"IDname"];
每一条记录(数据),就是一个CKRecord;
创建一条记录(数据):
//创建CKRecord 保存数据
CKRecord *noteRecord = [[CKRecord alloc]initWithRecordType:@"recordType" recordID:noteId];
这里的recordType可以理解为一个数据模型,这儿传的就是模型的名称;
设置数据,CKRecord的使用和字典非常相似,如下保存一个字符串:
noteRecord setObject:@"value" forKey:@"key"]
关于图片的保存,需要用到CKAsset,他的初始化需要一个URL,所以这里,我先把图片数据保存到本地沙盒,生成一个URL,然后再去创建CKAsset:
NSData *imageData = UIImagePNGRepresentation(image);
if (imageData == nil) {
imageData = UIImageJPEGRepresentation(image, 0.6);
}
NSString *tempPath = [NSHomeDirectory() stringByAppendingPathComponent:@"Documents/imagesTemp"];
NSFileManager *manager = [NSFileManager defaultManager];
if (![manager fileExistsAtPath:tempPath]) {
[manager createDirectoryAtPath:tempPath withIntermediateDirectories:YES attributes:nil error:nil];
}
NSString *filePath = [NSString stringWithFormat:@"%@/%@",tempPath,[self LZCreatRedomString]];
NSURL *url = [NSURL fileURLWithPath:filePath];
[imageData writeToURL:url atomically:YES];
CKAsset *asset = [[CKAsset alloc]initWithFileURL:url];
这样一条数据就准备好了,最后,将他写入iCloud:
[database saveRecord:noteRecord completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
if (!error) {
NSLog(@"保存成功");
}];
这样在CloudKit Dashboard上的Record Types中可以看到新添加的数据模型,在PUBLIC DATA中的Default Zone可以看到这条记录的详细信息;
2. 查询记录(数据)
2.1 查询所有的记录(数据)
查询数据,同样需要获取当前的数据的存储位置:
CKContainer *container = [CKContainer defaultContainer];
CKDatabase *database = container.publicCloudDatabase
执行查询的操作,用到了另一个类: CKQuery
NSPredicate *predicate = [NSPredicate predicateWithValue:YES];
CKQuery *query = [[CKQuery alloc]initWithRecordType:@"recordType" predicate:predicate];
这里的第一个就是你要查询的是那种类型的数据,第二个参数是查询条件,就是一个谓词;
开始查询:
[database performQuery:query inZoneWithID:nil completionHandler:^(NSArray * _Nullable results, NSError * _Nullable error) {
NSLog(@"%@",results);
}];
这里的results就是包含当前数据模型下的所有记录的数组,其成员为CKRecord对象;
2.2. 查询单个记录
单条数据的查询就比较简单了,只需要知道他的CKRecordID就行了:
//创建主键id
CKRecordID *noteId = [[CKRecordID alloc]initWithRecordName:@"IDName"];
//获取容器
CKContainer *container = [CKContainer defaultContainer];
//获取公有数据库
CKDatabase *database = container.publicCloudDatabase
[database fetchRecordWithID:noteId completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
dispatch_async(dispatch_get_main_queue(), ^{
NSLog(@"%@",record);
});
}];
3. 修改记录(数据)
修改一个记录,需要先获取这个记录,然后进行相应的修改,这里假设已经获取到了这条数据,我直接进行修改:
[record setObject:@"改变一下" forKey:@"key"];
[record setObject:@"原模型没有这个字段" forKey:@"newKey"];
需要注意,上面的newKey,原先的数据模型(recordType)里是没有这个字段的,如果修改的时候设置了,相当于新加一个字段,这样也是可以的;
然后,再执行保存操作:
//获取容器
CKContainer *container = [CKContainer defaultContainer];
//获取公有数据库
CKDatabase *database = container.publicCloudDatabase
[database saveRecord:record completionHandler:^(CKRecord * _Nullable record, NSError * _Nullable error) {
NSLog(@"修改成功");
}];
这样原先的记录就被修改了,而且多了一个字段;
4. 删除记录(数据)
同样,删除也是以那个唯一的CKRecordID来进行的,直接给出代码:
CKRecordID *recordID = record.recordID;
CKContainer *container = [CKContainer defaultContainer];
CKDatabase *database = container.publicCloudDatabase;
[database deleteRecordWithID:recordID completionHandler:^(CKRecordID * _Nullable recordID, NSError * _Nullable error) {
NSLog(@"删除成功");
}];
这样就删除成功了;
总结:
- a.这里只是进行了简单的增删改查操作,也是最基本的操作,CloudKit中还有许多其他高级的操作,可以参考其官方文档学习;
- b.上面的增删改查的结果,都是在子线程进行的,如果需要操作UI,请在回调的block内回到主线程进行;
- c.所有操作的变化,都可以在CloudKit Dashboard上查看;
- d.所有的操作都是在开发环境下进行的,如果要应用到项目中,还需要进行很多的配置,包括证书的设置;
- e.笔者也是初步接触这个框架,不足之处还请指教!
参考资料
http://www.devtf.cn/?p=574
官方文档 1
官方文档 2
以及XcodeAPI说明文档.