iOS網(wǎng)絡(luò)請(qǐng)求相關(guān)框架的使用
關(guān)于iOS相關(guān)技術(shù)的博客非常非常多了,沒有好的內(nèi)容也不想寫,最近在迭代公司項(xiàng)目版本,對(duì)于這個(gè)題材也想了很久,看了很多類似的文章,決定記錄一下。網(wǎng)絡(luò)請(qǐng)求,是客戶端開發(fā)中一個(gè)很重要的模塊,關(guān)于此方面需要了解的東西也是非常多的,此篇文章僅介紹自己用過的有關(guān)框架。
AFNetworking
1. 關(guān)于AFNetworking
只要是做iOS開發(fā)的應(yīng)該都是知道這個(gè)框架的,有多優(yōu)秀我就不贅述了。自iOS9之后蘋果棄用了NSURLConnection只用NSURLSession,所以AFN從3.0版本開始就刪除了基于NSURLConnection API的所有支持,基于NSURLSession框架以及NSOperation進(jìn)行的封裝開發(fā)。
2. 基于AFNetworking進(jìn)行網(wǎng)絡(luò)請(qǐng)求
既然用的是第三方框架,那么肯定會(huì)有一些局限性??蚣艿牡露紩?huì)影響我們的代碼,所以盡可能解耦,一般我們都會(huì)單獨(dú)的寫一個(gè)網(wǎng)絡(luò)請(qǐng)求工具類對(duì)框架進(jìn)行封裝。這樣即使框架更改了,也只需要更改工具類相關(guān)代碼。
a.新建網(wǎng)絡(luò)請(qǐng)求工具類,實(shí)例化AFHTTPSessionManager。類似如下 :
- + (instancetype)sharedInstance
- {
- static dispatch_once_t onceToken;
- dispatch_once(&onceToken, ^{
- _mutParamares = [NSMutableDictionary dictionary];
- _manager = [AFHTTPSessionManager manager];
- _manager.requestSerializer = [AFHTTPRequestSerializer serializer];
- _manager.requestSerializer.timeoutInterval = 30.0f;
- [AFNetworkActivityIndicatorManager sharedManager].enabled = YES;
- _manager.responseSerializer.acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/html", @"text/json",
- @"text/plain", @"text/javascript", @"text/xml", @"image/*", nil];
- });
- }
兩個(gè)需要注意的問題:***,這里的網(wǎng)絡(luò)請(qǐng)求工具類是一個(gè)單利,為什么要用單利呢? [AFHTTPSessionManager manager]跟蹤到這個(gè)方法里,會(huì)看到返回的manager并不是單利,如果每次請(qǐng)求都實(shí)例化一個(gè)manager的話,那么有可能造成內(nèi)存泄漏。第二,有時(shí)候請(qǐng)求失敗的原因是AFN支持的response類型和服務(wù)器返回給我們的類型不一致,需要修改AFN的源碼進(jìn)行修改,但用Cocoapods來管理三方框架,pod update之后修改的代碼又會(huì)被重置。此時(shí),就可以通過acceptableContentTypes屬性來根據(jù)需要設(shè)置。
- + (instancetype)manager {
- return [[self alloc] initWithBaseURL:nil];
- }
也可以通過requestSerializer屬性設(shè)置請(qǐng)求頭相關(guān)的信息。如:
- [self.manager.requestSerializer setValue:@"" forHTTPHeaderField:@""];
b.常用的網(wǎng)絡(luò)請(qǐng)求類型。這是對(duì)外的API,外部通過調(diào)用這些接口實(shí)現(xiàn)相關(guān)的網(wǎng)絡(luò)請(qǐng)求。當(dāng)然你也可以根據(jù)自己的需要暴露相關(guān)的API。相應(yīng)的接口實(shí)現(xiàn)比較簡(jiǎn)單。具體的邏輯還應(yīng)根據(jù)業(yè)務(wù)需求在外部實(shí)現(xiàn)。對(duì)于文件的操作,如圖片的上傳,可參考代碼如下。
- image.png
- // 上傳多張圖片
- [_manager POST:url parameters:param constructingBodyWithBlock:^(id<afmultipartformdata> _Nonnull formData) {
- for (UIImage *image in imgArray) {
- UIImage *resizeImage = image.reSizeImage;
- NSData *data = UIImagePNGRepresentation(resizeImage);
- [formData appendPartWithFileData:data name: @"file" fileName:[NSString stringWithFormat:@"img%ld.png",i] mimeType:@"image/png"];
- }];</afmultipartformdata>
上傳多張圖片的時(shí)候,根據(jù)需要可對(duì)圖片進(jìn)行裁剪和壓縮。關(guān)于上傳的進(jìn)度可以通過progressBlock返回在對(duì)應(yīng)的UI上進(jìn)行顯示,進(jìn)度的計(jì)算公式如下。
- processBlock(progress.completedUnitCount / progress.totalUnitCount);
c.監(jiān)測(cè)網(wǎng)絡(luò)狀態(tài)。
- AFNetworkReachabilityManager *manager = [AFNetworkReachabilityManager sharedManager];
- [manager setReachabilityStatusChangeBlock:^(AFNetworkReachabilityStatus status) {
- switch (status) {
- case AFNetworkReachabilityStatusUnknown: break;
- case AFNetworkReachabilityStatusNotReachable: break;
- case AFNetworkReachabilityStatusReachableViaWWAN: break;
- case AFNetworkReachabilityStatusReachableViaWiFi: break;
- }
- }];
- [manager startMonitoring];
以上是基于AFNetworking的網(wǎng)絡(luò)請(qǐng)求。上面說的這種網(wǎng)絡(luò)請(qǐng)求方式是集約式的網(wǎng)絡(luò)請(qǐng)求,也就是所有的API都調(diào)用的是這個(gè)工具類。還有一種網(wǎng)絡(luò)請(qǐng)求方式是離散式的,也就是每一個(gè)API都有自己對(duì)應(yīng)的類。
YTKNetwork
1. 關(guān)于YTKNetwork
這個(gè)框架也是基于AFNetworking進(jìn)行的再次封裝,適用于規(guī)模較大的項(xiàng)目中。YTKNetwork是離散式的網(wǎng)絡(luò)請(qǐng)求方式,如上所述,每一個(gè)請(qǐng)求都對(duì)應(yīng)一個(gè)對(duì)象,可根據(jù)需要對(duì)相應(yīng)的請(qǐng)求進(jìn)行定制化。另外YTKNetwork支持批量網(wǎng)絡(luò)請(qǐng)求發(fā)送并設(shè)置統(tǒng)一回調(diào)、支持相互依賴的網(wǎng)絡(luò)請(qǐng)求等等功能。
2. 基于YTKNetwork進(jìn)行網(wǎng)絡(luò)請(qǐng)求
a. 同上,不建議直接使用第三方,自己寫一個(gè)BaseRequest類繼承YTKRequest,在這個(gè)類里面實(shí)現(xiàn)下面這個(gè)方法。這個(gè)方法是所有請(qǐng)求的Response。
- - (void)startWithCompletionBlockWithSuccess:(YTKRequestCompletionBlock)success failure:(YTKRequestCompletionBlock)failure{}
b. 寫一個(gè)網(wǎng)絡(luò)請(qǐng)求配置類。在程序啟動(dòng)的時(shí)候通過YTKNetworkConfig配置網(wǎng)絡(luò)請(qǐng)求。如baseUrl參數(shù)等。通過YTKNetworkAgent設(shè)置一些參數(shù),如上面提到的acceptableContentTypes參數(shù)。這個(gè)類是真正發(fā)起請(qǐng)求的類,也是在這個(gè)類中與AFN打交道。
- _config = [YTKNetworkConfig sharedConfig];
- _config.baseUrl = BASE_INTERFACE_URL_DEV;
- YTKNetworkAgent *agent = [YTKNetworkAgent sharedAgent];
- NSSet *acceptableContentTypes = [NSSet setWithObjects:@"application/json", @"text/json", @"text/javascript", @"text/plain", @"text/html", @"text/css", nil];
- NSString *keypath = @"jsonResponseSerializer.acceptableContentTypes";
- [agent setValue:acceptableContentTypes forKeyPath:keypath];
3.以一個(gè)具體的API(請(qǐng)求用戶信息)請(qǐng)求為例。
3.1 新建一個(gè)UserInfoAPI類,繼承你寫的BaseRequest類。
3.2 實(shí)現(xiàn)以下方法。請(qǐng)求的URL,和外部無關(guān),不需要外面?zhèn)鬟M(jìn)來。請(qǐng)求的類型,以及請(qǐng)求的參數(shù)。當(dāng)然,解析也可以在API類內(nèi)部實(shí)現(xiàn)。通過在GET方法里面實(shí)現(xiàn)數(shù)據(jù)的轉(zhuǎn)換和解析。
- - (NSString *)requestUrl {
- return kUserURL;
- }
- - (YTKRequestMethod)requestMethod {
- return YTKRequestMethodPOST;
- }
- - (instancetype)requestArgument {
- return parameter;
- }
serverRespData是基類自定義的一個(gè)參數(shù),是數(shù)據(jù)過濾之后的response。
- _serverRespData = [self.responseJSONObject objectForKey:@"data"];
- - (QDZQUseModel *)user { // 重寫user的get方法。
- _user = [QDZQUserEntity yy_modelWithDictionary:[self.serverRespData objectForKey:@"appUser"]];
- return _user;
- }
3.3 如何調(diào)用這個(gè)API
- + (void)fetchUserInfoSuccess:(void (^)(void))success failure:(void (^)(NSError * error))failure {
- UserInfoApi *api = [[UserInfoApi alloc] init];
- [api startWithCompletionBlockWithSuccess:^(__kindof YTKBaseRequest * _Nonnull request) {
- if (success) { }
- } failure:^(__kindof YTKBaseRequest * _Nonnull request) {
- if (failure) { }
- }];
- }
3.4 添加請(qǐng)求頭
如果你需要添加請(qǐng)求頭的話,你可以實(shí)現(xiàn)下面這個(gè)方法。
- - (nullable NSDictionary<nsstring *, nsstring *> *)requestHeaderFieldValueDictionary {
- return @{@"token" : @""};
- }</nsstring *, nsstring *>
以上,是兩種網(wǎng)絡(luò)請(qǐng)求方式(離散式、集約式)。