AFNetworking 2.5.x 网络请求的封装

源码地址

https://github.com/YouXianMing/Networking

说明

1. 将block形式的请求转换成用代理来处理

2. 你可以通过继承父类，改写父类的某些方法来达到转换请求字典（加密或者其他事宜等），转换获取结果的目的（加密或者其他事宜等）

3. 支持下载进度

常规请求源码

//
//  Networking.h
//  NetworkingCraft
//
//  Created by YouXianMing on 15/6/11.
//  Copyright (c) 2015年 YouXianMing. All rights reserved.
//

#import <Foundation/Foundation.h>
@class Networking;

typedef enum : NSUInteger {

GET_METHOD,                  // GET请求
POST_METHOD,                 // POST请求

} AFNetworkingRequestMethod;

typedef enum : NSUInteger {

HTTPRequestType = 0x11,      // 二进制格式 (不设置的话为默认格式)
JSONRequestType,             // JSON方式
PlistRequestType,            // 集合文件方式

} AFNetworkingRequestType;

typedef enum : NSUInteger {

HTTPResponseType = 0x22,     // 二进制格式 (不设置的话为默认格式)
JSONResponseType,            // JSON方式
PlistResponseType,           // 集合文件方式
ImageResponseType,           // 图片方式
CompoundResponseType,        // 组合方式

} AFNetworkingResponseType;

@protocol NetworkingDelegate <NSObject>
@optional
/**
*  请求成功
*
*  @param networking Networking实例对象
*  @param data       数据
*/
- (void)requestSucess:(Networking *)networking data:(id)data;

/**
*  请求失败
*
*  @param networking Networking实例对象
*  @param error      错误信息
*/
- (void)requestFailed:(Networking *)networking error:(NSError *)error;

/**
*  用户取消请求
*
*  @param networking Networking实例对象
*  @param error      错误信息
*/
- (void)userCanceledFailed:(Networking *)networking error:(NSError *)error;

@end

@interface Networking : NSObject

/**
*  代理
*/
@property (nonatomic, weak)  id <NetworkingDelegate>  delegate;

/**
*  标识符
*/
@property (nonatomic, strong) NSString               *flag;

/**
*  超时时间间隔(设置了才能生效,不设置,使用的是AFNetworking自身的超时时间间隔)
*/
@property (nonatomic, strong) NSNumber               *timeoutInterval;

/**
*  请求的类型
*/
@property (nonatomic) AFNetworkingRequestType         requestType;

/**
*  回复的类型
*/
@property (nonatomic) AFNetworkingResponseType        responseType;

/**
*  请求的方法类型
*/
@property (nonatomic) AFNetworkingRequestMethod       RequestMethod;

/**
*  网络请求地址
*/
@property (nonatomic, strong) NSString               *urlString;

/**
*  作为请求用字典
*/
@property (nonatomic, strong) NSDictionary           *requestDictionary;

/**
*
*  -====== 此方法由继承的子类来重载实现 ======-
*
*  转换请求字典
*
*  @return 转换后的字典
*/
- (NSDictionary *)transformRequestDictionary;

/**
*
*  -====== 此方法由继承的子类来重载实现 ======-
*
*  对返回的结果进行转换
*
*  @return 转换后的结果
*/
- (id)transformRequestData:(id)data;

/**
*  开始请求
*/
- (void)startRequest;

/**
*  取消请求
*/
- (void)cancelRequest;

#pragma mark - 便利构造器方法

/**
*  便利构造器方法
*
*  @param urlString         请求地址
*  @param requestDictionary 请求参数
*  @param delegate          代理
*  @param timeoutInterval   超时时间
*  @param flag              标签
*  @param requestMethod     请求方法
*  @param requestType       请求类型
*  @param responseType      回复数据类型
*
*  @return 实例对象
*/
+ (instancetype)networkingWithUrlString:(NSString *)urlString
requestDictionary:(NSDictionary *)requestDictionary
delegate:(id)delegate
timeoutInterval:(NSNumber *)timeoutInterval
flag:(NSString *)flag
requestMethod:(AFNetworkingRequestMethod)requestMethod
requestType:(AFNetworkingRequestType)requestType
responseType:(AFNetworkingResponseType)responseType;

@end

//
//  Networking.m
//  NetworkingCraft
//
//  Created by YouXianMing on 15/6/11.
//  Copyright (c) 2015年 YouXianMing. All rights reserved.
//

