当前位置： 代码迷 >> 综合 >> Android-Universal-Image-Loader源码分析
  详细解决方案

Android-Universal-Image-Loader源码分析

热度：98   发布时间：2023-09-05 17:40:43.0

前言

ImageLoader 是 android 使用中出现比较早（PS：即的刚接触安卓项目的时候就用的是这个图片加载图，算算已经快5年了），使用最多的一个开源图片加载库了。随着glide , fresco 和 picasso等图片加载的库出现，ImageLoader使用变得越来越少。最近在看其他图片加载库的源码，顺便补补之前错过的一些事情。

代码仓库地址：Android-Universal-Image-Loader

ImageLoader

Android-Universal-Image-Loader源码分析

这个是 ImageLoader 的架构，ImageLader 图片加载库的主要组成部分都包括在其中。

下边这幅图对应的是，组成上面架构的每个部分的对应的类实现：

Android-Universal-Image-Loader源码分析

  • ImageLoader ：为ImageView 下载和展示图片的单例；
  • DisplayImageOptions : 图片展示的配置项（加载中、空url、加载失败默认图等）；
  • ImageLoaderConfiguration : ImageLoader 的配置项；
  • ImageAware ：表示图像感知视图，该视图提供了图像处理和显示所需的所有属性和行为；
  • ImageLoadingListener ：监听图片加载进度，开始、失败、成功、取消；
  • ImageLoaderEngine ：执行图片下载和展现任务；
  • BitmapDisplayer ：展现 Bitmap 在 ImageView 上的时候可以修改这个 Bitmap 或添加展示的动画效果；
  • BitmapProcessor ：可以处理原始的Bitmap ；
  • MemoryCache ： Bitmap 内存缓存接口；
  • DiskCache ：磁盘缓存；
  • ImageDecoder ：根据ImageDecodingInfo信息得到图片并根据参数将其转换为 Bitmap。
  • ImageDownloader ：通过URI 获取图片；
  • DisplayBitmapTask ：展示图片并进行回调；
  • ProcessAndDisplayImageTask ：处理图片和展现图片的任务，用于加载内存缓存中的图片；
  • LoadAndDisplayImagTask ：处理加载和显示图像的任务，用于从Internet或文件系统加载图像为 Bitmap；

Config配置

初始化配置参数，参数configuration为ImageLoader的配置信息，包括图片最大尺寸、任务线程池、磁盘缓存、下载器、解码器等等。

ImageLoaderConfiguration{final Resources resources;//上下文环境中的resourcefinal int maxImageWidthForMemoryCache;//内存缓存最大宽度final int maxImageHeightForMemoryCache;//内存缓存最大高度final int maxImageWidthForDiskCache;//磁盘缓存最大宽度final int maxImageHeightForDiskCache;//磁盘缓存最大高度//在将图像保存到磁盘缓存之前先对其进行调整大小/压缩处理final BitmapProcessor processorForDiskCache;final Executor taskExecutor;//自定义图片加载和展现的线程池final Executor taskExecutorForCachedImages;//自定义展现在磁盘上的图片的线程池final boolean customExecutor;//是否自定义下载的线程池final boolean customExecutorForCachedImages;//是否自定义缓存图片的线程池//默认核心线程数和线程池容量为3final int threadPoolSize;//默认的线程优先级低两级final int threadPriority;//LIFO,FIFO;默认为先进先出FIFOfinal QueueProcessingType tasksProcessingType;//内存缓存，默认为MemoryClass的八分之一，3.0之后为LargeMemoryClass的八分之一//如果开启denyCacheImageMultipleSizesInMemory，那么缓存为FuzzyKeyMemoryCache实例，只判断图片地址不判断大小，如果相同那么刷新缓存final MemoryCache memoryCache;//LruDiskCache，大小默认存储为Long.MAX_VALUE，默认最大数量为Long.MAX_VALUE;final DiskCache diskCache;//通过URI从网络或文件系统或应用程序资源中检索图像final ImageDownloader downloader;//将图像解码为Bitmap，将其缩放到所需大小final ImageDecoder decoder;//包含图像显示选项(默认图设置以及其他默认选项)final DisplayImageOptions defaultDisplayImageOptions;//网络禁止下载器，一般不直接应用final ImageDownloader networkDeniedDownloader;//在慢速网络上处理下载final ImageDownloader slowNetworkDownloader;
}

