AFNetworking 3.0

关于AFNetworking 3.0的介绍百度少之又少,没办法只能去谷歌吧啦了,为了以后阅读方便,收录到个人中,原文链接。


从3.0开始

一转眼,AF已经更新到了3.0版本。目前cocoapods上的最新版本是3.0 beta1。在3.0的版本里面,AF全面地使用NSURLSession代替了NSURLConnection。之前花了一些时间学习NSURLSession,在这里的学习终于派上了用场。在这里主要学习3.0版本的使用。希望在项目中能够顺利地过度到AFNetwoking 3.0版本。此外,随着Objective-c慢慢被Swift替代,AFNetworking 3.0可能是最后一个大版本更新。本文会一直随着AN的更新继续更新,也是一个不断学习的过程。
结构
--
在3.0时代,AFN精简了结构,全面使用了NSURLSession。

AFNetworking 3.0_第1张图片
beta1里面只剩下了当前几个Manager。
AFHTTPSessionManager是AFURLSessionManager的子类。
AFURLSessionManager
--
AFURLSessionManager实现了以下几种NSURLSession的代理方法

NSURLSessionDelegate
  • URLSession:didBecomeInvalidWithError:
  • URLSession:didReceiveChallenge:completionHandler:
  • URLSessionDidFinishEventsForBackgroundURLSession:
NSURLSessionTaskDelegate
  • URLSession:willPerformHTTPRedirection:newRequest:completionHandler:
  • URLSession:task:didReceiveChallenge:completionHandler:
  • URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:
  • URLSession:task:didCompleteWithError:
NSURLSessionDataDelegate
  • URLSession:dataTask:didReceiveResponse:completionHandler:
  • URLSession:dataTask:didBecomeDownloadTask:
  • URLSession:dataTask:didReceiveData:
  • URLSession:dataTask:willCacheResponse:completionHandler:
NSURLSessionDownloadDelegate
  • URLSession:downloadTask:didFinishDownloadingToURL:
  • URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesWritten:totalBytesExpectedToWrite:
  • URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:

成员

属性

在AFURLSessionManager中,主要的三个属性如下

AFNetworking 3.0_第2张图片

session实现了会话,operationQueue是一个操作队列。responseSerializer是实现AFURLResponseSerialization
协议的一个对象。

    • *********- - ----------------------------------------
      Manager中还包括了安全协议的对象和连通性的对象。这两个类将在后面谈到。
      AFNetworking 3.0_第3张图片

      下面是Task的内容,包含与当前Session中
      AFNetworking 3.0_第4张图片

      回调块队列,包括了在主队列和私有队列的两个部分
      AFNetworking 3.0_第5张图片
方法

初始化方法

AFNetworking 3.0_第6张图片

创建一个NSURLSessionDataTask数据性任务
AFNetworking 3.0_第7张图片

创建`NSURLSessionUploadTask上传任务

创建NSURLSessionDownloadTask下载任务
AFNetworking 3.0_第8张图片

获得一个特定任务的progress进度


Session Delegate Callbacks 设置会话代理回调


Task Delegate Callbacks 设置任务代理回调

当任务需要一个新的请求体发送给服务器的时候。


当HTTP请求回调有重定向的的话设置这个Block

当一个请求需要特别的鉴权的时候设置这个challenge

设置一个block去追踪上传进度

设置一个block当任务完成后执行

Setting Data Task Delegate Callbacks 设置数据任务代理的回调

设置一个在数据任务获得response的时候回调block


设置一个block当数据任务变成下载的任务的时候执行

设置一个block当数据任务获得到数据的时候

设置一个block绝对是否缓存数据任务

Download Task Delegate Callbacks 下载任务代理回调

设置block当下载任务完成下载后


设置block去追踪下载任务进度情况

设置block当下载任务执行/恢复的时候 执行

头文件的内容基本就是以上的了。可以看到整个AF的体系非常清晰完整,没有多余的东西,头文件只暴露了应该暴露的东西,值得我们去学习。


使用的例子

使用AFURLSessionManager

从源码中可以看到,AFURLSessionManager实现了
NSURLSessionDelegate, NSURLSessionTaskDelegate, NSURLSessionDataDelegate, NSURLSessionDownloadDelegate, NSSecureCoding, NSCopying

首先需要设置url和NSURLConfirguration这里是使用百度API商店的公开API


然后初始化Manager

设置ResponseSerializer

初始化request

对request进行相关设置

根据request生成对应的NSURLSessionTask。
AFNetworking 3.0_第9张图片

执行任务

来看看执行后的信息

这里由于使用的AFHTTPResponseSerializer
(API的问题,仅仅支持text/plain)所以在获取的数据后,我们自己要json序列化。如果是设计好的API,直接使用AFJSONRequestSerializer
就可以在回调中获取到json格式的数据了。
可以看到,整个使用还是很方便的。我们可以根据自己的需求配置不同设置。

你可能感兴趣的:(AFNetworking 3.0)