#import "Networking.h"
#import "AFNetworking.h"

typedef enum : NSUInteger {

DEALLOC_CANCEL,  // dealloc取消
USER_CANCEL,     // 用户取消

} ECancelType;

@interface Networking ()

#pragma mark - Private Instance
@property (nonatomic, strong) AFHTTPRequestOperationManager *manager;
@property (nonatomic, strong) AFHTTPRequestOperation        *httpOperation;
@property (nonatomic)         ECancelType                    cancelType;

#pragma mark - Private Method

/**
*  默认设置
*/
- (void)defaultConfig;

/**
*  根据序列化枚举值返回对应的请求策略
*
*  @param serializerType 序列化枚举值
*
*  @return 序列化策略
*/
+ (AFHTTPRequestSerializer *)requestSerializerWith:(AFNetworkingRequestType)serializerType;

/**
*  根据序列化枚举值返回对应的回复策略
*
*  @param serializerType 序列化枚举值
*
*  @return 序列化策略
*/
+ (AFHTTPResponseSerializer *)responseSerializerWith:(AFNetworkingResponseType)serializerType;

@end

@implementation Networking

/**
*  初始化方法
*
*  @return 实例对象
*/
- (instancetype)init {
self = [super init];
if (self) {

// 默认设置
[self defaultConfig];
}
return self;
}

- (void)defaultConfig {

self.manager = [AFHTTPRequestOperationManager manager];

// 设置回复内容信息
self.manager.responseSerializer.acceptableContentTypes = \
[self.manager.responseSerializer.acceptableContentTypes setByAddingObject:@"text/html"];

}

- (void)startRequest {

if (self.urlString.length <= 0) {
return;
}

// 设置请求类型
if (self.requestType) {
self.manager.requestSerializer  = [Networking requestSerializerWith:self.requestType];
} else {
self.manager.requestSerializer  = [Networking requestSerializerWith:HTTPRequestType];
}

// 设置回复类型
if (self.responseType) {
self.manager.responseSerializer = [Networking responseSerializerWith:self.responseType];
} else {
self.manager.responseSerializer = [Networking responseSerializerWith:HTTPResponseType];
}

// 设置超时时间
if (self.timeoutInterval && self.timeoutInterval.floatValue > 0) {
[self.manager.requestSerializer willChangeValueForKey:@"timeoutInterval"];
self.manager.requestSerializer.timeoutInterval = self.timeoutInterval.floatValue;
[self.manager.requestSerializer didChangeValueForKey:@"timeoutInterval"];
}

// 开始执行请求
if (self.RequestMethod == GET_METHOD) {

__weak Networking *weakSelf = self;
self.httpOperation = [self.manager GET:self.urlString
parameters:[weakSelf transformRequestDictionary]
success:^(AFHTTPRequestOperation *operation, id responseObject) {

if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(requestSucess:data:)]) {
[weakSelf.delegate requestSucess:weakSelf data:[weakSelf transformRequestData:responseObject]];
}

}
failure:^(AFHTTPRequestOperation *operation, NSError *error) {

if (self.cancelType == USER_CANCEL) {
if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(userCanceledFailed:error:)]) {
[weakSelf.delegate userCanceledFailed:weakSelf error:error];
weakSelf.cancelType = DEALLOC_CANCEL;
}
} else {
if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(requestFailed:error:)]) {
[weakSelf.delegate requestFailed:weakSelf error:error];
}
}

}];

} else if (self.RequestMethod == POST_METHOD) {

__weak Networking *weakSelf = self;
self.httpOperation = [self.manager POST:self.urlString
parameters:[weakSelf transformRequestDictionary]
success:^(AFHTTPRequestOperation *operation, id responseObject) {

if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(requestSucess:data:)]) {
[weakSelf.delegate requestSucess:weakSelf data:[weakSelf transformRequestData:responseObject]];
}

}
failure:^(AFHTTPRequestOperation *operation, NSError *error) {

if (self.cancelType == USER_CANCEL) {
if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(userCanceledFailed:error:)]) {
[weakSelf.delegate userCanceledFailed:weakSelf error:error];
weakSelf.cancelType = DEALLOC_CANCEL;
}
} else {
if (weakSelf.delegate && [weakSelf.delegate respondsToSelector:@selector(requestFailed:error:)]) {
[weakSelf.delegate requestFailed:weakSelf error:error];
}
}

}];

} else {

}
}