还有一个对于某个ImageView 进行展示设置的 DisplayImageOptions ，配置图片显示的配置项。比如加载前、加载中、加载失败应该显示的占位图片，图片是否需要在磁盘缓存，是否需要在内存缓存等。

视图

讲视图主要是想让ImageView 与 ImageLoader 联系在一起来，ImageLoader 通过 ImageAware 接口实现图片在视图上的展现。

public interface ImageAware {int getWidth();int getHeight();ViewScaleType getScaleType();View getWrappedView();boolean isCollected();int getId();boolean setImageDrawable(Drawable drawable);boolean setImageBitmap(Bitmap bitmap);
}
  • ImageAware->ViewAware
  • ImageAware->ViewAware->ImageViewAware
  • ImageAware->NonViewAware

其中 ViewAware 是抽象类，所以 ImageAware 只有 ImageViewAware 和 NonViewAware 两个实现类。

NonViewAware 提供处理原始图像所需的信息，但不显示图像。当用户只需要加载和解码图像的时候可以使用它。

加载回调

主要进行图片加载过程中的事件监听。

public interface ImageLoadingListener {//开始加载void onLoadingStarted(String imageUri, View view);//加载失败void onLoadingFailed(String imageUri, View view, FailReason failReason);//加载完成void onLoadingComplete(String imageUri, View view, Bitmap loadedImage);//取消加载void onLoadingCancelled(String imageUri, View view);
}

图片展示

在ImageAware中显示bitmap 对象的接口。可在实现中对 bitmap 做一些额外处理，比如加圆角、动画效果。

默认的BitmapDisplay 是 SimpleBitmapDisplayer 仅仅实现了加载图片的功能，ImageLoader 还提供了CircleBitmapDisplayer 、FadeInBitmapDisplayer 和 RoundedBitmapDisplayer 等其他的实现。

public interface BitmapDisplayer {void display(Bitmap bitmap, ImageAware imageAware, LoadedFrom loadedFrom);
}
public final class SimpleBitmapDisplayer implements BitmapDisplayer {@Overridepublic void display(Bitmap bitmap, ImageAware imageAware, LoadedFrom loadedFrom) {imageAware.setImageBitmap(bitmap);}
}

位图处理

图片处理接口。可用于对图片预处理(Pre-process)和后处理(Post-process )，这两个处理器的配置都是在DisplayImageOptions 进行设置。其中预处理是在图片获取完缓存之前处理，后端处理是指在展示前的处理。

public interface BitmapProcessor {Bitmap process(Bitmap bitmap);
}

内存缓存

内存缓存的是Bitmap ，默认的缓存容器是LruMemoryCache 。内存缓存的Bitmap 都是通过数据流解码生成的。

public interface MemoryCache {boolean put(String key, Bitmap value);Bitmap get(String key);Bitmap remove(String key);Collection<String> keys();void clear();
}
public static MemoryCache createMemoryCache(Context context, int memoryCacheSize) {if (memoryCacheSize == 0) {ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);int memoryClass = am.getMemoryClass();if (hasHoneycomb() && isLargeHeap(context)) {memoryClass = getLargeMemoryClass(am);}memoryCacheSize = 1024 * 1024 * memoryClass / 8;}return new LruMemoryCache(memoryCacheSize);
}

LruMemoryCache 是区分size的，如果ImageLoaderConfiguration 设置 denyCacheImageMultipleSizesInMemory 那么缓存为 FuzzyKeyMemoryCache 实例，只判断图片地址不判断大小，如果相同那么刷新缓存。 FuzzyKeyMemoryCache 只是重写了MemoryCache 的 put 方法。

图片解码器

根据ImageDecodingInfo信息得到图片并根据参数将其转换为 Bitmap 。

public interface ImageDecoder {Bitmap decode(ImageDecodingInfo imageDecodingInfo) throws IOException;
}
public static ImageDecoder createImageDecoder(boolean loggingEnabled) {return new BaseImageDecoder(loggingEnabled);
}

BaseImageDecoder 是ImageLoaderConfiguration默认的解码器。

