【Android】开源项目UniversalImageLoader及开源框架ImageLoader

2022-12-02 17:24:10

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