UniversalImageLoader的用法总结

转载请注明出处：http://blog.csdn.net/crazy1235/article/details/70305083

---

作为图片加载类库的”老大哥”，相信大部分人都用过它！

不管是自己再项目里面用，还是自己造轮子，了解UIL的用法和框架原理都是有帮助的！

下面就来总结下UIL的基本使用！

---

UIL的功能及优点

• 支持从网络，本地，项目内读取图片

• 多线程下载图片

• 支持图片下载进度监听

• 支持图片加载起始，加载中，加载结束等毁掉函数

• 包含内存缓存和磁盘缓存， 并可进行缓存大小等参数的配置

• 支持占位图，及图片加载过程中图片，以及图片加载失败图片的显示

• 支持图片加载成功后再处理

• 支持对bitmap裁剪等处理

• 可在ListView等滚动控件发生滚动时，暂定图片加载

• 提供在网路较慢时图片的加载

• 扩展性强，内存缓存和磁盘缓存策略可自行实现，图片加载各种参数也可自由配置！

---

UIL的使用

Github地址： 
https://github.com/nostra13/Android-Universal-Image-Loader

方式一：

下载jar包，导入项目

universal-image-loader-1.9.5.jar

方式二：

直接在build.gradle中添加依赖项

compile ‘com.nostra13.universalimageloader:universal-image-loader:1.9.3’

接下来在项目中添加【访问网络】和【写入外部存储】两个权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  
<uses-permission android:name="android.permission.INTERNET" />  

• 1
• 2

接着， 配置UIL的初始化：

ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this);
ImageLoader.getInstance().init(configuration);

• 1
• 2

通过上面两行代码就可以完成UIL的初始配置！不错这是最简单的配置， 后面会详细说具体的配置！

然后需要配置显示图片的相关参数，比如图片是否需要缓存，是否需要占位图，是否需要圆角处理等等

DisplayImageOptions imageOptions = DisplayImageOptions.createSimple();

• 1

老规矩，还是先来个最简单的配置。

最后就显示图片了

ImageLoader.getInstance().displayImage("http://img.hb.aicdn.com/278475ced55b8361e0d2beb9b568dd225f1c8c9d1593b-1F63BW_fw658", imageView1, imageOptions);

• 1

OK，运行一下图片就可以出来了！（在手机联网的情况下啊！O(∩_∩)O）

---

具体配置

上面提到了3个重要的类

• ImageLoaderConfiguration

• ImageLoader

• DisplayImageOptions

• ImageLoadingListener

先来一一介绍。

---

ImageLoaderConfiguration 是针对ImageLoader这个框架的全局配置。包括线程池线程数量，磁盘缓存大小，内存缓存大小，缓存文件数量，缓存文件路径等配置。

它使用了 建造者模式 ， 还提供了一个静态函数 createDefault(Context context) 来创建一个最基本的配置。

详细配置：

ImageLoaderConfiguration.Builder builder = new ImageLoaderConfiguration.Builder(context);
        builder.threadPoolSize(5); // 线程池大小
        builder.threadPriority(Thread.NORM_PRIORITY - 2); // 设置线程优先级
        builder.denyCacheImageMultipleSizesInMemory(); // 不允许在内存中缓存同一张图片的多个尺寸
        builder.tasksProcessingOrder(QueueProcessingType.LIFO); // 设置处理队列的类型，包括LIFO， FIFO
        builder.memoryCache(new LruMemoryCache(3 * 1024 * 1024)); // 内存缓存策略
        builder.memoryCacheSize(5 * 1024 * 1024);  // 内存缓存大小
        builder.memoryCacheExtraOptions(480, 800); // 内存缓存中每个图片的最大宽高
        builder.memoryCacheSizePercentage(50); // 内存缓存占总内存的百分比
        builder.diskCache(new UnlimitedDiskCache(cacheDir)); // 设置磁盘缓存策略
        builder.diskCacheSize(50 * 1024 * 1024); // 设置磁盘缓存的大小
        builder.diskCacheFileCount(50); // 磁盘缓存文件数量
        builder.diskCacheFileNameGenerator(new Md5FileNameGenerator()); // 磁盘缓存时图片名称加密方式
        builder.imageDownloader(new BaseImageDownloader(this)); // 图片下载器
        builder.defaultDisplayImageOptions(DisplayImageOptions.createSimple());
        builder.writeDebugLogs(); // 打印日志

