AFURLSessionManager类说明
继承:NSObject
遵照:NSCopying,NSSecureCoding,NSURLSessionDataDelegate,NSURLSessionDelegate,NSURLSessionDownloadDelegate,NSURLSessionTaskDelegate
声明处:AFURLSessionManager.h
概述
AFURLSessionManager创建和管理一个以指定的NSURLSessionConfiguration对象为基础的NSURLSession对象,其中NSURLSessionConfiguration对象遵照<NSURLSessionTaskDelegate>,<NSURLSessionDataDelegate>, <NSURLSessionDownloadDelegate>和<NSURLSessionDelegate>.
子类必读
AFHTTPSessionManager是为HTTP请求添加具体功能的基础方法。如果你想为HTTP实现明确的功能来扩展AFURLSeesionManager,请考虑用AFHTTPSessionManager子类来代替。
NSURLSession 和 NSURLSessionTask代理方法
AFURLSesssionManager实现了以下的代理方法。
NSURLSessionDelegate
- URLSession:didBecomeInvalidWithError:
- URLSession:didReceiveChallenge:completionHandler:
- URLSessionDidFinishEventsForBackgroundURLSession:
NSURLSessionTaskDelegate
- URLSession:willPerformHTTPRedirection:newRequest:completionHandler:
- URLSession:task:didReceiveChallenge:completionHandler:
- URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:
- URLSession:task:needNewBodyStream:
- 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:
如果任意方法在子类中被重载,那么必须先调用super实现方法,再实现子类的内容。
网络可达性监控
通过reachabilityManager属性监听网络可达性状态和改变监控器是否为有效。应用可能为了保护或挂起任意的向外请求而选择去监控网络可达性条件。详见AFNetworkReachabilityManager。
NSCoding说明
编码管理不能包含任何块属性。当使用-initWithCoder:
或NSKeyedUnarchiver时确保设置代理回调的块。
NSCopying说明
-
-copy
和-copyWithZone
返回一个包含从原始的配置信息创建的新的NSURLSession的新的会话管理实例。 - 执行拷贝不能包含任何代理回调块,因为块经常是对self的强引用,在拷贝中可能导致非主观的将指针指向原始的会话的错误。
警告:会话在后台执行时,会话管理必须拥有这些会话。这个可以通过创建一个程序的全局可用的会话管理或一个共享单例来实现。
任务
其他方法
- session 属性
- operationQueue 属性
- responseSerializer 属性
管理安全协议
- securityPolicy 属性
监视网络可达性
- reachabilityManager 属性
获取会话任务
- tasks 属性
- dataTasks 属性
- uploadTasks 属性
*downloadTasks 属性
管理回调队列
- completionQueue 属性
- completionGroup 属性
工作系统错误
- attemptsToRecreateUploadTasksForBackgroundSessions 属性
初始化
– initWithSessionConfiguration:
– invalidateSessionCancelingTasks:
执行数据任务
– dataTaskWithRequest:completionHandler:
– dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:
执行上传任务
– uploadTaskWithRequest:fromFile:progress:completionHandler:
– uploadTaskWithRequest:fromData:progress:completionHandler:
– uploadTaskWithStreamedRequest:progress:completionHandler:
执行下载任务
– downloadTaskWithRequest:progress:destination:completionHandler:
– downloadTaskWithResumeData:progress:destination:completionHandler:
获取任务的进度
– uploadProgressForTask:
– downloadProgressForTask:
设置会话代理回调
– setSessionDidBecomeInvalidBlock:
– setSessionDidReceiveAuthenticationChallengeBlock:
设置任务代理回调
– setTaskNeedNewBodyStreamBlock:
– setTaskWillPerformHTTPRedirectionBlock:
– setTaskDidReceiveAuthenticationChallengeBlock:
– setTaskDidSendBodyDataBlock:
– setTaskDidCompleteBlock:
设置数据任务代理回调
– setDataTaskDidReceiveResponseBlock:
– setDataTaskDidBecomeDownloadTaskBlock:
– setDataTaskDidReceiveDataBlock:
– setDataTaskWillCacheResponseBlock:
– setDidFinishEventsForBackgroundURLSessionBlock:
设置下载任务代理回调
– setDownloadTaskDidFinishDownloadingBlock:
– setDownloadTaskDidWriteDataBlock:
– setDownloadTaskDidResumeBlock:
属性
attemptsToRecreateUploadTasksForBackgroundSessions
@property (nonatomic, assign) BOOL attemptsToRecreateUploadTasksForBackgroundSessions
讨论
是否在初始化时返回nil时,试图重新为后台会话创建上传任务。 默认值为NO。
错误:在iOS 7.0有一个bug,为后台任务创建上传任务时可能为nil。作为一个解决方法,当这个属性设置为YES时,AFNetworking将遵照苹果公司的建议尝试重新创建任务。
同见
https://github.com/AFNetworking/AFNetworking/issues/1675
声明处
AFURLSessionManager.h
completionGroup
@property (nonatomic, strong, nullable) dispatch_group_t completionGroup
讨论
completionBlock的派发组。如果为NULL,使用一个私有的派发组。
声明处
AFURLSessionManager.h
completionQueue
@property (nonatomic, strong, nullable) dispatch_queue_t completionQueue
讨论
completionBlock的派发队列。如果为NULL,使用系统主队列。
声明处
AFURLSessionManager.h
dataTasks
@property (readonly, nonatomic, strong) NSArray<NSURLSessionDataTask*> *dataTasks
讨论
数据任务的运行当前被执行会话管理。
声明处
AFURLSessionManager.h
downloadTasks
@property (readonly, nonatomic, strong) NSArray<NSURLSessionDownloadTask*> *downloadTasks
讨论
下载任务的运行当前被执行会话管理。
声明处
AFURLSessionManager.h
operationQueue
@property (readonly, nonatomic, strong) NSOperationQueue *operationQueue
讨论
代理回调执行的操作队列。
声明处
AFURLSessionManager.h
reachabilityManager
@property (readwrite, nonatomic, strong) AFNetworkReachabilityManager *reachabilityManager
讨论
网络可达性管理。AFURLSessionManager默认使用sharedManager.
声明处
AFURLSessionManager.h
responseSerializer
@property (nonatomic, strong) id<AFURLResponseSerialization> responseSerializer
讨论
响应是从服务器返回的,服务器在数据任务中通过dataTaskWithRequest:success:failure:
方法创建,并使用GET/POST等便利方法自动验证和响应序列化的数据。默认情况下,这个属性是设置为一个AFJSONResponseSerializer实例。
警告:responseSerializer必须不能为nil。
声明处
AFURLSessionManager.h
securityPolicy
@property (nonatomic, strong) AFSecurityPolicy *securityPolicy
讨论
安全协议是被创建会话使用,用于为安全连接评估服务信任。AFURLSessionManager默认使用defaultPolicy
除非另外指定。
声明处
AFURLSessionManager.h
session
@property (readonly, nonatomic, strong) NSURLSession *session
讨论
管理会话。
声明处
AFURLSessionManager.h
tasks
@property (readonly, nonatomic, strong) NSArray<NSURLSessionTask*> *tasks
讨论
数据,上传和下载任务现在都是被管理会话执行的。
声明处
AFURLSessionManager.h
uploadTasks
@property (readonly, nonatomic, strong) NSArray<NSURLSessionUploadTask*> *uploadTasks
讨论
上传任务现在被管理会话执行的。
声明处
AFURLSessionManager.h
实例方法
- (NSURLSessionDataTask *)dataTaskWithRequest:(NSURLRequest *)request completionHandler:(nullable void ( ^ ) ( NSURLResponse *response , id _Nullable responseObject , NSError *_Nullable error ))completionHandler
讨论
根据指定请求创建一个NSURLSessionDataTask。
参数
request
HTTP请求的请求。
completionHandler
任务完成时执行的一个块对象。这个块没有返回值并有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
dataTaskWithRequest:uploadProgress:downloadProgress:completionHandler:
- (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
讨论
根据指定请求创建一个NSURLSessionDataTask对象。
参数
request
HTTP请求的请求。
uploadProgressBlock
一个块对象,在上传进度更新时被执行。注意这个块是在会话队列中被调用,不是在主队列。
downloadProgressBlock
一个块对象,在下载进度更新时被执行。注意这个块是在会话队列中被调用,不是在主队列。
completionHandler
任务完成时执行的一个块对象。这个块没有返回值并有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
downloadProgressForTask:
- (nullable NSProgress *)downloadProgressForTask:(NSURLSessionTask *)task
讨论
返回指定任务的下载进度。
参数
task
会话任务。必须不能为nil。
返回值
一个报道任务下载进度的NSProgress对象,当进度不能获取时可能为nil。
声明处
AFURLSessionManager.h
downloadTaskWithRequest:progress:destination:completionHandler:
- (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对象。
警告: 如果在iOS上使用一个后台的NSURLSessionConfiguration,这些块将在app终止后消失。后台会话最好使用setDownloadTaskDidFinishDownloadingBlock:去保存指定URL的下载文件,而不是使用这个方法的目标块。
参数
request
HTTP请求的请求。
downloadProgressBlock
一个块对象,在下载进度更新时被执行。注意这个块是在会话队列中被调用,不是在主队列。
destination
一个块对象,为了终止下载文件的目的地时被执行。这个块有2个参数,目标路径和服务器的响应内容,返回产生下载需要的文件URL。下载过程中的临时文件会在被移动到返回的URL后自动删除。
completionHandler
任务完成时执行的一个块对象。这个块没有返回值并有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
downloadTaskWithResumeData:progress:destination: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
讨论
根据指定的恢复数据创建一个NSURLSessionDownloadTask对象。
参数
resumeData
用来恢复下载的数据。
downloadProgressTask
一个块对象,在下载进度更新时被执行。注意这个块是在会话队列中被调用,不是在主队列
destination
一个块对象,为了终止下载文件的目的地时被执行。这个块有2个参数,目标路径和服务器的响应内容,返回产生下载需要的文件URL。下载过程中的临时文件会在被移动到返回的URL后自动删除。
completionHandler
任务完成时执行的一个块对象。这个块没有返回值并有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
initWithSessionConfiguration:
- (instancetype)initWithSessionConfiguration:(nullable NSURLSessionConfiguration *)configuration
讨论
创建和返回一个会话的管理,这个管理使用指定的配置创建。这是特定的初始化方法。
参数
configuration
用来创建管理会话的配置信息。
返回值
一个新创建会话的管理器。
声明处
AFURLSessionManager.h
invalidateSessionCancelingTasks:
- (void)invalidateSessionCancelingTasks:(BOOL)cancelPendingTasks
讨论
作废管理会话,可选的取消即将发生的任务。
参数
cancelPendingTasks
是否取消即将发生的任务。
声明处
AFURLSessionManager.h
setDataTaskDidBecomeDownloadTaskBlock:
- (void)setDataTaskDidBecomeDownloadTaskBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionDataTask *dataTask , NSURLSessionDownloadTask *downloadTask ))block
讨论
设置一个在一个数据任务已经成为一个下载任务时执行的块,同时被NSURLSessionDataDelegate的方法URLSession:dataTask:didBecomeDownloadTask:使用。
参数
block
一个块对象,在一个数据任务已经变成一个下载任务时被执行。这个块没有返回值,3个参数:会话,数据任务,已经变成的下载任务。
声明处
AFURLSessionManager.h
setDataTaskDidReceiveDataBlock:
- (void)setDataTaskDidReceiveDataBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionDataTask *dataTask , NSData *data ))block
讨论
设置一个在数据任务接收到数据后被执行的块,同时被NSURLSessionDataDelegate的方法URLSession:dataTask:didReceiveData:使用。
参数
块
一个块在一个待定的字符数从服务器下载时被调用。这个块没有返回值,有3个参数:会话,数据任务,接收到的数据。这个块可能被调用很多次,将在会话管理操作队列中执行。
声明处
AFURLSessionManager.h
setDataTaskDidReceiveResponseBlock:
- (void)setDataTaskDidReceiveResponseBlock:(nullable NSURLSessionResponseDisposition ( ^ ) ( NSURLSession *session , NSURLSessionDataTask *dataTask , NSURLResponse *response ))block
讨论
设置一个在数据任务接收到一个响应后被执行的块,同时被NSURLSessionDataDelegate的方法URLSession:dataTask:didReceiveResponse:completionHandler:使用。
参数
block
一个块在数据任务已经接受到一个响应后被执行。这个块返回会话响应的支配权,有3个参数:会话,数据任务,接收到的响应。
声明处
AFURLSessionManager.h
setDataTaskWillCacheResponseBlock:
- (void)setDataTaskWillCacheResponseBlock:(nullable NSCachedURLResponse *( ^ ) ( NSURLSession *session , NSURLSessionDataTask *dataTask , NSCachedURLResponse *proposedResponse ))block
讨论
设置一个被执行的块,用来判断数据任务的缓存行为,同时被NSURLSessionDataDelegate的方法URLSession:dataTask:willCacheResponse:completionHandler:使用。
参数
block
一个块对象用来判断数据任务的缓存行为。这个块返回用于缓存的响应,有3个参数:会话,数据任务,返回的URL响应缓存。
声明处
AFURLSessionManager.h
setDidFinishEventsForBackgroundURLSessionBlock:
- (void)setDidFinishEventsForBackgroundURLSessionBlock:(nullable void ( ^ ) ( NSURLSession *session ))block
讨论
设置一个块,当所有消息队列的会话已经发送后被执行一次。同时被NSURLSessionDataDelegate的方法URLSessionDidFinishEventForBackgroundURLSession:使用。
参数
block
一个块对象当所有消息队列的会话已经发送后被执行一次。这个块没有返回值,有1个参数:会话。
声明处
AFURLSessionManager.h
setDownloadTaskDidFinishDownloadingBlock:
``
讨论
设置一个块,当下载任务已经完成时执行。同时被NSURLSessionDownloadDelegate的方法NSURLSession:downloadTask:didFinishDownloadingToURL:使用。
参数
block
一个块对象当一个下载任务已经完成。这个块返回需要被移除的URL,有3个参数:会话,下载任务,下载文件的临时路径。当企图移动临时文件到目的地时文件管理器发生错误,会发送一个AFURLSessionDownloadTaskDidFailToMoveFileNotification通知,通知中携带下载任务的对象和错误的用户信息。
声明处
AFURlSessionManager.h
setDownloadTaskDidResumeBlock:
- (void)setDownloadTaskDidResumeBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionDownloadTask *downloadTask , int64_t fileOffset , int64_t expectedTotalBytes ))block
讨论
设置一个块,当下载任务已经重新开始时被执行。同时被NSURLSessionDownloadDelegate的方法URLSession:downloadTask:didResumeAtOffset:expectedTotalBytes:使用。
参数
block
一个块对象,当下载任务已经重新开始时被执行。这个块没有返回值,有4个参数:会话,下载任务,重新开始下载的文件偏移量,被下载的预期总字节数。
声明处
AFURLSessionManager.h
setDownloadTaskDidWriteDataBlock:
- (void)setDownloadTaskDidWriteDataBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionDownloadTask *downloadTask , int64_t bytesWritten , int64_t totalBytesWritten , int64_t totalBytesExpectedToWrite ))block
讨论
设置一个块,追踪下载的进度被定期的执行。同时被NSRULSessionDownloadDelegate的方法URLSession:downloadTask:didWriteData:totalBytesWritten:totalBytesWritten:totalBytesExpectedToWrite:使用。
参数
block
一个块对象,当一些字节已经从服务器下载时被调用。这个块没有返回值,有5个参数:会话,下载任务,从下载进度的块最后一次被调用以来读取的字节数,已经读取的总字节数,在这个请求中期望读取的总字节数,NSHTTPURLResponse对象预期的内容大小作为初始判断大小。这个块会被调用很多次,会在会话管理操作队列中执行。
声明处
AFURLSessionManager.h
setSessionDidBecomeInvalidBlock:
- (void)setSessionDidBecomeInvalidBlock:(nullable void ( ^ ) ( NSURLSession *session , NSError *error ))block
讨论
设置一个块,当管理会话变为无效时执行。同时被NSURLSessionDelegate的方法URLSession:didBecomeInvalidWithError:调用。
参数
块
一个块对象,当管理会话变为无效时执行。这个块没有返回值,有2个参数:会话,导致无效的错误信息。
声明处
AFURLSessionManager.h
setSessionDidReceiveAuthorizationChallengeBlock:
- (void)setSessionDidReceiveAuthenticationChallengeBlock:(nullable NSURLSessionAuthChallengeDisposition ( ^ ) ( NSURLSession *session , NSURLAuthenticationChallenge *challenge , NSURLCredential *_Nullable __autoreleasing *_Nullable credential ))block
讨论
设置一个块,当一个发生连接认证挑战时执行。同时被NSURLSessionDelegate的方法URLSession:didReceiveChallenge:completionHandler:调用。
参数
block
一个块对象在一个发生连接认证挑战时执行。这个块返回认证挑战的配置,有3个参数:会话,授权被怀疑,一个指向证书的指针,证书应该用来解决怀疑。
声明处
AFURLSessionManager.h
setTaskDidCompleteBlock:
- (void)setTaskDidCompleteBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionTask *task , NSError *_Nullable error ))block
讨论
设置一个块,当最后的消息关联的执行任务时执行。同时被NSURLSessionTaskDelegate的方法URLSession:task:didCompleteWithError:调用。
参数
块
一个块对象,当一个会话任务完成时调用。这个块没有返回值,有3个参数:会话,任务,执行任务过程中发生的任何错误。
声明处
AFURLSessionManager.h
setTaskDidReceiveAuthenticationChallengeBlock:
- (void)setTaskDidReceiveAuthenticationChallengeBlock:(nullable NSURLSessionAuthChallengeDisposition ( ^ ) ( NSURLSession *session , NSURLSessionTask *task , NSURLAuthenticationChallenge *challenge , NSURLCredential *_Nullable __autoreleasing *_Nullable credential ))block
讨论
设置一个块,当一个会话任务接受到一个请求指定的认证挑战时调用。同时被NSURLSessionTaskDelegate的方法URLSession:task:didReceiveChallenge:completionHandler:调用.
参数
block
一个块对象,当一个会话任务接受到一个请求指定的授权怀疑时被执行。这个块返回认证挑战的配置,有4个参数:会话,任务,认证挑战,一个指向应该解决挑战的证书的指针。
声明处
AFURLSessionManager.h
setTaskDidSendBodyDataBlock:
- (void)setTaskDidSendBodyDataBlock:(nullable void ( ^ ) ( NSURLSession *session , NSURLSessionTask *task , int64_t bytesSent , int64_t totalBytesSent , int64_t totalBytesExpectedToSend ))block
讨论
设置一个块,定时执行跟踪上传的进度。同时被NSURLSessionTaskDelegate的方法URLSession:task:didSendBodyData:totalBytesSent:totalBytesExpectedToSend:调用。
参数
block
一个块对象当一个未确定的字节数被上传到服务器被调用。这个块没有返回值,有5个参数:会话,任务,从上传进度最后一次被调用后已经写了的字节数,需要写的总的字符串,请求中需要写的总的字节数,HTTP消息体中初始确定的长度。这个块可能被调用多次,在主线程中被执行。
声明处
AFURLSessionManager.h
setTaskNeedNewBodyStreamBlock:
- (void)setTaskNeedNewBodyStreamBlock:(nullable NSInputStream *( ^ ) ( NSURLSession *session , NSURLSessionTask *task ))block
讨论
设置一个块,当一个任务强制要求发送一个新的请求体流到远程服务器时被调用。同时被NSURLSessionTaskDelegate的方法URLSession:task:needNewBodyStream:调用。
参数
block
一个块对象,当一个任务强制邀请一个新的请求体流时被调用。
声明处
AFURLSessionManager.h
setTaskWillPerformHTTPRedirectionBlock:
- (void)setTaskWillPerformHTTPRedirectionBlock:(nullable NSURLRequest *( ^ ) ( NSURLSession *session , NSURLSessionTask *task , NSURLResponse *response , NSURLRequest *request ))block
讨论
设置一个块,当一个HTTP请求企图执行一个重定向的不同的URL时被调用。同时被NSURLSessionTaskDelegate的方法URLSession:willPerformHTTPRedirection:newRequest:completionHandler:调用。
参数
block
一个块对象,当一个HTTP请求企图执行一个重定向的不同的URL时被执行。这个块返回重定向生成的请求,有4个参数:会话,任务,重定向响应,与重定向响应相对应的请求。
声明处
AFURlSessionManager.h
uploadProgressForTask:
- (nullable NSProgress *)uploadProgressForTask:(NSURLSessionTask *)task
讨论
返回指定任务的上传进度。
参数
task
会话任务。必须不能为nil。
返回值
一个NSProgress对象报告任务的上传进度,如果进度无效则为nil。
声明处
AFURLSessionManager.h
uploadTaskWithRequest:fromData:progress: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
讨论
为HTTP体根据制动请求创建一个NSURlSessionUploadTask对象。
参数
request
请求的HTTP请求。
bodyData
一个数据对象包含上传的HTTP体内容。
uploadProgressBlock
一个块对象,在上传进度更新时被执行。注意这个块在是会话队列中被调用,不是在主队列。
completionHandler
一个块对象在任务完成时被执行。这个块没有返回值,有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
uploadTaskWithRequest:fromFile:progeress:completionHandler:
- (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对象。
参数
request
请求的HTTP请求。
fileURL
用来上传文件的URL。
uploadProgressBlock
一个块对象,在上传进度更新时被执行。注意这个块在是会话队列中被调用,不是在主队列。
completionHandler
一个块对象在任务完成时被执行。这个块没有返回值,有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
uploadTaskWithStreameRequest:progress:completionhandler:
- (NSURLSessionUploadTask *)uploadTaskWithStreamedRequest:(NSURLRequest *)request progress:(nullable void ( ^ ) ( NSProgress *uploadProgress ))uploadProgressBlock completionHandler:(nullable void ( ^ ) ( NSURLResponse *response , id _Nullable responseObject , NSError *_Nullable error ))completionHandler
讨论
根据指定流请求创建一个NSURLSessionUploadTask对象。
参数
request
请求的HTTP请求。
uploadProgressBlock
一个块对象,在上传进度更新时被执行。注意这个块在是会话队列中被调用,不是在主队列。
completionHandler
一个块对象在任务完成时被执行。这个块没有返回值,有3个参数:服务器响应,序列化创建的响应对象,发生的任何错误。
声明处
AFURLSessionManager.h
// END 呵呵哒 这个Manager真的是够长了,从开始到结束一共用了快一个月时间才翻译好。