Universal-Image-Loader解析（一）——ImageLoaderConfiguration的详细配置

　　Universal-Image-Loader这个开源框架又来给我们造福了，它是一个图片加载框架，主要强大在于可以用于网络等图片源的加载，并且有多重缓存机制。先给出其项目地址：https://github.com/nostra13/Android-Universal-Image-Loader

一、简要说明：

1.多线程下载图片，图片可以来源于网络，文件系统，项目文件夹assets中以及drawable中等
2.支持随意的配置ImageLoader，例如线程池，图片下载器，内存缓存策略，硬盘缓存策略，图片显示选项以及其他的一些配置
3.支持图片的内存缓存，文件系统缓存或者SD卡缓存
4.支持图片下载过程的监听
5.根据控件(ImageView)的大小对Bitmap进行裁剪，减少Bitmap占用过多的内存
6.较好的控制图片的加载过程，例如暂停图片加载，重新开始加载图片，一般使用在ListView,GridView中，滑动过程中暂停加载图片，停止滑动的时候去加载图片
7.提供在较慢的网络下对图片进行加载

二、配置和使用

1.新建一个类继承Application，实现初始化ImageLoader

ImageLoader是一个配置方案，主要是一次性的配置项目中的缓存策略，这样独立的配置很便于模块化。

@Override

    public void onCreate() {

        // TODO 自动生成的方法存根

        super.onCreate();

        //通过配置方案来初始化ImageLoader

        ImageLoader.getInstance().init(ImageLoaderConfiguration configuration);  

    }

这里的参数是一个ImageLoaderConfiguration，这个对象可以设置缓存，缓存路径等等，下面我们先得到一个默认的配置好的对象。

它使用了Build模式，这样我们就可以很方便的来得到一个默认的配置好的ImageLoaderConfiguration对象

    /**

     * 创建默认的ImageLoader配置参数，这里创建了一个默认的配置方案

     * @return

     */

    private ImageLoaderConfiguration getDefaultConfig() {

       ImageLoaderConfiguration config = ImageLoaderConfiguration.createDefault(getApplicationContext());

       return config;

    }
    

当然，ImageLoaderConfiguration有多重选项可以配置。下面是各种属性和自己的默认值

ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)

    .memoryCacheExtraOptions(480, 800) // default = device screen dimensions

    .diskCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null)

    .taskExecutor(...)

    .taskExecutorForCachedImages(...)

    .threadPoolSize(3) // default

    .threadPriority(Thread.NORM_PRIORITY - 1) // default

    .tasksProcessingOrder(QueueProcessingType.FIFO) // default

    .denyCacheImageMultipleSizesInMemory()

    .memoryCache(new LruMemoryCache(2 * 1024 * 1024))

    .memoryCacheSize(2 * 1024 * 1024)

    .memoryCacheSizePercentage(13) // default

    .diskCache(new UnlimitedDiscCache(cacheDir)) // default

    .diskCacheSize(50 * 1024 * 1024)

    .diskCacheFileCount(100)

    .diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default

    .imageDownloader(new BaseImageDownloader(context)) // default

    .imageDecoder(new BaseImageDecoder()) // default

    .defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default

    .writeDebugLogs()

    .build();