public class BaseImageDecoder implements ImageDecoder {@Overridepublic Bitmap decode(ImageDecodingInfo decodingInfo) throws IOException {Bitmap decodedBitmap;ImageFileInfo imageInfo;//通过ImageDecodingInfo中的信息获取数据流，图片下载器部分会讲怎么获取数据流InputStream imageStream = getImageStream(decodingInfo);if (imageStream == null) {L.e(ERROR_NO_IMAGE_STREAM, decodingInfo.getImageKey());return null;}try {//确定图片尺寸和旋转角度，生成图片文件信息imageInfo = defineImageSizeAndRotation(imageStream, decodingInfo);//数据流的游标重置imageStream = resetStream(imageStream, decodingInfo);//生成控制Bitmap进行采样的OptionOptions decodingOptions = prepareDecodingOptions(imageInfo.imageSize, decodingInfo);//将输入流解码为位图decodedBitmap = BitmapFactory.decodeStream(imageStream, null, decodingOptions);} finally {IoUtils.closeSilently(imageStream);}if (decodedBitmap == null) {L.e(ERROR_CANT_DECODE_IMAGE, decodingInfo.getImageKey());} else {//对Bitmmap进行缩放和旋转decodedBitmap = considerExactScaleAndOrientatiton(decodedBitmap, decodingInfo, imageInfo.exif.rotation,imageInfo.exif.flipHorizontal);}return decodedBitmap;}/****部分代码省略***/
}

磁盘缓存

本地图片缓存，可向本地磁盘缓存保存图片或从本地磁盘读取图片。LruDiskCache是ImageLoaderConfiguration默认的磁盘缓存容器。这次缓存的图片文件都是通过InputStream 保存在磁盘上的，实现是通过调用 save 方法。

public interface DiskCache {File getDirectory();File get(String imageUri);boolean save(String imageUri, InputStream imageStream, IoUtils.CopyListener listener) throws IOException;boolean save(String imageUri, Bitmap bitmap) throws IOException;boolean remove(String imageUri);void close();void clear();
}
public static DiskCache createDiskCache(Context context, FileNameGenerator diskCacheFileNameGenerator,long diskCacheSize, int diskCacheFileCount) {File reserveCacheDir = createReserveDiskCacheDir(context);if (diskCacheSize > 0 || diskCacheFileCount > 0) {///Android/data/[app_package_name]/cache/uil-imagesFile individualCacheDir = StorageUtils.getIndividualCacheDirectory(context);try {//缓存目录，缓存大小，缓存数量，缓存文件名生成器都不能为空return new LruDiskCache(individualCacheDir, reserveCacheDir, diskCacheFileNameGenerator, diskCacheSize,diskCacheFileCount);} catch (IOException e) {L.e(e);// continue and create unlimited cache}}File cacheDir = StorageUtils.getCacheDirectory(context);//UnlimitedDiskCache大小没有限制return new UnlimitedDiskCache(cacheDir, reserveCacheDir, diskCacheFileNameGenerator);
}

网络下载

获取Uri 对应的 Stream , extra 为辅助的下载器，可以通过DisplayImageOptions 得到extraForDownloader 。下载主要有http 、https 、file 、content 、assets 和 drawable 。

public interface ImageDownloader {InputStream getStream(String imageUri, Object extra) throws IOException;/** Represents supported schemes(protocols) of URI. Provides convenient methods for work with schemes and URIs. */public enum Scheme {HTTP("http"), HTTPS("https"), FILE("file"), CONTENT("content"), ASSETS("assets"), DRAWABLE("drawable"), UNKNOWN("");private String scheme;private String uriPrefix;Scheme(String scheme) {this.scheme = scheme;uriPrefix = scheme + "://";}/***部分代码省略***/}
}

BaseImageDownloader 为默认的下载器：内部通过下载资源的类型的不同有着不同的实现。

public class BaseImageDownloader implements ImageDownloader {@Overridepublic InputStream getStream(String imageUri, Object extra) throws IOException {switch (Scheme.ofUri(imageUri)) {case HTTP:case HTTPS:return getStreamFromNetwork(imageUri, extra);case FILE:return getStreamFromFile(imageUri, extra);case CONTENT:return getStreamFromContent(imageUri, extra);case ASSETS:return getStreamFromAssets(imageUri, extra);case DRAWABLE:return getStreamFromDrawable(imageUri, extra);case UNKNOWN:default:return getStreamFromOtherSource(imageUri, extra);}}/***部分代码省略***/
}

看一个从网络请求中获取Stream 的实现：

public class BaseImageDownloader implements ImageDownloader {protected InputStream getStreamFromNetwork(String imageUri, Object extra) throws IOException {//根据imageUri，创建HttpURLConnection对象HttpURLConnection conn = createConnection(imageUri, extra);int redirectCount = 0;//最多重定向请求5次while (conn.getResponseCode() / 100 == 3 && redirectCount < MAX_REDIRECT_COUNT) {conn = createConnection(conn.getHeaderField("Location"), extra);redirectCount++;}InputStream imageStream;try {imageStream = conn.getInputStream();} catch (IOException e) {// Read all data to allow reuse connection (http://bit.ly/1ad35PY)IoUtils.readAndCloseStream(conn.getErrorStream());throw e;}//如果responseCode不是200那么关闭请求抛出IO异常if (!shouldBeProcessed(conn)) {IoUtils.closeSilently(imageStream);throw new IOException("Image request failed with response code " + conn.getResponseCode());}return new ContentLengthInputStream(new BufferedInputStream(imageStream, BUFFER_SIZE), conn.getContentLength());}
}

ImageLoader

讲完了组成的ImageLoader 的一整套图片加载流程的没个部分：网络下载、磁盘缓存、数据解码、内存缓存、位图处理、图片展示和业务回调。下面我们看看ImageLoader是怎么将这些部分是怎么串在一起的。

使用双重校验锁（DCL：double-checked locking）实现单例操作 Java版的7种单例模式。

public class ImageLoader {private ImageLoaderConfiguration configuration;//图片加载配置信息private ImageLoaderEngine engine;//图片加载引擎private ImageLoadingListener defaultListener = new SimpleImageLoadingListener();//默认的回调监听private volatile static ImageLoader instance;//单例/** Returns singleton class instance */public static ImageLoader getInstance() {if (instance == null) {synchronized (ImageLoader.class) {if (instance == null) {instance = new ImageLoader();}}}return instance;}//初始化方法public synchronized void init(ImageLoaderConfiguration configuration) {if (configuration == null) {throw new IllegalArgumentException(ERROR_INIT_CONFIG_WITH_NULL);}if (this.configuration == null) {L.d(LOG_INIT_CONFIG);engine = new ImageLoaderEngine(configuration);this.configuration = configuration;} else {L.w(WARNING_RE_INIT_CONFIG);}}/***其他代码省略***/
}

上面代码是 ImageLoader 的构造初始化方法，接下分析它加载图片时候的调用：

public class ImageLoader {public void displayImage(String uri, ImageView imageView) {displayImage(uri, new ImageViewAware(imageView), null, null, null);}//最终加载图片的方法public void displayImage(String uri, ImageAware imageAware, DisplayImageOptions options,ImageSize targetSize, ImageLoadingListener listener, ImageLoadingProgressListener progressListener) {//校验配置是否为空checkConfiguration();if (imageAware == null) {throw new IllegalArgumentException(ERROR_WRONG_ARGUMENTS);}//添加默认的空回调if (listener == null) {listener = defaultListener;}//添加默认的图片展示配置if (options == null) {options = configuration.defaultDisplayImageOptions;}//下载地址为空if (TextUtils.isEmpty(uri)) {engine.cancelDisplayTaskFor(imageAware);//取消对于当前imageAware的展示任务listener.onLoadingStarted(uri, imageAware.getWrappedView());//回调展示开始//展示配置中有处理为空的url的默认图if (options.shouldShowImageForEmptyUri()) {//给imageAware设置这个默认图imageAware.setImageDrawable(options.getImageForEmptyUri(configuration.resources));} else {imageAware.setImageDrawable(null);}listener.onLoadingComplete(uri, imageAware.getWrappedView(), null);//回调展示结束return;}//获取当前需要下载的图片的sizeif (targetSize == null) {targetSize = ImageSizeUtils.defineTargetSizeForView(imageAware, configuration.getMaxImageSize());}//获取内存缓存的key(url_width_height)String memoryCacheKey = MemoryCacheUtils.generateKey(uri, targetSize);//添加到执行引擎cacheKeysForImageAwares的容器中engine.prepareDisplayTaskFor(imageAware, memoryCacheKey);listener.onLoadingStarted(uri, imageAware.getWrappedView());//回调展示开始//从内存中获取缓存的memoryCacheKey对应的bitmapBitmap bmp = configuration.memoryCache.get(memoryCacheKey);//bitmap不为空，而且没有被回收if (bmp != null && !bmp.isRecycled()) {L.d(LOG_LOAD_IMAGE_FROM_MEMORY_CACHE, memoryCacheKey);//如果需要展示加载的进度，默认是不设置BitmapProcessor处理器的if (options.shouldPostProcess()) {//构造图片加载信息ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey,options, listener, progressListener, engine.getLockForUri(uri));//构造处理展示图片的任务ProcessAndDisplayImageTask displayTask = new ProcessAndDisplayImageTask(engine, bmp, imageLoadingInfo,defineHandler(options));//如果需要同步加载if (options.isSyncLoading()) {displayTask.run();//直接进行展现任务} else {engine.submit(displayTask);//提交任务到加载引擎中}} else {//从内存中加载bitmap设置给imageAware，options.getDisplayer().display(bmp, imageAware, LoadedFrom.MEMORY_CACHE);//回调加载完成listener.onLoadingComplete(uri, imageAware.getWrappedView(), bmp);}} else {//如果需要展示加载的进度if (options.shouldShowImageOnLoading()) {//展示默认的加载中的图片imageAware.setImageDrawable(options.getImageOnLoading(configuration.resources));} else if (options.isResetViewBeforeLoading()) {imageAware.setImageDrawable(null);}//构造图片加载信息ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey,options, listener, progressListener, engine.getLockForUri(uri));//构造加载展示图片的任务LoadAndDisplayImageTask displayTask = new LoadAndDisplayImageTask(engine, imageLoadingInfo,defineHandler(options));//如果需要同步加载if (options.isSyncLoading()) {displayTask.run();//直接进行展现任务} else {engine.submit(displayTask);//提交任务到加载引擎中}}}/***其他代码省略***/
}

Imageloader图片加载流程叙述：

  1. 校验配置；
  2. 赋值默认值（回调监听、图片展现配置）；
  3. 判断下载地址为空；
    3.1. 取消当前imageAware的图片展示任务；
    3.2. 如果图片展示配置有url为空的默认处理图那么加载默认图；
  4. 获取当前需要加载图的size；
  5. 获取缓存的key
    5.1. 根据key从内存缓存中获取bitmap，且bitmap有效；
    5.1.1. 如果需要展现加载进度，那么构造处理图片展示任务（ProcessAndDisplayImageTask）并执行（如果展现需要同步那么直接展示，否则任务提交到线程池）；
    5.1.2. 否则直接加载bitmap给当前的imageAware；
    5.2. 如果需要展现加载进度，那么获取图片展示配置中的加载状态资源进行展示，准备下一步加载真实图片资源；
    5.2.1. 构造加载展示图片任务（LoadAndDisplayImageTask）并执行（如果展现需要同步那么直接展示，否则任务提交到线程池）；

图片加载引擎

虽然叫做图片加载引起，但其实它仅仅只是一个任务分发处理器，负责分发LoadAndDisplayImageTask和ProcessAndDisplayImageTask给具体的线程池去执行，以及任务的暂停等操作。

class ImageLoaderEngine {final ImageLoaderConfiguration configuration;//图片加载配置信息private Executor taskExecutor;//configuration.taskExecutorprivate Executor taskExecutorForCachedImages;//configuration.taskExecutorForCachedImagesprivate Executor taskDistributor;//分配任务的线程池为newCachedThreadPool//imageview的hashcode和下载的key(url_width_height)private final Map<Integer, String> cacheKeysForImageAwares = Collections.synchronizedMap(new HashMap<Integer, String>());private final Map<String, ReentrantLock> uriLocks = new WeakHashMap<String, ReentrantLock>();private final AtomicBoolean paused = new AtomicBoolean(false);private final AtomicBoolean networkDenied = new AtomicBoolean(false);private final AtomicBoolean slowNetwork = new AtomicBoolean(false); private final Object pauseLock = new Object();ImageLoaderEngine(ImageLoaderConfiguration configuration) {this.configuration = configuration;taskExecutor = configuration.taskExecutor;taskExecutorForCachedImages = configuration.taskExecutorForCachedImages;taskDistributor = DefaultConfigurationFactory.createTaskDistributor();}/***其他代码省略***/
}

任务提交处理，主要做了不同类型的任务分发给对应的任务执行的线程池：

class ImageLoaderEngine {/** Submits task to execution pool *///执行从磁盘获取和网络上加载图片的任务void submit(final LoadAndDisplayImageTask task) {taskDistributor.execute(new Runnable() {@Overridepublic void run() {File image = configuration.diskCache.get(task.getLoadingUri());//是否已经缓存在磁盘上boolean isImageCachedOnDisk = image != null && image.exists();initExecutorsIfNeed();if (isImageCachedOnDisk) {taskExecutorForCachedImages.execute(task);} else {taskExecutor.execute(task);}}});}/** Submits task to execution pool *///支持从缓存中加载图片的任务void submit(ProcessAndDisplayImageTask task) {initExecutorsIfNeed();taskExecutorForCachedImages.execute(task);}//任务线程池是否关闭，关闭则重新创建private void initExecutorsIfNeed() {if (!configuration.customExecutor && ((ExecutorService) taskExecutor).isShutdown()) {taskExecutor = createTaskExecutor();}if (!configuration.customExecutorForCachedImages && ((ExecutorService) taskExecutorForCachedImages).isShutdown()) {taskExecutorForCachedImages = createTaskExecutor();}}//创建任务线程池private Executor createTaskExecutor() {return DefaultConfigurationFactory.createExecutor(configuration.threadPoolSize, configuration.threadPriority,configuration.tasksProcessingType);}/***其他代码省略***/
}

从ImageLoader 的displayImage 方法实现和 ImageLoaderEngine 的任务分发可以看出来，ImageLoader 主要有两种类型的任务 ProcessAndDisplayImageTask 和 LoadAndDisplayImageTask 。

处理和展示图片任务

final class ProcessAndDisplayImageTask implements Runnable {/***部分代码省略***/@Overridepublic void run() {L.d(LOG_POSTPROCESS_IMAGE, imageLoadingInfo.memoryCacheKey);//获取图片展现配置中的图片处理器BitmapProcessor processor = imageLoadingInfo.options.getPostProcessor();//获取处理过后的BiamtpBitmap processedBitmap = processor.process(bitmap); DisplayBitmapTask displayBitmapTask = new DisplayBitmapTask(processedBitmap, imageLoadingInfo, engine,LoadedFrom.MEMORY_CACHE);//如果isSyncLoading那么调用displayBitmapTask的run方法，否则如果handler不为空切换到主线程执行displayBitmapTask.runLoadAndDisplayImageTask.runTask(displayBitmapTask, imageLoadingInfo.options.isSyncLoading(), handler, engine);}
}

加载和展示图片任务

先看LoadAndDisplayImageTask.runTask 方法：

static void runTask(Runnable r, boolean sync, Handler handler, ImageLoaderEngine engine) {if (sync) {//如果需要同步那么在当前线程执行r.run();} else if (handler == null) {//handler为空切换线程到taskDistributor线程池中执行engine.fireCallback(r);} else {handler.post(r);//切换到handler主线程执行}
}

run

final class LoadAndDisplayImageTask implements Runnable, IoUtils.CopyListener {/***部分代码省略***/@Overridepublic void run() {//如果ImageLoader暂停执行任务（ImageLoader.pause方法被调用），那么当前线程进入等待被唤醒（ImageLoader.resume方法被调用）；//否则校验当前任务是否有效（校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uri）if (waitIfPaused()) return;//是否需要延迟加载（图片展示配置中如果delayBeforeLoading时间大于0）////否则校验当前任务是否有效（校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uri）if (delayIfNeed()) return;//获取当前图片加载任务的锁ReentrantLock loadFromUriLock = imageLoadingInfo.loadFromUriLock;L.d(LOG_START_DISPLAY_IMAGE_TASK, memoryCacheKey);if (loadFromUriLock.isLocked()) {L.d(LOG_WAITING_FOR_IMAGE_LOADED, memoryCacheKey);}loadFromUriLock.lock();Bitmap bmp;try {//校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uricheckTaskNotActual();//先从内存缓存中获取对应的Bitmapbmp = configuration.memoryCache.get(memoryCacheKey);//如果bitmap被回收或者为空if (bmp == null || bmp.isRecycled()) {//尝试加载Bitmap（磁盘、资源、网络等）bmp = tryLoadBitmap();//加载失败直接返回if (bmp == null) return; // listener callback already was fired//校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uricheckTaskNotActual();//检验是否当前线程被打断checkTaskInterrupted();//根据图片展示配置项是否要进行保存前处理if (options.shouldPreProcess()) {L.d(LOG_PREPROCESS_IMAGE, memoryCacheKey);bmp = options.getPreProcessor().process(bmp);if (bmp == null) {L.e(ERROR_PRE_PROCESSOR_NULL, memoryCacheKey);}}//是否需要对这个Bitmap进行内存缓存if (bmp != null && options.isCacheInMemory()) {L.d(LOG_CACHE_IMAGE_IN_MEMORY, memoryCacheKey);configuration.memoryCache.put(memoryCacheKey, bmp);}} else {loadedFrom = LoadedFrom.MEMORY_CACHE;L.d(LOG_GET_IMAGE_FROM_MEMORY_CACHE_AFTER_WAITING, memoryCacheKey);}//根据图片展示配置项是否要进行展示前处理if (bmp != null && options.shouldPostProcess()) {L.d(LOG_POSTPROCESS_IMAGE, memoryCacheKey);bmp = options.getPostProcessor().process(bmp);if (bmp == null) {L.e(ERROR_POST_PROCESSOR_NULL, memoryCacheKey);}}//校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uricheckTaskNotActual();//检验是否当前线程被打断checkTaskInterrupted();} catch (TaskCancelledException e) {//进行失败处理fireCancelEvent();return;} finally {//释放锁loadFromUriLock.unlock();}//执行展示图片任务此处和ProcessAndDisplayImageTask任务后的展示逻辑相同DisplayBitmapTask displayBitmapTask = new DisplayBitmapTask(bmp, imageLoadingInfo, engine, loadedFrom);runTask(displayBitmapTask, syncLoading, handler, engine);}/***部分代码省略***/
}

任务是否有效：校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uri(被取消或者被代替)。

  1. 校验ImageLoader是否暂停执行任务和当前的任务是否有效；
  2. 是否需要进行延迟加载，延迟加载后校验当前是否任务有效；
  3. 获取当前图片加载任务的锁进行上锁；
  4. 校验当前是否任务有效后开始进行Bitmap获取；
    4.1 先从内存缓存中获取对应的Bitmap；
    4.2 获取Bitmap 为空获取已经被回收那么尝试加载Bitmap;
    4.2.1 Bitmap加载失败直接返回；
    4.2.2 校验当前是否任务有效；
    4.2.3 检验是否当前线程被打断；
    4.2.4 根据图片展示配置项是否要进行保存前处理；
    4.2.5 是否需要对这个Bitmap进行内存缓存;
    4.3 根据图片展示配置项是否要进行展示前处理
    4.4 校验当前是否任务有效；
    4.5 检验是否当前线程被打断；
  5. 释放锁;
  6. 执行展示图片任务;

加载图片

final class LoadAndDisplayImageTask implements Runnable, IoUtils.CopyListener {/***部分代码省略***/private Bitmap tryLoadBitmap() throws TaskCancelledException {Bitmap bitmap = null;try {File imageFile = configuration.diskCache.get(uri);//从磁盘获取存储的图片if (imageFile != null && imageFile.exists() && imageFile.length() > 0) {L.d(LOG_LOAD_IMAGE_FROM_DISK_CACHE, memoryCacheKey);loadedFrom = LoadedFrom.DISC_CACHE;//校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uricheckTaskNotActual();bitmap = decodeImage(Scheme.FILE.wrap(imageFile.getAbsolutePath()));//进行图片解码}//bitmap为空，或者长宽小于0重新进行数据获取if (bitmap == null || bitmap.getWidth() <= 0 || bitmap.getHeight() <= 0) {L.d(LOG_LOAD_IMAGE_FROM_NETWORK, memoryCacheKey);loadedFrom = LoadedFrom.NETWORK;String imageUriForDecoding = uri;//是否需要缓存在磁盘上，如果需要进行磁盘缓存if (options.isCacheOnDisk() && tryCacheImageOnDisk()) {imageFile = configuration.diskCache.get(uri);if (imageFile != null) {imageUriForDecoding = Scheme.FILE.wrap(imageFile.getAbsolutePath());}}//校验目标ImageAware是否已经被回收，或者ImageAware需要加载的uri已经不是当前的uricheckTaskNotActual();bitmap = decodeImage(imageUriForDecoding);//进行图片解码//bitmap为空，或者长宽小于0进行异常处理if (bitmap == null || bitmap.getWidth() <= 0 || bitmap.getHeight() <= 0) {fireFailEvent(FailType.DECODING_ERROR, null);}}} catch (）{/***异常处理省略***/}return bitmap;}/***部分代码省略***/
}

缓存图片到磁盘

final class LoadAndDisplayImageTask implements Runnable, IoUtils.CopyListener {/***部分代码省略***/private boolean tryCacheImageOnDisk() throws TaskCancelledException {L.d(LOG_CACHE_IMAGE_ON_DISK, memoryCacheKey);boolean loaded;try {loaded = downloadImage();//下载图片，缓存到磁盘if (loaded) {int width = configuration.maxImageWidthForDiskCache;int height = configuration.maxImageHeightForDiskCache;if (width > 0 || height > 0) {L.d(LOG_RESIZE_CACHED_IMAGE_FILE, memoryCacheKey);//设置图片的大小，重新保存到磁盘resizeAndSaveImage(width, height); // TODO : process boolean result}}} catch (IOException e) {L.e(e);loaded = false;}return loaded;}private boolean downloadImage() throws IOException {//通过download获取数据流InputStream is = getDownloader().getStream(uri, options.getExtraForDownloader());if (is == null) {L.e(ERROR_NO_IMAGE_STREAM, memoryCacheKey);return false;} else {try {//保存到磁盘return configuration.diskCache.save(uri, is, this);} finally {IoUtils.closeSilently(is);}}}/***部分代码省略***/
}

其他

  • 取消当前imageview对应的任务
public void cancelDisplayTask(ImageView imageView) {engine.cancelDisplayTaskFor(new ImageViewAware(imageView));
}
  • 拒绝或允许ImageLoader从网络下载图像
public void denyNetworkDownloads(boolean denyNetworkDownloads) {engine.denyNetworkDownloads(denyNetworkDownloads);
}
  • 设置ImageLoader是否使用FlushedInputStream进行网络下载的选项
public void handleSlowNetwork(boolean handleSlowNetwork) {engine.handleSlowNetwork(handleSlowNetwork);
}
  • 暂停ImageLoader。在ImageLoader#resume恢复之前，不会执行所有新的“加载和显示”任务。
  • 已经运行的任务不会暂停。
public void pause() {engine.pause();
}
  • 恢复等待的“加载和显示”任务
public void resume() {engine.resume();
}
  • 取消所有正在运行和计划的显示图像任务
  • 还可以继续使用ImageLoader
public void stop() {engine.stop();
}
  • 取消所有正在运行和计划的显示图像任务
  • 销毁所有配置，重新使用ImageLoader需要进行初始化
public void destroy() {if (configuration != null) L.d(LOG_DESTROY);stop();configuration.diskCache.close();engine = null;configuration = null;
}
  • 为了更友好的用户体验，在列表滑动过程中可以暂停加载（调用pause和resume）；
  • RGB_565代替ARGB_8888，减少占用内存；
  • 使用memoryCache(new WeakMemoryCache()) 将内存中的Bitmap 变为软引用；

文章到这里就全部讲述完啦，若有其他需要交流的可以留言哦！！

想阅读作者的更多文章，可以查看我 个人博客 和公共号：

Android-Universal-Image-Loader源码分析

  相关解决方案

代码迷 - 您身边的软件异常，代码异常，编程异常助手（发现，解决，分享）
Copyright © 2009-2013 DAIMAMI.COM. All rights reserved.