AFNetworking 在去年年底升级到了 3.0。这个版本更新想必有很多好处,然而让我吃惊的是,它并没有 batch request 接口。之前的 1.x 版本、2.x 版本都实现了这个很常见的需求,不知道作者为何选择在 3.x 中去掉它。
在 AFNetworking 2 中,我们只需一行代码就能解决批量上传的问题:
1 2 3 4 5 |
[AFURLConnectionOperation batchOfRequestOperations:operations progressBlock:^(NSUInteger numberOfFinishedOperations, NSUInteger totalNumberOfOperations) { NSLog(@"%lu 上传完成,共 %lu", (long)numberOfFinishedOperations, (long)totalNumberOfOperations); } completionBlock:^(NSArray *operations) { NSLog(@"上传完毕"); }]; |
但 AFNetworking 3 用的是NSURLSession
,而不是用NSOperation
来包装NSURLConnection
,所以把整个AFURLConnectionOperation
类都干掉了。上面的方法不能再用,并且也没有给出替代品。因此,我们只能自己动手了。
实现这个功能,有几个要点:
- 异步上传。批量请求里的每个请求都应该在不同线程,可以同时上传。
- 在所有请求都完成之后,再通知回调。
- 尽管异步请求的返回先后顺序没有一定,很可能后发出的请求先返回;但是最后回调的时候,请求返回的结果必须要按请求发出的顺序排列。比如,一个很常见的处理是,上传图片的接口返回该图片的 url;那么回调结果里的 url 顺序显然需要跟上传的图片顺序一一对应上。
- 最好传完每张图片也能有一个回调,方便我们告诉用户上传的进度。
同时满足以上要点,主要有3种思路:GCD、NSOperation 以及 promise。这个需求也是示例多线程用法的一个很好的例子,所以我写了这篇比较详细的文章供大家参考。
下面的代码以图片上传为例。测试数据配置了 3 张图片,其中第 2 张图片尺寸最小,往往先上传完毕,用来测试请求发出顺序与返回顺序不一致的情况。
方法一:GCD dispatch group
我们知道,GCD dispatch 是多线程处理最简单的方法。全部请求完成后再通知回调的需求,很适合利用 dispatch group 来完成。至于保证返回结果的顺序,我们只好自己来做了。
首先需要一个方法,对于每张图片生成一个上传请求。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
- (NSURLSessionUploadTask*)uploadTaskWithImage:(UIImage*)image completion:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionBlock { // 构造 NSURLRequest NSError* error = NULL; NSMutableURLRequest *request = [[AFHTTPRequestSerializer serializer] multipartFormRequestWithMethod:@"POST" URLString:[self uploadUrl] parameters:nil constructingBodyWithBlock:^(id<AFMultipartFormData> formData) { NSData* imageData = UIImageJPEGRepresentation(image, 1.0); [formData appendPartWithFileData:imageData name:@"file" fileName:@"someFileName" mimeType:@"multipart/form-data"]; } error:&error]; // 可在此处配置验证信息 // 将 NSURLRequest 与 completionBlock 包装为 NSURLSessionUploadTask AFURLSessionManager *manager = [[AFURLSessionManager alloc] initWithSessionConfiguration:[NSURLSessionConfiguration defaultSessionConfiguration]]; NSURLSessionUploadTask *uploadTask = [manager uploadTaskWithStreamedRequest:request progress:^(NSProgress * _Nonnull uploadProgress) { } completionHandler:completionBlock]; return uploadTask; } |
在这个方法里,我们首先用UIImageJPEGRepresentation
把UIImage
变为NSData
。然后用AFHTTPRequestSerializer
来生成NSMutableURLRequest
,[self uploadUrl]
是上传接口的地址。为安全考虑,一般上传的接口都有身份验证的需求,比如在请求 header 中加入 auth 信息,可以在此配置NSMutableURLRequest
的 header。最后,我们用 AFURLSessionManager
把 NSURLRequest
和回调 block 包装成一个NSURLSessionUploadTask
。
有了生成请求的方法,批量发出请求的方法如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
- (IBAction)runDispatchTest:(id)sender { // 需要上传的数据 NSArray* images = [self images]; // 准备保存结果的数组,元素个数与上传的图片个数相同,先用 NSNull 占位 NSMutableArray* result = [NSMutableArray array]; for (UIImage* image in images) { [result addObject:[NSNull null]]; } dispatch_group_t group = dispatch_group_create(); for (NSInteger i = 0; i < images.count; i++) { dispatch_group_enter(group); NSURLSessionUploadTask* uploadTask = [self uploadTaskWi 题:
但 AFNetworking 3 用的是 实现这个功能,有几个要点:
同时满足以上要点,主要有3种思路:GCD、NSOperation 以及 promise。这个需求也是示例多线程用法的一个很好的例子,所以我写了这篇比较详细的文章供大家参考。 下面的代码以图片上传为例。测试数据配置了 3 张图片,其中第 2 张图片尺寸最小,往往先上传完毕,用来测试请求发出顺序与返回顺序不一致的情况。 方法一:GCD dispatch group我们知道,GCD dispatch 是多线程处理最简单的方法。全部请求完成后再通知回调的需求,很适合利用 dispatch group 来完成。至于保证返回结果的顺序,我们只好自己来做了。 首先需要一个方法,对于每张图片生成一个上传请求。
在这个方法里,我们首先用 有了生成请求的方法,批量发出请求的方法如下:
|