Android-Universal-Image-Loader最新框架解析

Android-Universal-Image-Loader（对应版本号1.9.4为最新版）

原文作者：顾学武

编辑整理：快码众包

目录

1.个性的ImageLoader配置

1.1.在哪儿配置以及如何配置

2.各式缓存方式任你选择

2.1.DiskCache 磁盘缓存

2.2.MemoryCache内存缓存

2.3.不要忘记缓存的清理

3.网络图片获取想停就停

4. 图像大小由你控制

5. 注意事项

6.下载地址

1.个性的ImageLoader配置

1.1.在哪儿配置以及如何配置

一般会在自己的Application子类的onCreate（）方法中对ImageLoader进行配置

(1) ImageLoaderConfiguration各属性解释

l 偷懒点可以直接使用缺省的配置ImageLoaderConfiguration:

ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this);

l 也可以自定义ImageLoaderConfiguration:

ImageLoaderConfiguration类Field详解：
4000

Filed名称	Filed意义	缺省默认值	Builder中设置方法
Int maxImageWidthForMemoryCacheInt maxImageHeightForMemoryCache	内存缓存图片的最大宽高	屏幕的宽高度	memoryCacheExtraOptions(...)
Int maxImageWidthForDiskCacheInt maxImageHeightForDiskCache	磁盘缓存图片的最大宽高	0,0	discCacheExtraOptions（...）或者diskCacheExtraOptions（...）
BitmapProcessor processorForDiskCache	图片处理器，负责从磁盘缓存读取或写入前对图片进行处理	null	discCacheExtraOptions（...）或者diskCacheExtraOptions（...）
Executor taskExecutor	缓存线程池	DefaultConfigurationFactory.createExecutor(...)；	taskExecutor(...)
Executor taskExecutorForCachedImages	下载缓存图片的线程池	DefaultConfigurationFactory.createExecutor(...)；	taskExecutorForCachedImages（...）
Boolean customExecutor	是否自定义线程池	false	无
Boolean customExecutorForCachedImages	是否自定义下载缓存图片的线程池	false	无
Int threadPoolSize	线程池数	3	threadPoolSize(...)
Int threadPriority	线程优先级	Thread.NORM_PRIORITY - 2	threadPriority(...)
QueueProcessingType tasksProcessingType	片下载和显示的工作队列排序	QueueProcessingType.FIFO	tasksProcessingOrder(...)
MemoryCache memoryCache	指定内存缓存的实现	DefaultConfigurationFactory.createMemoryCache(...)	memoryCache(...)
DiskCache diskCache	指定磁盘缓存的实现	DefaultConfigurationFactory.createDiskCache(...);	discCache(...)或者 diskCache(...)
ImageDownloader downloader	图片下载器，负责从图片的各个来源获取输入流	imageDownloader(...)	DefaultConfigurationFactory.createImageDownloader(context);
ImageDecoder decoder	图片解码器，负责将图片输入流InputStream转换为Bitmap对象	DefaultConfigurationFactory.createImageDecoder(writeLogs);	imageDecoder(...)
DisplayImageOptions defaultDisplayImageOptions;	缺省的图片显示的配置项	DisplayImageOptions.createSimple();	defaultDisplayImageOptions(...)
ImageDownloader networkDeniedDownloader	不允许访问网络的图片下载器	networkDeniedDownloader = new NetworkDeniedImageDownloader(downloader);	无
ImageDownloader slowNetworkDownloader	慢网络情况下的图片下载器	slowNetworkDownloader = new SlowNetworkImageDownloader(downloader);	无

(2) DisplayImageOptions各属性解释

l 创建默认的DisplayImageOptions:

DisplayImageOptions option_0 = DisplayImageOptions.createSimple();

l 也可以自定义DisplayImageOptions:

DisplayImageOptions类Field详解
cb7c

Filed名称	Field意义	缺省默认值	Builder中设置方法
int imageResOnLoadingDrawable imageOnLoading	图片下载期间显示的图片	0	showStubImage(...)或者showImageOnLoading(...)
int imageResForEmptyUriDrawable imageForEmptyUri	空 uri 时的占位图片	0	showImageForEmptyUri(...)
int imageResOnFailDrawable imageOnFail	图片下载失败时展示图片		showImageOnFail(...)
boolean resetViewBeforeLoading	在加载前是否重置 view	false	resetViewBeforeLoading()或者resetViewBeforeLoading(...)
boolean cacheInMemory	是否启用内存缓存	false	cacheInMemory()或者cacheInMemory(...)
boolean cacheOnDisk	是否启用磁盘缓存	false	cacheOnDisc()或者cacheOnDisc(...) 或者cacheOnDisk（...）
ImageScaleType imageScaleType	图片的缩放类型	ImageScaleType.IN_SAMPLE_POWER_OF_2	imageScaleType(ImageScaleType imageScaleTy）
Options decodingOptions	为 BitmapFactory.Options，用于BitmapFactory.decodeStream(imageStream, null, decodingOptions)得到图片尺寸等信息	Options decodingOptions = new Options();	bitmapConfig(Bitmap.Config bitmapConfig)decodingOptions(Options decodingOptions)
int delayBeforeLoading	设置在开始加载前的延迟时间，单位为毫秒	0	delayBeforeLoading(int delayInMillis)
boolean considerExifParams	是否考虑图片的 EXIF 信息（括机身、镜头型号、拍摄时间、相机快门次数）	false	considerExifParams(...)
Object extraForDownloader	下载器需要的辅助信息	null	extraForDownloader(Object extra)
BitmapProcessor preProcessor	缓存在内存之前的处理程序	null	preProcessor(...)
BitmapProcessor postProcessor	缓存在内存之后的处理程序	null	postProcessor(...)
BitmapDisplayer displayer	图片的显示方式	DefaultConfigurationFactory.createBitmapDisplayer();	displayer(...)
Handler handler	handler 对象,消息处理	null	handler(...)
boolean isSyncLoading	是否同步加载	false	syncLoading(...)

(3) 自定义配置总结：
1) Imageloader提供的缺省的ImageLoaderConfiguration和缺省的DisplayImageOptions已经基本可以满足我们正常的需求，如果没有特殊的需要可以不用再修改；2) ImageLoaderConfiguration的Builder中的diskCache()方法, diskCacheSize() 方法以及diskCacheFileCount（）方法彼此功能重叠的，如果设置了其中一个，就不要再设置其他的了；

