【ios】使用Block对POST异步操作的简单封装

以下内容为原创，欢迎转载，转载请注明

来自天天博客：http://www.cnblogs.com/tiantianbyconan/p/3409721.html

一般情况下的POST异步操作需要实现以下几步：

1. 在controller.h上实现<NSURLConnectionDataDelegate>协议

2. 实现协议的几个方法，

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data

- (void)connectionDidFinishLoading:(NSURLConnection *)connection

3. 编写执行post请求的代码：

NSURL *url = [NSURL URLWithString:urlStr]; // 生成NSURL对象
    // 生成Request请求对象（并设置它的缓存协议、网络请求超时配置）
    NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30];
    
    [request setHTTPBody:[params dataUsingEncoding:NSUTF8StringEncoding]]; // 设置请求参数
    
    // 执行请求连接
    NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:executorDelegate];

如果controller有很多异步操作，处理就会很麻烦，而且，很多时候我们只需要处理完成和异常（比如超时）的时候的反馈即可

所以，我需要编写一个post请求的封装类，只要传入请求的url、请求参数（字符串形式）、完成时的回调block

首先，新建类：HttpPostExecutor，.h如下：

//
//  HttpPostExecutor.h
//  HttpTest
//
//  Created by WANGJIE on 13-11-6.
//  Copyright (c) 2013年 WANGJIE. All rights reserved.
//

#import <Foundation/Foundation.h>

@interface HttpPostExecutor : NSObject<NSURLConnectionDataDelegate>
{
    NSMutableData *resultData; // 存放请求结果
    void (^finishCallbackBlock)(NSString *); // 执行完成后回调的block
    
}
@property NSMutableData *resultData;
@property(strong) void (^finishCallbackBlock)(NSString *);

+ (void)postExecuteWithUrlStr:(NSString *)urlStr Paramters:(NSString *)params FinishCallbackBlock:(void (^)(NSString *))block;

@end

实现了<NSURLConnectionDataDelegate>协议，因为它要接收post请求的几个回调。

有一个NSMutableData对象，这个对象用于储存请求的结果。

一个finishCallbackBlock的block，这个block用于执行完成后的回调，这个block传入的参数就是返回的结果（这个结果已转成utf-8编码的字符串形式），我们可以在这个block中去处理请求完成后的逻辑

还有一个类方法，这个类方法暴露给外面，让外面进行调用

接下来，我们看下实现的方法.m文件：

//
//  POST异步请求的封装
//  使用方法，只需传入url，参数组成的字符串，执行完成后的回调block
//  如下：
//  [HttpPostExecutor postExecuteWithUrlStr:@"http://www.baidu.com"
//                              Paramters:@""
//                    FinishCallbackBlock:^(NSString *result){  // 设置执行完成的回调block
//                        NSLog(@"finish callback block, result: %@", result);
//                    }];
//  post提交的参数，格式如下：
//  参数1名字=参数1数据&参数2名字＝参数2数据&参数3名字＝参数3数据&...
//
//
//  HttpPostExecutor.m
//  HttpTest
//
//  Created by WANGJIE on 13-11-6.
//  Copyright (c) 2013年 WANGJIE. All rights reserved.
//

#import "HttpPostExecutor.h"

@implementation HttpPostExecutor
@synthesize resultData, finishCallbackBlock;

/**
 * 执行POST请求
 */
+ (void)postExecuteWithUrlStr:(NSString *)urlStr Paramters:(NSString *)params FinishCallbackBlock:(void (^)(NSString *))block
{
    // 生成一个post请求回调委托对象（实现了<NSURLConnectionDataDelegate>协议）
    HttpPostExecutor *executorDelegate = [[HttpPostExecutor alloc] init];
    executorDelegate.finishCallbackBlock = block; // 绑定执行完成时的block

    
    NSURL *url = [NSURL URLWithString:urlStr]; // 生成NSURL对象
    // 生成Request请求对象（并设置它的缓存协议、网络请求超时配置）
    NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:url cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:30];
    
    [request setHTTPBody:[params dataUsingEncoding:NSUTF8StringEncoding]]; // 设置请求参数
    
    // 执行请求连接
    NSURLConnection *conn = [[NSURLConnection alloc] initWithRequest:request delegate:executorDelegate];
    
    NSLog(conn ? @"连接创建成功" : @"连接创建失败");
    
}


/**
 * 接收到服务器回应的时回调
 */
- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response
{
    NSHTTPURLResponse *resp = (NSHTTPURLResponse *)response;
    // 初始化NSMutableData对象（用于保存执行结果）
    if(!resultData){
        resultData = [[NSMutableData alloc] init];
    }else{
        [resultData setLength:0];
    }
    
    if ([response respondsToSelector:@selector(allHeaderFields)]) {
        
        NSDictionary *dictionary = [resp allHeaderFields];
        
        NSLog(@"[network]allHeaderFields:%@",[dictionary description]);
    }
    
}
/**
 * 接收到服务器传输数据的时候调用，此方法根据数据大小执行若干次
 */
- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data
{
    [resultData appendData:data]; // 追加结果
}
/**
 * 数据传完之后调用此方法
 */
- (void)connectionDidFinishLoading:(NSURLConnection *)connection
{
    // 把请求结果以UTF-8编码转换成字符串
    NSString *resultStr = [[NSString alloc] initWithData:[self resultData] encoding:NSUTF8StringEncoding];
    
    if (finishCallbackBlock) { // 如果设置了回调的block，直接调用
        finishCallbackBlock(resultStr);
    }

    
}
/**
 * 网络请求过程中，出现任何错误（断网，连接超时等）会进入此方法
 */
- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error
{
    NSLog(@"network error: %@", [error localizedDescription]);
    
    if (finishCallbackBlock) { // 如果设置了回调的block，直接调用
        finishCallbackBlock(nil);
    }
    
    
}
@end

在这个实现类中，我们在类方法中，先生成一个HttpPostExecutor对象，这个对象用于post请求的回调（因为实现了<NSURLConnectionDataDelegate>协议），然后去执行post连接。

接下来就等下面实现的回调方法被自动调用了，一旦调用

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response

这个方法，就对resultData（用于存储post请求结果）进行初始化或者清空，因为要开始真正存储数据了嘛；

 

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data

这个方法进行回调的时候，把返回过来的这部分数据存储到resultData中，没什么好说的；

 

一旦回调- (void)connectionDidFinishLoading:(NSURLConnection *)connection这个方法，说明数据传输完毕了，要做的逻辑就是把数据转成utf-8编码的字符串，然后回调我们设置的回调finishCallbackBlock，把转好的结果字符串传进去，这样我们在回调block方法中实现的逻辑就能正常执行了。

 

一旦回调- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error这个方法，说明请求过程中出错了，比如断电、超时等，这时候，也回调我们设置的回调finishCallbackBlock，nil作为结果，这样我们在finishCallbackBlock中就能判断是正常的执行了post还是出了问题。

好了，接下来，我们就可以在外面去调用了，如下：

[HttpPostExecutor postExecuteWithUrlStr:@"http://www.baidu.com"
                                  Paramters:@""
                        FinishCallbackBlock:^(NSString *result){
                            // 执行post请求完成后的逻辑
                            NSLog(@"finish callback block, result: %@", result);
                        }];

这样，以后post请求只需要去调用上面这个方法，在回调block中去处理结果

之后，在我们的代码编写中，就可以只关心业务逻辑，不需要去在意请求协议和回调了

测试demo下载