- (void)cancelRequest {
self.cancelType = USER_CANCEL;
[self.httpOperation cancel];
}

- (void)dealloc {
self.cancelType = DEALLOC_CANCEL;
[self.httpOperation cancel];
}

+ (AFHTTPRequestSerializer *)requestSerializerWith:(AFNetworkingRequestType)serializerType {
if (serializerType == JSONRequestType) {
return [AFJSONRequestSerializer serializer];
} else if (serializerType == HTTPRequestType) {
return [AFHTTPRequestSerializer serializer];
} else if (serializerType == PlistRequestType) {
return [AFPropertyListRequestSerializer serializer];
} else {
return nil;
}
}

+ (AFHTTPResponseSerializer *)responseSerializerWith:(AFNetworkingResponseType)serializerType {
if (serializerType == JSONResponseType) {
return [AFJSONResponseSerializer serializer];
} else if (serializerType == HTTPResponseType) {
return [AFHTTPResponseSerializer serializer];
} else if (serializerType == PlistResponseType) {
return [AFPropertyListResponseSerializer serializer];
} else if (serializerType == ImageResponseType) {
return [AFImageResponseSerializer serializer];
} else if (serializerType == CompoundResponseType) {
return [AFCompoundResponseSerializer serializer];
} else {
return nil;
}
}

- (NSDictionary *)transformRequestDictionary {
return self.requestDictionary;
}

- (id)transformRequestData:(id)data {
return data;
}

+ (instancetype)networkingWithUrlString:(NSString *)urlString
requestDictionary:(NSDictionary *)requestDictionary
delegate:(id)delegate
timeoutInterval:(NSNumber *)timeoutInterval
flag:(NSString *)flag
requestMethod:(AFNetworkingRequestMethod)requestMethod
requestType:(AFNetworkingRequestType)requestType
responseType:(AFNetworkingResponseType)responseType {

Networking *networking       = [[[self class] alloc] init];
networking.urlString         = urlString;
networking.requestDictionary = requestDictionary;
networking.delegate          = delegate;
networking.timeoutInterval   = timeoutInterval;
networking.flag              = flag;
networking.RequestMethod     = requestMethod;
networking.requestType       = requestType;
networking.responseType      = responseType;

return networking;
}

@end

下载请求源码

//
//  DownloadTask.h
//  NetworkingCraft
//
//  Created by YouXianMing on 15/6/11.
//  Copyright (c) 2015年 YouXianMing. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
@class DownloadTask;

@protocol DownloadTaskDelegate <NSObject>
@optional
/**
*  下载任务
*
*  @param downloadTask 实例对象
*  @param progress     进度显示
*/
- (void)downloadTask:(DownloadTask *)downloadTask withProgress:(CGFloat)progress;

/**
*  下载失败
*
*  @param downloadTask 实例对象
*  @param error        错误信息
*/
- (void)downloadTask:(DownloadTask *)downloadTask failedWithError:(NSError *)error;

/**
*  下载成功
*
*  @param downloadTask 实例对象
*/
- (void)downloadTaskSucess:(DownloadTask *)downloadTask;

@end

@interface DownloadTask : NSObject

/**
*  代理
*/
@property (nonatomic, weak) id <DownloadTaskDelegate>    delegate;

/**
*  下载地址
*/
@property (nonatomic, strong) NSString                  *urlString;

/**
*  存储的文件路径（不包括文件名字，如果不设置，则默认在/Library/Caches文件夹下）
*
*  --------------------
*  /Documents
*  /Library/Caches
*  /Library/Preferences
*  /tmp
*  --------------------
*
*/
@property (nonatomic, strong) NSString                  *filePath;

/**
*  文件名（如果不给文件名，则使用默认的文件名）
*/
@property (nonatomic, strong) NSString                  *fileName;

/**
*  绝对文件路径
*/
@property (nonatomic, strong, readonly) NSString        *file;

/**
*  开始下载
*/
- (void)startDownload;

/**
*  停止下载
*/
- (void)stopDownload;