3) ImageLoaderConfiguration的Builder中的diskCache()方法 和 diskCacheFileNameGenerator()方法彼此功能重叠的，如果设置了其中一个，就不要再设置其他的了；

4) ImageLoaderConfiguration的Builder中的memoryCache() 方法和memoryCacheSize()方法 彼此功能重叠的，如果设置了其中一个，就不要再设置其他的了。

1.2.补充理解：三大关键对象关系

1) ImageLoader：

具体下载图片，缓存图片，显示图片的具体执行类，它有两个具体的方法displayImage(...)、loadImage(...)，但是其实最终他们的实现都是displayImage(...)

2) ImageLoaderConfiguration：

图片缓存的全局配置，主要有线程类、缓存大小、磁盘大小、图片下载与解析、日志方面的配置

3) DisplayImageOptions：

指导每一个Imageloader根据网络图片的状态（空白、下载错误、正在下载）显示对应的图片，是否将缓存加载到磁盘上，下载完后对图片进行怎么样的处理

4) 三者关系的形象比喻：

这三者就像是公司执行机构、公司规章制度以及客户需求,ImageLoaderConfiguration就像一个公司的规章制度，里面规定了一个公司全局性的性质；ImageLoader就像是一个公司的执行机构，会给客户创造出客户想要的产品；DisplayImageOptions就像是每一个客户的具体需求，公司执行结构会根据这个需求最终决定如何生产那个产品。

2.各式缓存方式任你选择

2.1.DiskCache 磁盘缓存
1) UnlimitedDiscCache不限制缓存大小；2) UnlimitedDiscCache很简单它只是简单的继承了BaseDiscCache并未对BaseDiscCache做任何扩展；

3) LimitedAgeDiscCache限制缓存时间；

4) LimitedAgeDiscCache该类实现了在缓存中删除被加载超过规定时间的文件：满足以下条件的时候就从缓存中删除文件：系统当前时间-文件的最新修改时间 > maxFileAge；

2.2.MemoryCache内存缓存

1) 通过实现接口MemoryCacheAware <String,Bitmap>来实现自己的缓存

2) UsingFreqLimitedCache (最少被用到的对象会被删除)

3) UsingAgeLimitedCache (最早被添加的对象会被删除)

4) LargestLimitedCache (空间占用最大的对象会被删除)

5) FIFOLimitedCache (根据先进先出的原则上删除多余对象)

2.3.不要忘记缓存的清理

一般要在整个应用结束的时候调用下面两个方法，分别情况内存缓存和磁盘缓存，提高用户体验 ：

i. imageLoader.clearMemoryCache();

ii. imageLoader.clearDiskCache();

3. 网络图片获取想停就停

主要是用于GirdView,ListView加载图片的情况，因为这两个控件展示图片的时候会出现滑动操作，为了更友好的用户体验，可以设置GirdView,ListView的setOnScrollListener监听事件。
listView.setOnScrollListener(new PauseOnScrollListener(imageLoader, pauseOnScroll, pauseOnFling));gridView.setOnScrollListener(new PauseOnScrollListener(imageLoader, pauseOnScroll, pauseOnFling));

pauseOnScroll---是否在滑动过程中停止加载图片

pauseOnFling---是否在快速猛的滑动中停止加载图片

4.图像大小由你控制

在ImageLoadingListener接口有以下几个状态监听，用于监听图片下载的不同状态：

1) onLoadingStarted(String imageUri, View view)；2) onLoadingFailed(String imageUri, View view, FailReason failReason)；

3) onLoadingComplete(String imageUri, View view, Bitmap loadedImage)：

在图片加载成功之后，可以对获取到的Bitmap进行各种大小设置，图形裁剪操作以及动画效果添加等，

最后再加图片展示到控件上。

4) onLoadingCancelled(String imageUri, View view)。

5.注意事项

 使用了ImageLoader可以有效的避免程序加载图片出现OOM的情况，但是也不是百分之百的屏蔽这个问题，在有的时候，还是会出现，这个时候，我们 可以从下面几个思路去优化我们的ImageLoader

1) 减少配置之中线程池的大小，(.threadPoolSize).推荐1-5；2) 使用.bitmapConfig(Bitmap.config.RGB_565)代替ARGB_8888;

3) 使用.imageScaleType(ImageScaleType.IN_SAMPLE_INT)或者 try.imageScaleType(ImageScaleType.EXACTLY)；

4) 避免使用RoundedBitmapDisplayer.他会创建新的ARGB_8888格式的Bitmap对象；

5) 使用.memoryCache(new WeakMemoryCache())，不要使用.cacheInMemory();

6.下载地址： https://github.com/nostra13/Android-Universal-Image-Loader