AYPromise
引用
使用CocoaPods可以方便地引入AYPromise。在Podfile中添加AYPromise的依赖。
pod "AYPromise"文档
具体文档。
简介
什么是Promise
Promise，承诺，在开发中的意思是我承诺我去做一些事情，但不一定现在就去做，而是在未来满足一些条件之后才执行。Promise首先出现在前端开发领域，主要用于解决JS开发中的异步问题。在使用Promise之前，处理异步操作最常用的方法是使用回调，例如：
doSomethingAsync(function(result, error){
if (error){
...//处理error
} else {
...//处理result
}
})在Objective-C中，这类代码也非常常见。例如，在著名的AFNetworking中，网络访问就是使用block回调。
[client getPath:@"xxx"
parameters:params
success:^(AFHTTPRequestOperation *operation, id responseObject) {
//处理success
}
failure:^(AFHTTPRequestOperation *operation, NSError *error) {
//处理failure
}]这种书写方式可以很容易地解决对异步操作的处理。但是这样的写法很容易引起回调金字塔的情况。Promise则对异步处理和处理方法都进行了规范和抽象，还给了开发者在异步代码中使用return和throw的能力。这也是Promise存在的真正原因。
使用Promise
来看一个常见的业务场景，获取联系人需要先访问一次服务器(登录或一些必要的操作)，然后再访问一次服务器才能真正获取到有效数据，然后再进行一系列的错误处理，代码冗余复杂。
- (void)getContactSuccess:(void(^)(NSArray *))success failure:(void(^)(NSError *))failure{
[client getPath:@"xxx"
parameters:params
success:^(AFHTTPRequestOperation *operation, id responseObject) {
//处理Json序列化
NSError *error;
NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:responseObject options:kNilOptions error:&error];
if (error) {
failure(error);
return;
}
if ([dic[@"status"] intValue] == 200) {
//需要依赖上一次网络访问的结果，进行下一步访问
[client getPath:@"yyy"
parameters:params
success:^(AFHTTPRequestOperation *operation, id responseObject) {
//处理Json
//处理业务
//组装实体
//....
success(result);
}
failure:^(AFHTTPRequestOperation *operation, NSError *error) {
//处理网络错误
failure(error);
}];
}else{
//处理错误
failure(/*返回错误*/);
}
}
failure:^(AFHTTPRequestOperation *operation, NSError *error) {
//处理网络错误
failure(error);
}];
}使用Promise改造一下
//网络访问与业务分离
- (AYPromise *)get:(NSString *)getPath withParam:(id)param{
return AYPromiseWithResolve(^(AYResolve resolve){
[client getPath:@"xxx"
parameters:param
success:^(AFHTTPRequestOperation *operation, id responseObject) {
resolve(responseObject);
} failure:^(AFHTTPRequestOperation *operation, NSError *error) {
resolve(error);
}];
});
}
//Json序列化与业务分离
- (AYPromise *)parseJson:(id)responseObject{
return AYPromiseWith(^id{
NSError *error;
NSDictionary *json = [NSJSONSerialization JSONObjectWithData:responseObject options:kNilOptions error:&error];
if (error) {
return error;
}else{
return json;
}
});
}
- (AYPromise *)getContacts{
return AYPromiseWith(^{
//第一次访问网络
return [self get:@"xxx" withParam:params];
}).then(^(id responseObject){
//处理Json序列化
return [self parseJson:responseObject];
}).then(^(NSDictionary *json){
//第二次访问网络
return [self get:@"yyy" withParam:params];
}).then(^(id responseObject){
//再次处理Json序列化
return [self parseJson:responseObject];
}).then(^(NSDictionary* result){
//处理业务正确性
if ([result[@"status"] intValue] == 200){
return result;
}else{
return error;/*构建一个NSError对象返回*/
}
}).then(^(NSDictionary* result){
//组装实体
});
}可以看到，通过Promise的改造，原本层层嵌套代码，变得有序、清晰起来。什么？你问哪里处理错误？放心，通过Promise，可以进行统一的错误处理。
开源许可证
AYPromise 遵循MIT许可证。更多信息请查看LICENSE文件。