#pragma mark - 便利构造器
/**
*  便利构造器
*
*  @param urlString 下载地址
*  @param filePath  文件相对目录（可以不设置）
*  @param fileName  文件名字（可以不设置）
*  @param delegate  代理对象
*
*  @return 实例对象
*/
+ (instancetype)downloadTaskWithUrlString:(NSString *)urlString
fileDirectory:(NSString *)filePath
fileName:(NSString *)fileName
delegate:(id)delegate;

@end

//
//  DownloadTask.m
//  NetworkingCraft
//
//  Created by YouXianMing on 15/6/11.
//  Copyright (c) 2015年 YouXianMing. All rights reserved.
//

#import "DownloadTask.h"
#import "AFNetworking.h"

@interface DownloadTask ()

@property (nonatomic, strong) AFHTTPSessionManager      *session;
@property (nonatomic, strong) NSURLSessionDownloadTask  *downloadTask;
@property (nonatomic, strong) NSString                  *file;

@end

@implementation DownloadTask

- (instancetype)init {
self = [super init];
if (self) {

[self defaultConfig];
}

return self;
}

- (void)defaultConfig {
self.session = [AFHTTPSessionManager manager];
}

- (void)startDownload {

if (self.urlString.length <= 0) {
return;
}

// 定义一个progress指针
NSProgress *progress;

// 创建一个URL链接
NSURL *url = [NSURL URLWithString:self.urlString];

// 初始化一个请求
NSURLRequest *request = [NSURLRequest requestWithURL:url];

// 开始下载任务
__weak DownloadTask *weakSelf = self;
self.downloadTask = \
[self.session downloadTaskWithRequest:request
progress:&progress
destination:^NSURL *(NSURL *targetPath, NSURLResponse *response) {

// 获取基本路径
NSString *filePath = nil;

// 文件路径
if (weakSelf.filePath) {
filePath = [weakSelf pathWithSting:self.filePath];
} else {
filePath = [weakSelf pathWithSting:@"/Library/Caches"];
}

// 文件名字
if (weakSelf.fileName) {
filePath = [filePath stringByAppendingPathComponent:weakSelf.fileName];
} else {
filePath = [filePath stringByAppendingPathComponent:[response suggestedFilename]];
}

// 获取文件绝对路径
weakSelf.file = filePath;

NSURL *documentsDirectoryURL = [NSURL fileURLWithPath:filePath];

return documentsDirectoryURL;

} completionHandler:^(NSURLResponse *response, NSURL *filePath, NSError *error) {

if (weakSelf.delegate) {
// 结束后移除掉这个progress
[progress removeObserver:self
forKeyPath:@"fractionCompleted"
context:nil];

if (error == nil) {
// 成功
if ([weakSelf.delegate respondsToSelector:@selector(downloadTaskSucess:)]) {
[weakSelf.delegate downloadTaskSucess:weakSelf];
}
} else {
// 出错
if ([weakSelf.delegate respondsToSelector:@selector(downloadTask:failedWithError:)]) {
[weakSelf.delegate downloadTask:weakSelf failedWithError:error];
}
}

}
}];

// 开始下载
[self.downloadTask resume];

if (self.delegate) {
// 给这个progress添加监听任务
[progress addObserver:self
forKeyPath:@"fractionCompleted"
options:NSKeyValueObservingOptionNew
context:nil];
}
}

- (void)stopDownload {
[self.downloadTask cancel];
}

/**
*  获取路径
*
*  @param string 相对路径
*
*  @return 绝对路径
*/
- (NSString *)pathWithSting:(NSString *)string {
return [NSHomeDirectory() stringByAppendingPathComponent:string];
}

- (void)observeValueForKeyPath:(NSString *)keyPath
ofObject:(id)object
change:(NSDictionary *)change
context:(void *)context {
if ([keyPath isEqualToString:@"fractionCompleted"] && [object isKindOfClass:[NSProgress class]]) {
NSProgress *progress = (NSProgress *)object;
[_delegate downloadTask:self withProgress:progress.fractionCompleted];
}
}

+ (instancetype)downloadTaskWithUrlString:(NSString *)urlString
fileDirectory:(NSString *)filePath
fileName:(NSString *)fileName
delegate:(id)delegate {

DownloadTask *downloadTask = [[[self class] alloc] init];
downloadTask.urlString     = urlString;
downloadTask.filePath      = filePath;
downloadTask.fileName      = fileName;
downloadTask.delegate      = delegate;

return downloadTask;
}

@end

使用