AFURLSessionManager是一個可以請求數(shù)據(jù)聂喇、上傳數(shù)據(jù)辖源、下載數(shù)據(jù)的類。
一希太、屬性
//會話對象
@property (readonly, nonatomic, strong) NSURLSession *session;
//代理回調(diào)所運行的 操作隊列
@property (readonly, nonatomic, strong) NSOperationQueue *operationQueue;
//安全相關(guān)(策略)
@property (nonatomic, strong) AFSecurityPolicy *securityPolicy;
//網(wǎng)絡(luò)狀態(tài)監(jiān)測管理者
@property (readwrite, nonatomic, strong) AFNetworkReachabilityManager *reachabilityManager;
Session 就是該類要管理的 NSURLSession 對象;
operationQueue是操作隊列克饶，當代理回調(diào)的時候運行;
securityPolicy是用于處理網(wǎng)絡(luò)連接安全處理策略；
reachabilityManager是檢測網(wǎng)絡(luò)狀態(tài)的檢測器誊辉。
//任務(wù)（抽象類矾湃，本身不能使用，只能使用它的子類）
@property (readonly, nonatomic, strong) NSArray <NSURLSessionTask *> *tasks;
//(數(shù)據(jù))任務(wù)堕澄，一般用來處理網(wǎng)絡(luò)請求邀跃，如（GET|POST）請求⊥茏希或 用于（斷點下載|支持離線）
@property (readonly, nonatomic, strong) NSArray <NSURLSessionDataTask *> *dataTasks;
//(上傳)任務(wù)拍屑，用于處理上傳請求
@property (readonly, nonatomic, strong) NSArray <NSURLSessionUploadTask *> *uploadTasks;
//(下載)任務(wù)，用于處理下載請求
@property (readonly, nonatomic, strong) NSArray <NSURLSessionDownloadTask *> *downloadTasks;
通過這四個屬性坑傅，我們分別可以拿到總的任務(wù)集合僵驰、數(shù)據(jù)任務(wù)集合、上傳任務(wù)集合和下載任務(wù)集合
@property (nonatomic, assign) BOOL attemptsToRecreateUploadTasksForBackgroundSessions;
這個屬性非常重要唁毒，注釋里面寫到蒜茴，在iOS7中存在一個bug，在創(chuàng)建后臺上傳任務(wù)時浆西，有時候會返回nil粉私，所以為了解決這個問題，AFNetworking遵照了蘋果的建議室谚，在創(chuàng)建失敗的時候毡鉴，會重新嘗試創(chuàng)建崔泵，次數(shù)默認為3次秒赤，所以你的應(yīng)用如果有場景會有在后臺上傳的情況的話猪瞬，記得將該值設(shè)為YES，避免出現(xiàn)上傳失敗的問題
二入篮、初始化
- (instancetype)initWithSessionConfiguration:(nullable NSURLSessionConfiguration *)configuration NS_DESIGNATED_INITIALIZER;
被指定的初始化方法
- (void)invalidateSessionCancelingTasks:(BOOL)cancelPendingTasks;
如果將cancelPendingTasks設(shè)為YES的話陈瘦，會在主線程直接關(guān)閉掉當前會話，NO的話潮售，會等待當前task結(jié)束后再關(guān)閉
三痊项、核心方法
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler DEPRECATED_ATTRIBUTE;
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request
uploadProgress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
downloadProgress:(nullable void (^)(NSProgress *downloadProgress))downloadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
上面兩種方法是數(shù)據(jù)請求任務(wù)，
request則是你發(fā)出的HTTP請求
uploadProgressBlock和downloadProgressBlock則是在如果上傳和下載進度有更新的情況下才會調(diào)用
completionHandler就是在請求結(jié)束之后返回的內(nèi)容
DEPRECATED_ATTRIBUTE 標識符的意思是慢慢棄用的屬性或接口
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request
fromFile:(NSURL *)fileURL
progress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
- (NSURLSessionUploadTask *)uploadTaskWithRequest:(NSURLRequest *)request
fromData:(nullable NSData *)bodyData
progress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request
progress:(nullable void (^)(NSProgress *uploadProgress))uploadProgressBlock
completionHandler:(nullable void (^)(NSURLResponse *response, id _Nullable responseObject, NSError * _Nullable error))completionHandler;
上面三種不同的數(shù)據(jù)上傳方法
第一種是 通過fileURL（需要上傳的本地文件URL路徑）上傳酥诽，
第二種是 通過bodyData（需要上傳的HTTP body體的數(shù)據(jù)）鞍泉，
第三種是 使用流(輸出流)請求的方法，在使用該方法的時候肮帐，一定要設(shè)置setTaskNeedNewBodyStreamBlock回調(diào)咖驮，否則session沒辦法在重新發(fā)送steam的時候找到數(shù)據(jù)源。
- (NSURLSessionDownloadTask *)downloadTaskWithRequest:(NSURLRequest *)request
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgressBlock
destination:(nullable NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination
completionHandler:(nullable void (^)(NSURLResponse *response, NSURL * _Nullable filePath, NSError * _Nullable error))completionHandler;
- (NSURLSessionDownloadTask *)downloadTaskWithResumeData:(NSData *)resumeData
progress:(nullable void (^)(NSProgress *downloadProgress))downloadProgressBlock
destination:(nullable NSURL * (^)(NSURL *targetPath, NSURLResponse *response))destination
completionHandler:(nullable void (^)(NSURLResponse *response, NSURL * _Nullable filePath, NSError * _Nullable error))completionHandler;
上面是兩種下載方法训枢，
第一種 Request 是通過HTTP請求方式下載托修；
第二種 ResumeData 則是通過之前的下載數(shù)據(jù)來恢復(fù)下載；
destination在下載的過程中文件會先存放在一個臨時的位置恒界，等到下載完成之后睦刃，文件會轉(zhuǎn)移到目標位置
四、Notifications
FOUNDATION_EXPORT NSString * const AFNetworkingTaskDidResumeNotification;
在對外提供的notification key里面十酣，使用了FOUNDATION_EXPORT來定義常量涩拙，使用FOUNDATION_EXPORT和extern或者define有什么區(qū)別呢？
FOUNDATION_EXPORT在c文件編譯下是和extern等同耸采，在c++文件編譯下是和extern “C”等同兴泥，在32位機的環(huán)境下又是另外編譯情況，在兼容性方面洋幻，FOUNDATION_EXPORT做的會更好郁轻。
