AFN的简单使用

AFNetworking是一个令人愉快的iOS和Mac OS X的网络库。它建立在基础URL加载系统之上，扩展了Cocoa中内置的强大的高级网络抽象。它有一个模块化架构，设计良好，功能丰富的API，使用起来很方便。

AFN的简介
- 简介
- 请求数据格式
- 响应数据格式
- 数据格式小结
AFN模拟登陆
- 发送GET请求获取普通的Json数据
- AFN发送GET请求模拟登陆
- AFN发送POST请求模拟登陆
AFN常见错误
AFN实现文件上传和下载
- 文件上传
- 文件下载
AFN常用功能
- AFN之BaseURL
- AFN之HTTPS
- AFN之监测网络环境
封装简单的网络请求工具类

AFN的简介

简介

目前国内开发网络应用使用最多的第三方框架
是专为Mac OS和iOS设计的一套网络框架
对NSURLConnection和NSURLSession做了封装
提供有丰富的API
提供了完善的错误解决方案
使用起来相对来说比较简单
官网地址：AFNetworking

请求数据格式

AFURLRequestSerialization

| 类型 | 说明 |
| --- | :---: | ---:|
| AFHTTPRequestSerializer | 二进制的，默认的 |
| AFJSONRequestSerializer | JSON(POST JSON) RESTful 设计风格需要 |
| AFPropertyListRequestSerializer | PList(POST Plist－开发中几乎不用) |

响应数据格式

AFURLResponseSerialization

| 类型 | 说明 |
| --- | :---: | ---:|
| AFHTTPResponseSerializer | HTTP二进制的 |
| AFJSONResponseSerializer | JSON默认的 |
| AFXMLParserResponseSerializer | XML Parser解析器 SAX解析 |
| AFXMLDocumentResponseSerializer | (Mac OS X) XML DOM |
| AFPropertyListResponseSerializer | PList几乎不用 |
| AFImageResponseSerializer | 图像，不支持GIF |
| AFCompoundResponseSerializer | 组合的 |

数据格式小结

大多数情况下，都是JSON格式，不需要指定
如果是XML格式
- 如果SAX解析，需要指定格式
  - manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
- 然后利用代理方法解析
- 如果DOM解析，需要指定格式
  - manager.responseSerializer = [AFHTTPResponseSerializer serializer];
- 然后利用第三方框架解析
图像
- AFN支持图像缓存
- 但是不支持GIF
提示
- 使用AFN时，一定记住要输出：error

AFN模拟登陆

导入头文件：#import "AFNetworking.h

发送GET请求获取普通的JSON数据

