---

声明处：UIImageView+AFNetworking.h

---

概述

这个扩展在UIKit库的UIImageView类中添加了方法。扩展中的方法提供从URL异步加载远程图片。

任务

获取图片下载器

• + setSharedImageDownloader:
• + sharedImageDownloader

设置图片

• - setImageWithURL:
• - setImageWithURL:placeholderImage:
• - setImageWithURLRequest:placeholderImage:success:failure:
• - cancelImageDownloader

类方法

setSharedImageDownloader:

+ (void)setSharedImageDownloader:(AFImageDownloader *)imageDownloader

讨论

设置用来下载图片的共享图片下载器。

参数

imageDownloader

用来下载图片的共享图片下载器。

声明处

UIImageView+AFNetworking.h

sharedImageDownloader

+ (AFImageDownloader *)sharedImageDownloader

讨论

用来下载图片的共享图片下载器。

声明处

UIImageView+AFNetworking.h

实例方法

cancelImageDownloadTask

- (void)cancelImageDownloadTask

讨论

取消接受者所有正在执行的图片操作，如果有存在的话。

声明处

UIImageView+AFNetworking.h

setImageWithURL:

- (void)setImageWithURL:(NSURL *)url

讨论

从指定的URL异步下载一张图片，当请求已经完成时设置这张图片。任何之前的用来接收背景图的请求都会被取消。

如果图片已经在本地缓存，图片将立即设置，否则指定的占位背景图将立即设置，此时一旦请求完成，远程的图片将设置。

默认情况下，URL请求有一个接受头域“image/*”的值，一个缓存协议NSURLCacheStorageAllowed和一个30秒的超时，设置一个没有句柄的cookie。配置不同的URL请求，使用setImageWithURLRequest:placeholderImage:success:failure。

参数

url

用于图片请求的URL。

placeholderImage

初始设置的图片，直到图片请求完成。如果为nil，图片视图将不会改变它的图片直到图片请求完成。

声明处

UIImageView+AFNetworking.h

setImageWithURLRequest:placeholderImage:success:failure:

- (void)setImageWithURLRequest:(NSURLRequest *)urlRequest placeholderImage:(nullable UIImage *)placeholderImage success:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , UIImage *image ))success failure:(nullable void ( ^ ) ( NSURLRequest *request , NSHTTPURLResponse *_Nullable response , NSError *error ))failure

讨论

从指定的URL异步下载一张图片，当请求已经完成时设置这张图片。任何之前的用来接收背景图的请求都会被取消。

如果图片已经在本地缓存，图片将立即设置，否则指定的占位背景图将立即设置，此时一旦请求完成，远程的图片将设置。

如果指定了一个成功的块，在返回之前块的责任是设置图片视图的图片。如果没有指定成功块，提供了self.image = image的默认方式来设置图片。

参数

urlRequest

用于图片请求的URL请求。

placeholderImage

初始设置的图片，直到图片请求完成。如果为nil，图片视图将不会改变它的图片直到图片请求完成。

success

一个块当图片数据任务成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接受到响应，从请求的响应数据创建的图片。如果图片是从缓存中返回，那么响应参数为nil。

failure

一个块当图片数据任务成功或不成功完成时被执行。这个块没有返回值，有3个参数：客户端发送的请求，从服务器接受到响应，描述发生的网络或解析错误的错误对象。

声明处

UIImageView+AFNetworking.h

// END 昨天定了新车，但是不会还价，高了3k。人生还是需要认识各行各业的熟人啊。