AFNetworking 学习笔记
上圖來自 @mattt 對 AFN 的介紹:Everybody Loves AFNetworking And So Can You!. 學(xué)習(xí) AFN,簡單記錄一下以加深自己理解。
AFN 的基礎(chǔ)部分是 AFURLConnectionOperation,一個 NSOperation subclass,實現(xiàn)了 NSURLConnection 相關(guān)的 delegate+blocks,網(wǎng)絡(luò)部分是由 NSURLConnection 完成,然后利用 NSOperation 的 state (isReady→isExecuting→isFinished) 變化來進(jìn)行網(wǎng)絡(luò)控制。網(wǎng)絡(luò)請求是在一個指定的線程(networkRequestThread)完成。
AFURLConnectionOperation 是一個很純粹的網(wǎng)絡(luò)請求 operation,可以對他進(jìn)行 start/cancel/pause/resume 操作,可以獲取對應(yīng)的 NSURLRequest 和 NSURLResponse 數(shù)據(jù)。支持 NSInputStream/NSOutputStream,提供了 uploadPress 和 downloadProgress 以方便其他使用。
| 1 2 3 4 5 6 | NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://httpbin.org/ip"]]; AFURLConnectionOperation *operation = [[AFURLConnectionOperation alloc] initWithRequest:request]; operation.completionBlock = ^ { NSLog(@"Complete: %@", operation.responseString); }; [operation start]; |
插播:@mattt 在 NSHipster 里有一篇?NSOperation?詳細(xì)介紹了 NSOperation 的 state、priority、dependency 等,對理解 AFURLConnectionOperation 很有幫助。
理解了 AFURLConnectionOperation 再看 AFHTTPRequestOperation 就簡單很多。AFHTTPRequestOperation 是 AFURLConnectionOperation 的子類,針對 HTTP+HTTPS 協(xié)議做了一層封裝,比如 statusCode、Content-Type 等,添加了請求成功和失敗的回調(diào) block,提供了?addAcceptableContentTypes:?以方便上層使用。
| 1 2 3 4 5 6 7 8 | NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://httpbin.org/robots.txt"]]; AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request]; [operation setCompletionBlockWithSuccess:^(AFHTTPRequestOperation *operation, id responseObject) { NSLog(@"Success: %@", operation.responseString); } failure:^(AFHTTPRequestOperation *operation, NSError *error) { NSLog(@"Failure: %@", error); }]; [operation start]; |
AFJSONRequestOperation 是 AFHTTPRequestOperation 的子類,針對 JSON 類型請求做了特殊處理,在有了 AFHTTPRequestOperation+AFURLConnectionOperation 的基礎(chǔ)工作后,AFJSONRequestOperation 已經(jīng)非常方便直接使用了。指定?acceptableContentTypes:?以支持 JSON,responseJSON?直接返回已經(jīng)解析好的 JSON 數(shù)據(jù)對象。下載到 JSON 數(shù)據(jù)后在一單獨線程 queue(json_request_operation_processing_queue)對 JSON 數(shù)據(jù)進(jìn)行解析處理,處理完成后由主線程回調(diào) success block。
AFN 的 JSON encode/decode 處理做的非常巧妙,現(xiàn)在有很多 JSON 解析庫,第三方的 JSONKit、SBJSON 等,iOS 5+ 自帶的 NSJSONSerialization,不同的項目可能會因為不同的需求而用不同的庫,AFN 就封裝了一個 AFJSONUtilities,提供?AFJSONEncode?和?AFJSONDecode?兩個方法,通過?NSClassFromString?和?NSSelectorFromString?來查找項目中使用的 JSON 庫然后進(jìn)行 encode/decode。
| 1 2 3 4 5 6 7 8 | NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://httpbin.org/get"]]; AFJSONRequestOperation *operation = [AFJSONRequestOperation JSONRequestOperationWithRequest:request success:^(NSURLRequest *request, NSHTTPURLResponse *response, id JSON) { NSLog(@"Success :%@", JSON); } failure:^(NSURLRequest *request, NSHTTPURLResponse *response, NSError *error, id JSON) { NSLog(@"Failure: %@", error); }]; [operation start]; |
AFXMLRequestOperation/AFPropertyListRequestOperation/AFImageRequestOperation 和 AFJSONRequestOperation 類似,針對 XML、Plist、image 類型請求做了一些處理。其中 AFImageRequestOperation 額外有一個 imageProcessingBlock,取到圖片后可以在一個單獨線程 queque 對圖片進(jìn)行處理,比如縮放、切圓角、圖片特效等,然后再交給 main_queue success block.
AFN 還提供了一個 UIImageView+AFNetworking category,可以用?setImageWithURL:?來設(shè)置圖片。這個 cagetory 和 SDWebImage 類似但更簡單一些,圖片下載由 AFN 完成,圖片緩存由 NSCache 處理。
直接用上面這些已經(jīng)可以方便的做網(wǎng)絡(luò)請求,AFN 在這些基礎(chǔ)上還提供了一個 AFHTTPClient,把 HTTP 請求的 Headers、User-Agent 等再次包裝,方便使用。AFHTTPClient 是一個單例,對請求參數(shù)做了 URL 編碼;維護(hù)一個 NSOperationQueue,不同的請求生成各自的 AFHTTPRequestOperation 然后?enqueueHTTPRequestOperation:添加的隊列順序執(zhí)行;registerHTTPOperationClass:?方法用來注冊上面的 JSON/XML/Plist/image operation,拿到請求結(jié)果后交給對應(yīng)的 operation 處理。AFHTTPClient 還針對 GET/POST/HEAD/PUT/DELETE 等不同的請求做了不同的 URL 參數(shù)和 Headers 處理,包括 multipart/form-data 類型。
AFHTTPClient 支持批量添加 operations,生成一個 batchedOperation,把所有 operations 作為 batchedOperation 的 dependency,再依次把所有 operations 和 batchedOperation 都添加到 operationQueue,這樣每一個 operation 完成后都可以做一個 progressBlock 來返回當(dāng)前已完成的 operations 數(shù)和總數(shù),等所有 operations 都完成后會做 batchedOperation 的 completionBlock,就可以在這一批 operations 都完成后做一些善后處理。
AFHTTPClient 提倡對同一應(yīng)用(同一 baseURL)的網(wǎng)絡(luò)請求封裝自己的 HTTPClient 子類,這樣會方便很多。參考?WBKHTTPClient.
AFN 還提供了很多模塊,可以很方便的和 AFN 整合做一些工作,比如 OAuth,Amazon S3 等,詳見?AFNetworking-Extensions.
AFN 作者 @mattt 做東西很有自己一套思想在里面,推薦?What I Learned From AFNetworking’s GitHub Issues,視頻。
總結(jié)
以上是生活随笔為你收集整理的AFNetworking 学习笔记的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 昆仑万维宣布与 OpenAI 合作,旗下
- 下一篇: 百度文心一言3月正式开放?3月16日14