- (IBAction)demo:(id)sender
{
    // 1.网络请求地址
    NSString *URLString = @"http://xxxx/demo.json";

    // 2.创建网络请求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 3.发送网络请求
    [manager GET:URLString parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@ %@",[responseObject class],responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN发送GET请求模拟登陆

- (IBAction)GETLogin:(id)sender {

    // NSString *URLString = @"http://xxxx/php/login/login.php?username=zhangsan&password=zhang";

    // 登陆地址
    NSString *URLString = @"http://xxxx/php/login/login.php";

    // 网络请求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 请求参数
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
    parameters[@"username"] = @"zhangsan";
    parameters[@"password"] = @"zhang";

    // 发送GET请求
    [manager GET:URLString parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN发送POST请求模拟登陆

- (IBAction)POSTLogin:(id)sender {

    // 登陆地址
    NSString *URLString = @"http://xxxx/php/login/login.php";

    // 网络请求管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 请求参数
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
    parameters[@"username"] = @"zhangsan";
    parameters[@"password"] = @"zhang";

    // 发送POST请求
    [manager POST:URLString parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN常见错误

AFN常见的序列化和反序列化的错误

 1.常见错误一 :
    AFN支持接收 @"application/json", @"text/json", @"text/javascript" 文本类型
    AFN不支持接收 text/html 文本类型

 2.常见错误二 :
    AFN默认的成功的回调 responseObject 是把服务器返回的数据当做JSON数据格式解析,返回字典或者数组.
    但是在加载网页数据时,响应体是字符串.需要修改响应的序列化方式,让AFN给我们返回原始的二进制数据即可.

 3.常见错误三 :
    AFN不支持接收 text/plian 文本类型

 4.常见错误四 :
    AFN默认只支持向服务器发送普通的二进制数据.比如普通的GET和POST请求数据.默认不支持发送JSON数据到服务器
    如果要向服务器发送JSON格式的二进制数据,就需要特殊的处理请求的方式.使AFN支持向服务器发送JSON形式的二进制数据

其他常见错误

加载网页数据时

- (void)loadData
{
    // 网络请求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 常见错误一 : 修改AFN支持接收的文本类型 : text/html
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", nil];

    // 常见错误二 : 修改AFN默认的返回的数据类型,设置默认为只返回原始的二进制数据,程序猿自己解析
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 网络请求地址
    NSString *URLStr = @"http://www.baidu.com";

    // 发送网络请求
    [manager GET:URLStr parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

//        NSLog(@"%@ %@",[responseObject class],responseObject);

        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出错 %@",error);
    }];
}

向服务器发送JSON数据时

- (void)postJSON
{
    // 网络请求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 常见错误三 : 修改AFN支持接收的文本类型 : text/plian
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", @"text/plain", nil];

    // 常见错误二 : 修改AFN默认的返回的数据类型,设置默认为只返回原始的二进制数据,程序猿自己解析
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 常见错误四 : 修改AFN支持向服务器发送JSON形式的二进制数据
    manager.requestSerializer = [AFJSONRequestSerializer serializer];

    // 网络请求地址
    NSString *URLStr = @"http://localhost/php/upload/postjson.php";

    // 请求参数
    NSDictionary *parameters = @{
                                    @"name":@"zhangsan"
                                };

    // 发送网络请求
    [manager POST:URLStr parameters:parameters progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

//        NSLog(@"%@ %@",[responseObject class],responseObject);

        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出错 %@",error);
    }];
}

AFN实现文件上传和下载

文件上传

文件数据拼接的方法
- [formData appendPartWithFileData:data name:@"" fileName:@"" mimeType:@""];
文件数据拼接的四个参数
- 参数1：上传文件的二进制信息
- 参数2：服务器接收二进制数据的字段名（跟服务器要）
- 参数3：文件保存到服务器的名字
- 参数4：上传的文件的类型
文件上传的主方法

- (void)uploadFile
{
    // 网络请求地址
    NSString *URLStr = @"http://xxxx/php/upload/upload-m.php";

    // 文件上传的附带信息
    NSDictionary *textDict = @{
                                @"status":@"zhangsan"
                               };

    // 网络请求manager
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    // 发送POST请求
    [manager POST:URLStr parameters:textDict constructingBodyWithBlock:^(id<AFMultipartFormData>  _Nonnull formData) {

        // 获取文件路径1
        NSString *filePath1 = [[NSBundle mainBundle] pathForResource:@"mm01.jpg" ofType:nil];
        NSData *fileData1 = [NSData dataWithContentsOfFile:filePath1];
        // 拼接数据1
        [formData appendPartWithFileData:fileData1 name:@"userfile[]" fileName:[filePath1 lastPathComponent] mimeType:@"image/jpg"];

        // 获取文件路径2
        NSString *filePath2 = [[NSBundle mainBundle] pathForResource:@"mm02.jpg" ofType:nil];
        NSData *fileData2 = [NSData dataWithContentsOfFile:filePath2];
        // 拼接数据2
        [formData appendPartWithFileData:fileData2 name:@"userfile[]" fileName:[filePath2 lastPathComponent] mimeType:@"image/jpg"];

    } progress:^(NSProgress * _Nonnull uploadProgress) {

        NSLog(@"进度 %f",uploadProgress.fractionCompleted);

    } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@ %@",[responseObject class],responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出错 %@",error);
    }];
}

文件下载

- (void)downloadFile
{
    // 下载地址
    NSString *URLString = @"http://xxxx/xcode.zip";
    // 请求
    NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:URLString]];
    // 管理者
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    // 发起下载任务
    NSURLSessionDownloadTask *downloadTask = [manager downloadTaskWithRequest:request progress:^(NSProgress * _Nonnull downloadProgress) {

        NSLog(@"进度 %f",downloadProgress.fractionCompleted);

    } destination:^NSURL * _Nonnull(NSURL * _Nonnull targetPath, NSURLResponse * _Nonnull response) {

        // AFN提供的文件保存路径,在tmp文件中,下载完成之后就会被删除
        NSLog(@"%@",targetPath);

        // 自己获取文件保存的路径
        NSString *filePath = [[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:response.suggestedFilename];

        // 带file:// 协议头
        NSURL *locationURL = [NSURL fileURLWithPath:filePath];

        // 把文件缓存路径剪切出去
        return locationURL;

    } completionHandler:^(NSURLResponse * _Nonnull response, NSURL * _Nullable filePath, NSError * _Nullable error) {
        // 文件最终保存的路径 : 从上面自动剪切过来的
        NSLog(@"%@",filePath.path);
    }];
    // 开启下载任务
    [downloadTask resume];
}

AFN其他常用功能

AFN之BaseURL

使用场景：设计网络请求工具类时使用

- (IBAction)baseURL:(id)sender
{
    AFHTTPSessionManager *manager = [[AFHTTPSessionManager alloc] initWithBaseURL:[NSURL URLWithString:@"http://localhost/"]];

    [manager GET:@"demo.json" parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        NSLog(@"%@",responseObject);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"%@",error);
    }];
}

