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真的是够长了，从开始到结束一共用了快一个月时间才翻译好。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 194,242评论 5赞 459
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 81,769评论 2赞 371
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 141,484评论 0赞 319
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 52,133评论 1赞 263
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 61,007评论 4赞 355
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 46,080评论 1赞 272
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 36,496评论 3赞 381
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 35,190评论 0赞 253
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 39,464评论 1赞 290
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,549评论 2赞 309
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,330评论 1赞 326
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 32,205评论 3赞 312
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 37,567评论 3赞 298
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,889评论 0赞 17
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,160评论 1赞 250
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 41,475评论 2赞 341
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 40,650评论 2赞 335

推荐阅读更多精彩内容