iOS--AFN实现原理

AFN的六大模块

1,NSURLConnection

主要对NSURLConnection进行了进一步的封装，包含以下核心的类：

AFURLConnectionOperation

AFHTTPRequestOperationManager

AFHTTPRequestOperation

2,NSURLsession

主要对象NSURLSession对象进行了进一步的封装，包含以下核心的类：

AFURLSessionManager

AFHTTPSessionManager

3,Reachability

提供了与网络状态相关的操作接口，包含以下核心的类：

AFNetworkReachabilityManager

4,Security

提供了与安全性相关的操作接口，包含以下核心的类：

AFSecurityPolicy

5,Serialization

提供了与解析数据相关的操作接口，包含以下核心的类：

AFURLRequestSerialization

AFURLResponseSerialization

6,UIKit

提供了大量网络请求过程中与UI界面显示相关的操作接口，通常用于网络请求过程中提示，使用户交互更加友好，包含以下核心的分类/类：

AFNetworkActivityIndicatorManager

UIActivityIndicatorView+AFNetworking

UIAlertView+AFNetworking

UIButton+AFNetworking

UIImageView+AFNetworking

UIKit+AFNetworking

UiprogressView+AFNetworking

UIRefreshControl+AFNetworking

UIWebView+AFNetworking

AFURLSessionManager

创建任务的方法

普通任务

• • - (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(void (^)(NSURLResponse *response, id responSEObject, NSError *error))completionHandler
    /**
     * request：请求对象
     * completionHandler：请求完成调用的Block
     * response：服务器的响应信息
     * responseObject：服务器返回的数据
     * error：错误信息
     */
    
    上传任务(分别上传不同类型的文件)
    // 1. 上传文件类型的数据
    /**
     * fileURL：所要上传文件的路径
     */
    - (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromFile:(NSURL *)fileURL progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
    
    // 2. 上传NSData类型的数据
    - (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request fromData:(NSData *)bodyData progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
    /**
     * bodyData：所要上传的文件数据
     */
    // 3. 上传流数据
    - (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request progress:(NSProgress * __autoreleasing *)progress completionHandler:(void (^)(NSURLResponse *response, id responseObject, NSError *error))completionHandler
    /**
     * request：通过流数据初始化的请求对象
     */
    下载任务
    // 1. 普通下载任务
    - (NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request progress:(NSProgress * __autoreleasing *)progress destination:(NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination completionHandler:(void (^)(NSURLResponse *response, NSURL *filePath, NSError *error))completionHandler
    /**
     * progress：管理下载进度
     * destination：保存数据调用的Block
     * targetPath：数据的保存路径
     */
    // 2. 支持断点下载的下载任务
    - (NSURLSessionDownloadTask *)downloadTaskWithResumeData:(NSData *)resumeData progress:(NSProgress * __autoreleasing *)progress destination:(NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination completionHandler:(void (^)(NSURLResponse *response, NSURL *filePath, NSError *error))completionHandler
    /**
     * progress：管理下载进度
     * resumeData：断点下载时的断点信息
     */
    AFHTTPSessionManager
    常用的属性
    baseURL(NSURL *)，用于监视网络可达性与创建请求对象
    requestSerializer(AFHTTPRequestSerializer *)，指定指定GET、HEAD与DELETE请求参数的解析格式
    responseSerializer(AFHTTPResponseSerializer *)，用于指定服务器返回数据的格式
    常用方法
    初始化
    // 1. 通过工厂方法创建AFHTTPSessionManager对象
    + (instancetype)manager
    // 2. 通过构造方法创建AFHTTPSessionManager对象
    - (instancetype)initWithBaseURL:(NSURL *)url
    /**
     * 根据url初始化AFHTTPSessionManager对象
     */
    - (instancetype)initWithBaseURL:(NSURL *)url sessionConfiguration:(NSURLSessionConfiguration *)configuration
    /**
     * 根据url与configuration初始化AFHTTPSessionManager对象
     */
    请求数据
    // 1. GET请求
    - (NSURLSessionDataTask *)GET:(NSString *)URLString parameters:(id)parameters success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure
    /**
     * URLString：请求路径
     * parameters：请求参数
     * success：请求成功时调用的Block
     * responseObject：服务器返回的数据
     * failure：请求失败时调用的Block
     * error：错误信息
     */
    // 2. POST请求
    - (NSURLSessionDataTask *)POST:(NSString *)URLString parameters:(id)parameters success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure
    /**
     * 参数含义与GET请求相同
     */
    - (NSURLSessionDataTask *)POST:(NSString *)URLString parameters:(id)parameters constructingBodyWithBlock:(void (^)(id <AFMultipartFormData> formData))block success:(void (^)(NSURLSessionDataTask *task, id responseObject))success failure:(void (^)(NSURLSessionDataTask *task, NSError *error))failure
    /**
     * block：用于创建多个数据来源
     */
    使用AFN请求网络数据
    请求数据（xml/JSON）
    创建AFHTTPSessionManager对象
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    指定对服务器的返回数据格式
    //以XML文档的形式返回数据
    manager.responseSerializer = [AFXMLParserResponseSerializer serializer];
    //以JSON形式返回数据
    manager.responseSerializer = [AFJSONResponseSerializer serializer];
    设置请求体(类型为XML或JSON)
    // 请求体通常由服务器指定格式
    NSDictionary *params = @{
                             @"username" : @"账号",
                             @"pwd" : @"密码",
                             @"type" : @"XML/JSON"
                             };
    发送请求
    [manager GET:@"请求路径" parameters:params success:^(NSURLSessionDataTask *task, id responseObject) {
        //responseObject：服务器返回的数据
        NSLog(@"请求成功");
    } failure:^(NSURLSessionDataTask *task, NSError *error) {
        //error：错误信息
        NSLog(@"请求失败");
    }];
    上传数据
    创建AFHTTPSessionManager对象
    AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    创建上传任务
    /**基于NSURLConnection*/
    [manager POST:@"请求路径" parameters:@{@"用户名" : @"密码" constructingBodyWithBlock:^(id<AFMultipartFormData> formData) {
        //设置需要上传的文件
        NSData *data = [NSData dataWithContentsOfFile:@"所要长传文件的路径"];
        [formData appendPartWithFileData:data name:@"file" fileName:@"test.png" mimeType:@"image/png"];
    } success:^(NSURLSessionDataTask *task, id responseObject) {
        //上传成功
    } failure:^(NSURLSessionDataTask *task, NSError *error) {
        //上传失败
    }];
                                       
    /**基于NSURLSession*/
    [manager uploadTaskWithRequest:request fromData:data progress:progress completionHandler:^(NSURLResponse *response, id responseObject, NSError *error) {
        //上传数据成功
    }];
    下载数据
                                       
    创建AFHTTPSessionManager对象
                                       
        AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
    创建下载任务
                                       
    /**基于NSURLSession*/
        [manager downloadTaskWithRequest:request progress:progress destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {
        // 存储下载数据是调用的Block
    } completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {
        //下载完成时调用的Block
    }];