AFN之HTTPS

// 允许无效的证书 : 2.5.4 版本之前使用
manager.securityPolicy.allowInvalidCertificates = YES;
// 不验证域名 : 2.6.0 版本之后使用
manager.securityPolicy.validatesDomainName = NO;

- (IBAction)HTTPS:(id)sender
{
    // 创建网络请求mansger
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];

    // 允许无效的证书
    // manager.securityPolicy.allowInvalidCertificates = YES;
    // 不验证域名
    manager.securityPolicy.validatesDomainName = NO;

    // 修改AFN默认支持接收的文本类型
    manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html" ,nil];

    // 修改AFN默认处理数据的方式 : 设置成只返回原始的二进制数据,程序猿自己反序列化
    manager.responseSerializer = [AFHTTPResponseSerializer serializer];

    // 网络请求地址
    NSString *URLStr = @"https://www.baidu.com";

    [manager GET:URLStr parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

        // NSLog(@"%@ %@",[responseObject class],responseObject);

        // 反序列化
        NSString *html = [[NSString alloc] initWithData:responseObject encoding:NSUTF8StringEncoding];
        NSLog(@"%@",html);

    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        NSLog(@"出错 %@",error);
    }];
}

AFN之监测网络环境

程序一启动就开始监测网络环境

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    // 监测网络环境
    AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];

    /*
     status
     AFNetworkReachabilityStatusUnknown          = -1, 不知道监测的是什么
     AFNetworkReachabilityStatusNotReachable     = 0,  没有检测到网络
     AFNetworkReachabilityStatusReachableViaWWAN = 1,  蜂窝网
     AFNetworkReachabilityStatusReachableViaWiFi = 2,  WIFI
     */
    [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
        NSLog(@"%zd",status);
    }];

    [manager startMonitoring];

    return YES;
}

封装简单的网络请求工具类

新建类 `NetworkTool`

NetworkTool.h

// 第一步 : 继承自 AFHTTPSessionManager
@interface NetworkTool : AFHTTPSessionManager

/**
 *  网络请求工具类全局访问点
 *
 *  @return AFHTTPSessionManager的实例
 */
+ (instancetype)sharedNetworkTool;

/**
 *  网络请求工具类GET请求的主方法
 *
 *  @param URLString 请求地址
 *  @param success   成功的回调
 *  @param faile     失败的回调
 */
- (void)GETWithURLString:(NSString *)URLString success:(void(^)(id responseObject))success faile:(void(^)(NSError *error))faile;

NetworkTool.m

+ (instancetype)sharedNetworkTool
{
    static NetworkTool *instance;
    
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        
        // 设置相对路径
        NSURL *BaseURL = [NSURL URLWithString:@"http://c.m.163.com/nc/"];
        // 实例化Manager
        instance = [[self alloc] initWithBaseURL:BaseURL];
        
        // 增加AFN支持的文件类型
        instance.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/html", @"text/plain", nil];
    });
    
    return instance;
}

// 网络工具类实现GET请求的主方法
- (void)GETWithURLString:(NSString *)URLString success:(void (^)(id))success faile:(void (^)(NSError *))faile
{
    [self GET:URLString parameters:nil progress:nil success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
        
        if (success) {
            success(responseObject);
        }
        
    } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
        if (faile) {
            faile(error);
        }
    }];
}

感谢读到最后的朋友，最后祝大家工作顺利，请点赞支持一下，谢谢！

最后编辑于：2017.12.06 02:24:20

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 157,298评论 4赞 360
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 66,701评论 1赞 290
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 107,078评论 0赞 237
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 43,687评论 0赞 202
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 52,018评论 3赞 286
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 40,410评论 1赞 211
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 31,729评论 2赞 310
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 30,412评论 0赞 194
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 34,124评论 1赞 239
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 30,379评论 2赞 242
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 31,903评论 1赞 257
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 28,268评论 2赞 251
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 32,894评论 3赞 233
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 26,014评论 0赞 8
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 26,770评论 0赞 192
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 35,435评论 2赞 269
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 35,312评论 2赞 260