繼承于： NSObject
聲明處： SDWebImageDownloader.h
概述
為下載圖片提供專用和優化的異步下載器。
任務
-
shouldDecompressImages屬性 -
maxConcurrentDownload屬性 -
currentDownloadCount屬性 -
downloadTimeout屬性 -
sessionConfiguration屬性 -
executionOrder屬性 + sharedDownloader-
urlCredential屬性 -
username屬性 -
password屬性 -
headerFilter屬性 - initWithSessionConfiguration:- setValue:forHTTPHeaderField:- valueForHTTPHeaderField:setOperationClass:– downloadImageWithURL:options:progress:completed:- cancel:setSuspended:cancelAllDownloadscreateNewSessionWithConfiguration:
屬性
currentDownloadCount
@property (readonly, nonatomic) NSUInteger currentDownloadCount
討論
顯示當前仍然需要下載的大小。
聲明處
SDWebImageDownloader.h
downloadTimeout
@property (assign, nonatomic) NSTimeInterval downloadTimeout
討論
下載操作的超時時間（單位為秒）。默認值為：15.0.
聲明處
SDWebImageDownloader.h
executionOrder
@property (assign, nonatomic) SDWebImageDownloaderExecutionOrder executionOrder
討論
修改下載操作的執行順序。默認值為SDWebImageDownloaderFIFOExecutionOrder。
聲明處
SDWebImageDownloader.h
headersFilter
@property (nonatomic, copy, nullable) SDWebImageDownloaderHeadersFilterBlock headersFilter
討論
設置過濾器用來挑選下載圖片的HTTP請求的頭。
這個塊在每個圖片下載請求時被調用，返回在相應的HTTP請求中用于HTTP頭的NSDictionary。
聲明處
SDWebImageDownloader.h
maxConcurrentDownloads
@property (assign, nonatomic) NSInteger maxConcurrentDownloads
討論
最大的并發下載數。
聲明處
SDWebImageDownloader.h
password
@property (strong, nonatomic, nullable) NSString *password
討論
設置密碼。
聲明處
SDWebImageDownloader.h
sessionConfiguration
@property (readonly, nonatomic, nonnull) NSURLSessionConfiguration *sessionConfiguration
討論
NSURLSession內部使用的配置。直接修改這個對象沒有效果。
同見
- createNewSessionWithConfiguration:
聲明處
SDWebImageDownloader.h
shouldDecompressImages
@property (assign, nonatomic) BOOL shouldDecompressImages
討論
解壓已經下載和緩存的圖片可以提高性能，但是會消耗很多的內容。默認為YES。設置為NO，如果你遇到由于大量的消耗內存導致崩潰。
聲明處
SDWebImageDownloader.h
urlCredential
@property (strong, nonatomic, nullable) NSURLCredential *urlCredential
討論
為請求操作設置默認的URL證書。
聲明處
SDWebImageDownloader.h
username
@property (strong, nonatomic, nullable) NSString *username
討論
設置用戶名。
聲明處
SDWebImageDownloader.h
類方法
sharedDownloader
+ (nonnull instancetype)sharedDownloader
討論
單例方法，返回一個共享的實例。
返回值
下載類的全局共享實例。
聲明處
SDWebImageDownloader.h
實例方法
cancel
- (void)cancel:(nullable SDWebImageDownloadToken *)token
討論
取消一個使用downloadImageWithURL:options:progress:completed:生成的在之前隊列中的下載任務。
參數
token
從downloadImageWithRUL:options:progress:completed:獲取的token，應該被取消。
聲明處
SDWebImageDownloader.h
cancelAllDownloads
- (void)cancelAllDownloads
討論
取消隊列中所有下載操作。
聲明處
SDWebImageDownloader.h
createNewSessionWithConfiguration:
- (void)createNewSessionWithConfiguration:(nonnull NSURLSessionConfiguration *)sessionConfiguration
討論
強制SDWebImageDownloader創建和使用一個根據提供的配置初始化的新NSURLSession。注意：所有在隊列中已經存在的下載操作都會被取消。注意：timeoutIntervalForRequest將會被重寫。
參數
sessionConfiguration
為新NSURLSession使用的配置。
聲明處
SDWebImageDownloader.h
downloadImageWithURL:options:progress:completed:
- (nullable SDWebImageDownloadToken *)downloadImageWithURL:(nullable NSURL *)url options:(SDWebImageDownloaderOptions)options progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock completed:(nullable SDWebImageDownloaderCompletedBlock)completedBlock
討論
根據提供的URL創建一個SDWebImageDownloader異步下載實例。
代理在圖片下載完成或發生一個錯誤后被執行。
注意：進度塊在后臺隊列中執行。
參數
url
下載圖片的URL。
options
下載需要使用的選項。
progressBlock
在圖片下載過程中，塊被重復調用。
completedBlock
一旦下載完成就調用塊。如果下載成功，image參數已經設置，如果發生錯誤，error參數設置為這個錯誤信息。如果SDWebImageDownloaderProgressDownload沒有使用，最后的參數總是YES。SDWebImageDownloaderProgressiveDownload選項，在最后一次之前部分圖片對象重復調用塊，finished參數設置為NO。完整圖片對象最后一次調用塊，并設置finished參數為YES。假如發生錯誤，finished參數總是YES。
返回值
一個token（SDWebImageDownloadToken）。這個token可以傳送cancel:來取消下載操作。
聲明處
SDWebImageDownloader.h
initiWithSessionConfiguration:
- (nonnull instancetype)initWithSessionConfiguration:(nullable NSURLSessionConfiguration *)sessionConfiguration
討論
根據指定的會話配置創建一個下載器實例。注意：timeoutIntervalForRequest將會被重寫。
返回值
下載器類的實例。
聲明處
SDWebImageDownloader.h
setOperationClass:
- (void)setOperationClass:(nullable Class)operationClass
討論
設置SDWebImageDownloaderOperation的子類作為默認NSOperation，每次SDWebImage構建一個請求操作去下載一張圖片時被使用。
參數
operationClass
SDWebImageDownloaderOperation的子類設置為默認值。傳送nil將恢復為SDWebImageDownloadOperation。
聲明處
SDWebImageDownloader.h
setSuspended:
- (void)setSuspended:(BOOL)suspended
討論
設置下載隊列的暫停狀態。
聲明處
SDWebImageDownloader.h
setValue:forHTTPHeaderField:
- (void)setValue:(nullable NSString *)value forHTTPHeaderField:(nullable NSString *)field
討論
設置一個HTTP頭的值，追加在每一個下載HTTP請求中。
參數
value
頭域的值。使用nil去移除一個頭。
field
設置的頭域的名稱。
聲明處
SDWebImageDownloader.h
valueForHTTPHeaderField:
- (nullable NSString *)valueForHTTPHeaderField:(nullable NSString *)field
討論
返回指定HTTP頭域的值。
返回值
與頭域相關聯的值。如果沒有一致的頭域則為nil。
聲明處
SDWebImageDownloader.h
// END 今天看了WePhone的創始人自殺的事件，天啊。程序員總結起來就是“簡單卻又膽小的程序員”。這個是外人的終結。我卻無力反駁。