ImageLoader.getInstance().init(builder.build());

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18

---

ImageLoader

是UIL初始化和加载显示图片的关键类！

通过 单例模式 进行初始化！

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;
    }

    protected ImageLoader() {
    }

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16

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);
        }
    }

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12

所以当没有设置ImageLoaderConfirguation的时候，会抛出异常！

内部包含很多个重载的displayImage() 方法， loadImage()方法, loadImageSync()方法！

displayImage() 异步加载图片并显示

loadImage() 异步加载图片

loadImageSync() 同步加载图片

---

DisplayImageOptions

在配置 ImageLoaderConfiguration 的时候就可以统一配置图片的参数！但是我们也可以针对不同的图片做不同的配置！

同样使用了 建造者模式 ！！！

DisplayImageOptions options = new DisplayImageOptions.Builder()
                .showImageOnLoading(R.drawable.default_img) // 加载过程中的显示图片
                .showImageForEmptyUri(R.drawable.default_img) // 路径为空时显示的图片
                .showImageOnFail(R.drawable.default_img) // 加载失败显示的图片
                .resetViewBeforeLoading(false) // 将要开始加载时是否需要替换成onLoading图片
                .delayBeforeLoading(1000) // 加载延迟时间
                .preProcessor(xxx) // 图片加入缓存之前的处理
                .postProcessor(xxx) // 图片在显示之前的处理
                .decodingOptions(BitmapFactory.Options) // 解码参数
                .cacheInMemory(true) // 需要缓存在内存中
                .cacheOnDisk(true) // 需要缓存到磁盘中
                .considerExifParams(true) // 是否考虑Exif参数
                .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // 缩放类型
                .bitmapConfig(Bitmap.Config.RGB_565) // bitmap模式
                .displayer(new RoundedBitmapDisplayer(20)) // 设置图片显示形式(圆角 or 渐变等)
                .build();

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16

ImageLoadingListener

在加载图片的时候设置监听器可以监听到开始，失败，成功，取消等回调！

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);
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10

也可以使用它的实现类 SimpleImageLoadingListener ， 这样可以在代码中少看到一些不需要的回调！

public class SimpleImageLoadingListener implements ImageLoadingListener {
    @Override
    public void onLoadingStarted(String imageUri, View view) {
        // Empty implementation
    }

    @Override
    public void onLoadingFailed(String imageUri, View view, FailReason failReason) {
        // Empty implementation
    }

    @Override
    public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
        // Empty implementation
    }

    @Override
    public void onLoadingCancelled(String imageUri, View view) {
        // Empty implementation
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

---

按照项目所需进行配置即可！！！

---

滚动时暂定加载

当使用ListView，RecyclerView， GridView的时候，滚动屏幕时暂停图片加载可减少界面卡顿！

listView.setOnScrollListener(new PauseOnScrollListener(ImageLoader.getInstance(), true, true));

• 1

gridView.setOnScrollListener(new PauseOnScrollListener(imageLoader, pauseOnScroll, pauseOnFling));  

• 1
• 2

recyclerView.addOnScrollListener(new RVPauseOnScrollListener(ImageLoader.getInstance(), true, true));

• 1

UIL项目中并没有关于RecyclerView类滚动事件的监听判断！ RVPauseOnScrollListener 是我自己写的一个扩展类！

public class RVPauseOnScrollListener extends RecyclerView.OnScrollListener {

    private ImageLoader imageLoader;
    private final boolean pauseOnScroll;
    private final boolean pauseOnFling;

    public RVPauseOnScrollListener(ImageLoader imageLoader, boolean pauseOnScroll, boolean pauseOnFling) {
        this.imageLoader = imageLoader;
        this.pauseOnScroll = pauseOnScroll;
        this.pauseOnFling = pauseOnFling;
    }

    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        switch (newState) {
            case RecyclerView.SCROLL_STATE_IDLE: // 
                imageLoader.resume();
                break;
            case RecyclerView.SCROLL_STATE_SETTLING: //　
                if (pauseOnFling) {
                    imageLoader.pause();
                }
                break;
            case RecyclerView.SCROLL_STATE_DRAGGING: // 
                if (pauseOnScroll) {
                    imageLoader.pause();
                }
                break;
        }
    }
}

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30
• 31
• 32

---

源码请移步：

https://github.com/crazy1235/About-Image/tree/master/UniversalImageLoaderDemo

OVER !!!~