UniversalImageLoader
简单来说就是用于加载图片的一个开源项目,在其项目介绍中是这么写的
- 支持多线程图片加载
- 提供丰富的细节配置,比如线程池大小,HTPP请求项,内存和磁盘缓存,图片显示时的参数配置等等;
- 提供双缓存
- 支持加载过程的监听;
- 提供图片的个性化显示配置接口;
其他类似的项目也有很多,但这个作为github上著名的开源项目被广泛使用。第三方的包虽然好用省力,可以有效避免重复造*,但是却隐藏了一些开发上的细节,如果不关注其内部实现,那么将不利于掌握核心技术,当然也谈不上更好的使用它,计划分析项目的集成使用和低层实现。
源码地址:https://github.com/nostra13/Android-Universal-Image-Loader
简单分析
- 加载图片之前,先要做初始化配置,这个类似很多游戏引擎使用前要做一下初始化;
- 其实只做了一件事,实例化一个全局的ImageLoader对象,同时传入图片加载缓存的配置;
- ImageLoaderConfiguration封装了基本的配置信息,比如加载图片事用的线程池大小,线程的优先级,内存缓存大小,是否支持同一图片的多尺寸缓存(默认是支持的,可以手动关闭),还有缓存的命名规则等等.
这基本也就是几行代码,下面这张图里有实例化和初始化的过程。
关于这个实例化,是线程安全,忽略第二层判断,如果A,B线程同时执行if(instance==null),A,B都满足条件进入,此时,其中一个换锁,另一个等待,还需要再次判断instance==null(这是必要的,否则可能使得,再次实例化)这样一个单例就正常初始化了。
配置完后,就可以开始使用了,通过ImageLoader的displayImage()绑定一个图片和ImageView,该方法有四个重载版本,传的参数比较多,这也印证了该项目提供每个图片单独的显示配置这一说法。
其中参数最全的是:
displayImage(String uri, ImageView imageView, DisplayImageOptions options, ImageLoadingListener listener);
另外三个其实就是减少其中几个参数用默认的值而已。
- String uri, 图片链接没什么疑问
- ImageView imageView, 图片载体控件,也没什么好说
比较重要的是后面两个,DisplayImageOptions options,图片的参数配置对象
options = new DisplayImageOptions.Builder() .showStubImage(R.drawable.stub_image) .showImageForEmptyUri(R.drawable.image_for_empty_url) .cacheInMemory() .cacheOnDisc() .build();
来看看都有什么信息可以配置的,
- 第一个是图片加载过程中显示的图片
- 第二个是图片加载失败时用的的图片
- 第三个允许内存缓存
- 第四个允许磁盘缓存
除此之外还有两个
- imageScaleType(ImageScaleType imageScaleType)图片缩放类型
- displayer(BitmapDisplayer displayer)bitmap显示控制层,可以在显示图片前对Bitmap简单处理一下,这两个不是一定要设定,应为他们都有默认值。
最后一个参数ImageLoadingListener listener当然是监听过程的回调接口
Imageloader
图片加载的Imageloader实现
通过ImageLoader实例对象,调用public void displayImage(String uri, ImageView imageView, DisplayImageOptions options, ImageLoadingListener listener)发放将开始加载图片
具体过程可以分为几个阶段
合法性检查
主要是初始化检查和参数检查,可能会
- 抛出异常或是下载不受干扰可以继续;有传入的图片地址为空
- imageview为空
- 图片配置实例为空
- 过程监听接口为空四种情况。
if (configuration == null) { throw new RuntimeException(ERROR_NOT_INIT); } if (imageView == null) { Log.w(TAG, ERROR_WRONG_ARGUMENTS); return; } if (listener == null) { listener = emptyListener; } if (options == null) { options = configuration.defaultDisplayImageOptions; } if (uri == null || uri.length() == 0) { cacheKeyForImageView.remove(imageView); listener.onLoadingStarted(); if (options.isShowImageForEmptyUri()) { imageView.setImageResource(options.getImageForEmptyUri()); } else { imageView.setImageBitmap(null); } listener.onLoadingComplete(null); return; }
- 如果没有初始化ImageLoader是比较严重的,将直接抛出运行时异常
- 控件ImageView为空时不影响,可以直接退出,不再下载
- 图片配置和监听接口为空则将启用默认值
- 至于图片url的话,由于初始化时已经实例化了默认值的情形,所以将显示本地设置的默认图片,同时将控件移出HashMap。
加载准备
- 这里的准备操作一个是获取图片的尺寸参数
- 然后根据这个参数和url生成标记ImageView的key
- 最后以key-value的形式存入HashMap中备用
targetSize = getImageSizeScaleTo(imageView); String memoryCacheKey = MemoryCacheKeyUtil.generateKey(uri, targetSize); cacheKeyForImageView.put(imageView, memoryCacheKey);
加载操作
加载分为调用内存缓存和本地缓存/网络下载,根据上一步加载准备中得到的key获取bitmap,这个过程比较发杂
先看看从内存缓存获取图片
if (bmp != null && !bmp.isRecycled()) { if (configuration.loggingEnabled) Log.i(TAG, String.format(LOG_LOAD_IMAGE_FROM_MEMORY_CACHE, memoryCacheKey)); listener.onLoadingStarted(); Bitmap displayedBitmap = options.getDisplayer().display(bmp, imageView); imageView.setImageBitmap(displayedBitmap); listener.onLoadingComplete(bmp); }
- 根据得到的bitmap,如果不为空且未被标记为回收状态,那么就可以使用这个缓存的bitmap
- 调用监听接口的onLoadingStarted()处理一些加载前的操作,然后对bitmap做一些显示前的操作
- 这个就用到传入进来的图片显示的option配置,如果没传这个值,那启用默认值,应该是不对bitmap操作
- 这个默认的option使用SimpleBitmapDisplayer 实例
- 接下来调用监听接口的onLoadingComlete()
- 到此显示内存缓存图片的操作就结束了
查看其源代码,果然是直接将bitmap设置给ImageView然后对外返回原来的Bitmap,对于这种情况后面的在此设置bitmap给imageview其实有些累赘,重复操作了。
public final class SimpleBitmapDisplayer implements BitmapDisplayer { @Override public Bitmap display(Bitmap bitmap, ImageView imageView) { imageView.setImageBitmap(bitmap); return bitmap; } }
下面介绍第二种情况,就是从磁盘缓存/网新下载图片。
- 先调用监听接口的onLoadingStarted()
- 接着显示一个下载过程中的图片或则干脆在下载时不显示任何图片
- 接着检查一下线程池是否初始化并正常工作中checkExecutors()
查看源代码可以发现,项目用与下载的的task其实是通过ExecutorService来管理
private void checkExecutors() { if (imageLoadingExecutor == null || imageLoadingExecutor.isShutdown()) { imageLoadingExecutor = Executors.newFixedThreadPool(configuration.threadPoolSize, configuration.displayImageThreadFactory); } if (cachedImageLoadingExecutor == null || cachedImageLoadingExecutor.isShutdown()) { cachedImageLoadingExecutor = Executors.newFixedThreadPool(configuration.threadPoolSize, configuration.displayImageThreadFactory); } }
- 为了下载图片这里把必要的图片信息做了一个封装传给工作线程
- ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageView, targetSize, options, listener, getLockForUri(uri));
- 现在一起看一下他的工作线程是怎么写的:LoadAndDisplayImageTask displayImageTask = new LoadAndDisplayImageTask(configuration, imageLoadingInfo, new Handler());
- 这里的最后一个参数是我们熟悉的Handler 实例,可以预测这个task类应该是Runnale的是子类,在run() 中根据情况向handler发送处理操作请求
源码详细注释
http://blog.csdn.net/wwj_748/article/details/10079311
参考文章
https://github.com/nostra13/Android-Universal-Image-Loader
http://blog.csdn.net/wwj_748/article/details/10079311
http://www.cnblogs.com/avenwu/
【Android】开源项目UniversalImageLoader及开源框架ImageLoader,布布扣,bubuko.com