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