example：

    /**

     * 所有的配置参数举例

     * @return

     */

    private ImageLoaderConfiguration getWholeConfig() {

        //设置默认的配置，设置缓存，这里不设置可以到别的地方设置

        DisplayImageOptions defaultOptions = new DisplayImageOptions.Builder()

        .cacheInMemory(true)

        .cacheOnDisk(true)

        .build();

        //设置缓存的路径

        File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");

        ImageLoaderConfiguration config = new ImageLoaderConfiguration

                .Builder(getApplicationContext())

                .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽

                .threadPoolSize(3) //线程池内加载的数量

                .threadPriority(Thread.NORM_PRIORITY - 2)

                //解释：当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片

                .denyCacheImageMultipleSizesInMemory()  //拒绝缓存多个图片。

                .memoryCache(new WeakMemoryCache()) //缓存策略你可以通过自己的内存缓存实现 ，这里用弱引用，缺点是太容易被回收了，不是很好！

                .memoryCacheSize(2 * 1024 * 1024) //设置内存缓存的大小

                .diskCacheSize(50 * 1024 * 1024) //设置磁盘缓存大小 50M

                .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密

                .tasksProcessingOrder(QueueProcessingType.LIFO) //设置图片下载和显示的工作队列排序

                .diskCacheFileCount(100) //缓存的文件数量

                .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径

                .defaultDisplayImageOptions(defaultOptions) //显示图片的参数，默认：DisplayImageOptions.createSimple()

                .imageDownloader(new BaseImageDownloader(this, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间

                .writeDebugLogs() //打开调试日志

                .build();//开始构建

        return config;

    }

刚开始别被吓跑了，其实看起来多，我们一般只需要知道这是做什么的，然后根据自己的需求配置即可。

常用配置：

    /**

     * 比较常用的配置方案

     * @return

     */

    private ImageLoaderConfiguration getSimpleConfig() {

        //设置缓存的路径

        File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");

        ImageLoaderConfiguration config = new ImageLoaderConfiguration

            .Builder(getApplicationContext())

            .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽

            .threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数

            .denyCacheImageMultipleSizesInMemory() //禁止缓存多张图片

            .memoryCache(new LRULimitedMemoryCache(40*1024*1024)) //缓存策略

            .memoryCacheSize(50 * 1024 * 1024) //设置内存缓存的大小

            .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //缓存文件名的保存方式

            .diskCacheSize(200 * 1024 * 1024) //磁盘缓存大小

            .tasksProcessingOrder(QueueProcessingType.LIFO) //工作队列

            .diskCacheFileCount(200) //缓存的文件数量

            .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径

            //.writeDebugLogs() // Remove for release app

            .build();

         return config;

    }

注：这里面有多个参数是有待商榷的，自己根据需求配置即可！

在Activity中清除缓存的方法：

        //清除缓存

        ImageLoader.getInstance().clearDiskCache();

        ImageLoader.getInstance().clearMemoryCache();

Manifest.xml 中加入权限，并且配置Application！

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    package="com.kale.universalimageloadertest"

    android:versionCode="1"

    android:versionName="1.0" >

    <!-- 访问internet的权限 -->

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

    <!-- Include next permission if you want to allow UIL to cache images on SD card -->

    <!-- 写入sd卡的权限 -->

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

    <uses-sdk

        android:minSdkVersion="8"

        android:targetSdkVersion="18" />

    <!-- 添加进自己的Application -->

    <application

        android:name="com.kale.universalimageloadertest.application.MyApplication"

        android:allowBackup="true"

        android:icon="@drawable/ic_launcher"

        android:label="@string/app_name"

        android:theme="@style/AppTheme" >

        <activity

            android:name=".MainActivity"

            android:label="@string/app_name" >

            <intent-filter>

                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />

            </intent-filter>

        </activity>

        <activity android:name="com.kale.universalimageloadertest.UILListActivity"/>

    </application>

</manifest>

MyApplication.JAVA

package com.kale.universalimageloadertest.application;

import java.io.File;

import android.app.Application;

import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiskCache;

import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;

import com.nostra13.universalimageloader.cache.memory.impl.FIFOLimitedMemoryCache;

import com.nostra13.universalimageloader.cache.memory.impl.LRULimitedMemoryCache;

import com.nostra13.universalimageloader.cache.memory.impl.WeakMemoryCache;

import com.nostra13.universalimageloader.core.DisplayImageOptions;

import com.nostra13.universalimageloader.core.ImageLoader;

import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;

import com.nostra13.universalimageloader.core.assist.QueueProcessingType;

import com.nostra13.universalimageloader.core.download.BaseImageDownloader;

import com.nostra13.universalimageloader.utils.StorageUtils;

/**

 * @author:Jack Tony

 * @tips  :新建一个MyApplication继承Application，并在onCreate()

 * 中创建ImageLoader的配置参数，并初始化到ImageLoader中代码

 * @date  :2014-10-15

 */

public class MyApplication extends Application{

    @Override

    public void onCreate() {

        // TODO 自动生成的方法存根

        super.onCreate();

        //通过配置方案来初始化ImageLoader

        ImageLoader.getInstance().init(getSimpleConfig());

    }

    /**

     * 创建默认的ImageLoader配置参数，这里创建了一个默认的配置方案

     * @return

     */

    private ImageLoaderConfiguration getDefaultConfig() {

       ImageLoaderConfiguration config = ImageLoaderConfiguration

                .createDefault(getApplicationContext());

       return config;

    }

    /**

     * 所有的配置参数举例

     * @return

     */

    private ImageLoaderConfiguration getWholeConfig() {

        //设置默认的配置，设置缓存，这里不设置可以到别的地方设置

        DisplayImageOptions defaultOptions = new DisplayImageOptions.Builder()

        .cacheInMemory(true)

        .cacheOnDisk(true)

        .build();

        //设置缓存的路径

        File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");

        ImageLoaderConfiguration config = new ImageLoaderConfiguration

                .Builder(getApplicationContext())

                .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽

                .threadPoolSize(3) //线程池内加载的数量

                .threadPriority(Thread.NORM_PRIORITY - 2)

                //解释：当同一个Uri获取不同大小的图片，缓存到内存时，只缓存一个。默认会缓存多个不同的大小的相同图片

                .denyCacheImageMultipleSizesInMemory()  //拒绝缓存多个图片。

                .memoryCache(new WeakMemoryCache()) //缓存策略你可以通过自己的内存缓存实现 ，这里用弱引用，缺点是太容易被回收了，不是很好！

                .memoryCacheSize(2 * 1024 * 1024) //设置内存缓存的大小

                .diskCacheSize(50 * 1024 * 1024) //设置磁盘缓存大小 50M

                .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密

                .tasksProcessingOrder(QueueProcessingType.LIFO) //设置图片下载和显示的工作队列排序

                .diskCacheFileCount(100) //缓存的文件数量

                .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径

                .defaultDisplayImageOptions(defaultOptions) //显示图片的参数，默认：DisplayImageOptions.createSimple()

                .imageDownloader(new BaseImageDownloader(getApplicationContext(), 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间

                .writeDebugLogs() //打开调试日志

                .build();//开始构建

        return config;

    }

    /**

     * 比较常用的配置方案

     * @return

     */

    private ImageLoaderConfiguration getSimpleConfig() {

        //设置缓存的路径

        File cacheDir = StorageUtils.getOwnCacheDirectory(getApplicationContext(), "imageloader/Cache");

        ImageLoaderConfiguration config = new ImageLoaderConfiguration

            .Builder(getApplicationContext())

            .memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽

            .threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数

            .denyCacheImageMultipleSizesInMemory() //禁止缓存多张图片

            .memoryCache(new LRULimitedMemoryCache(50 * 1024 * 1024)) //缓存策略

            .memoryCacheSize(50 * 1024 * 1024) //设置内存缓存的大小

            .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //缓存文件名的保存方式

            .diskCacheSize(200 * 1024 * 1024) //磁盘缓存大小

            .tasksProcessingOrder(QueueProcessingType.LIFO) //工作队列

            .diskCacheFileCount(200) //缓存的文件数量

            .diskCache(new UnlimitedDiskCache(cacheDir)) //自定义缓存路径

            //.writeDebugLogs() // Remove for release app

            .build();

         return config;

    }

/*    ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)

    .memoryCacheExtraOptions(480, 800) // default = device screen dimensions

    .diskCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null)

    .taskExecutor(...)

    .taskExecutorForCachedImages(...)

    .threadPoolSize(3) // default

    .threadPriority(Thread.NORM_PRIORITY - 1) // default

    .tasksProcessingOrder(QueueProcessingType.FIFO) // default

    .denyCacheImageMultipleSizesInMemory()

    .memoryCache(new LruMemoryCache(2 * 1024 * 1024))

    .memoryCacheSize(2 * 1024 * 1024)

    .memoryCacheSizePercentage(13) // default

    .diskCache(new UnlimitedDiscCache(cacheDir)) // default

    .diskCacheSize(50 * 1024 * 1024)

    .diskCacheFileCount(100)

    .diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) // default

    .imageDownloader(new BaseImageDownloader(context)) // default

    .imageDecoder(new BaseImageDecoder()) // default

    .defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default

    .writeDebugLogs()

    .build();  */

}

Universal-Image-Loader的内存缓存策略

详细的缓存策略可以移步：http://blog.csdn.net/xiaanming/article/details/27525741，下方是总结的结果：

1.强引用缓存 
LruMemoryCache（这个类就是这个开源框架默认的内存缓存类，缓存的是bitmap的强引用）

好处：滑动时图片不会容易被清除，体验好；坏处：容易出现OOM

2.使用强引用和弱引用相结合的缓存有
UsingFreqLimitedMemoryCache（如果缓存的图片总量超过限定值，先删除使用频率最小的bitmap）
LRULimitedMemoryCache（这个也是使用的lru算法，和LruMemoryCache不同的是，他缓存的是bitmap的弱引用）
FIFOLimitedMemoryCache（先进先出的缓存策略，当超过设定值，先删除最先加入缓存的bitmap）
LargestLimitedMemoryCache(当超过缓存限定值，先删除最大的bitmap对象)
LimitedAgeMemoryCache（当 bitmap加入缓存中的时间超过我们设定的值，将其删除）

3.只使用弱引用缓存
WeakMemoryCache（这个类缓存bitmap的总大小没有限制，唯一不足的地方就是不稳定，缓存的图片容易被回收掉）

好处：对缓存的bitmap总大小无限制；坏处：使得图片不稳定，图片极其容易被回收

注意：不要使用.cacheInMemory();

Universal-Image-Loader的硬盘缓存策略

详细的硬盘缓存策略可以移步：http://blog.csdn.net/xiaanming/article/details/27525741，下方是总结的结果：

FileCountLimitedDiscCache（可以设定缓存图片的个数，当超过设定值，删除掉最先加入到硬盘的文件）
LimitedAgeDiscCache（设定文件存活的最长时间，当超过这个值，就删除该文件）
TotalSizeLimitedDiscCache（设定缓存bitmap的最大值，当超过这个值，删除最先加入到硬盘的文件）
UnlimitedDiscCache（这个缓存类没有任何的限制）

在ImageLoaderConfiguration中配置了diskCacheSize和diskCacheFileCount，他就使用的是LruDiscCache，否则使用的是UnlimitedDiscCache

在最新的源码中还有一个硬盘缓存类可以配置，那就是LimitedAgeDiscCache，可以在ImageLoaderConfiguration.diskCache(...)配置

避免OOM

为了避免OOM，可以修改下面的配置方案：

.memoryCacheExtraOptions(480, 800) //即保存的每个缓存文件的最大长宽，大小自行配制

.threadPriority(Thread.NORM_PRIORITY - 2) //线程池中线程的个数，一般配置1-5，这里配的是3

.memoryCache(new LRULimitedMemoryCache(40*1024*1024)) //改变缓存策略，可以用弱引用

参考自：

http://blog.csdn.net/xiaanming/article/details/26810303

http://blog.csdn.net/xiaanming/article/details/27525741

http://blog.csdn.net/vipzjyno1/article/details/23206387