universal-image-loader的使用及介绍

参考:

Android Universal Image Loader 源码分析

Android-Universal-Image-Loader的GitHub地址

ImageLoader中相关配置详解

使用：

1、依赖：

compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'

2、权限

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

3、Application中配置ImageLoaderConfiguration参数

//配置一：默认
ImageLoader.getInstance().init(ImageLoaderConfiguration.createDefault(this));


//配置二：自定义
File cacheDir = StorageUtils.getCacheDirectory(context);  //缓存文件夹路径
//File cacheDir = StorageUtils.getCacheDirectory(getApplicationContext());//默认
//File cacheDir = StorageUtils.getOwnCacheDirectory(this, "imageloader/Cache");

ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
        .memoryCacheExtraOptions(480, 800) 
        // default = device screen dimensions 内存缓存文件的最大长宽
        .diskCacheExtraOptions(480, 800, null) 
        // 本地缓存的详细信息(缓存的最大长宽)，最好不要设置这个 
        .taskExecutor(...)
        .taskExecutorForCachedImages(...)
        .threadPoolSize(3) // default  线程池内加载的数量
        .threadPriority(Thread.NORM_PRIORITY - 2) 
        // default 设置当前线程的优先级
        .tasksProcessingOrder(QueueProcessingType.FIFO) 
        // default FIFO,线程池的线程队列类型。目前只有 FIFO, LIFO 两种可供选择。
        .denyCacheImageMultipleSizesInMemory()
        .memoryCache(new LruMemoryCache(2 * 1024 * 1024)) //可以通过自己的内存缓存实现
        .memoryCacheSize(2 * 1024 * 1024)  // 内存缓存的最大值
        .memoryCacheSizePercentage(13) // default
        .diskCache(new UnlimitedDiscCache(cacheDir)) 
        // default 可以自定义缓存路径  

        .diskCacheSize(50 * 1024 * 1024) // 50 Mb sd卡(本地)缓存的最大值
        .diskCacheFileCount(100)  // 可以缓存的文件数量 
        // default为使用HASHCODE对UIL进行加密命名， 还可以用MD5(new Md5FileNameGenerator())加密
        .diskCacheFileNameGenerator(new HashCodeFileNameGenerator()) 
        .imageDownloader(new BaseImageDownloader(context)) // default
        .imageDecoder(new BaseImageDecoder()) // default
        .defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // default
         .discCache(new LimitedAgeDiscCache(cacheDir, 7 * 24 * 60 * 60))
         // 自定义缓存路径,7天后自动清除缓存
        .writeDebugLogs() // 打印debug log
        .build(); //开始构建 

ImageLoader imageLoader = ImageLoader.getInstance();
if (!imageLoader.isInited()) {//避免多次配置
    imageLoader.init(config);
}

4、要显示图片的地方配置DisplayImageOptions参数

DisplayImageOptions options = new DisplayImageOptions.Builder()
                //加载图片时的图片
                .showImageOnLoading(R.drawable.ic_stub)            
                //没有图片资源时的默认图片
                .showImageForEmptyUri(R.drawable.ic_empty)         
                //加载失败时的图片
                .showImageOnFail(R.drawable.ic_error)              
                //启用内存缓存,默认false
                .cacheInMemory(true)                               
                //启用外存缓存，默认false
                .cacheOnDisk(true)                                 
                //是否考虑JPEG图像EXIF参数（旋转，翻转）启用EXIF和JPEG图像格式，默认false,// 会识别图片的方向信息
                .considerExifParams(true)                          
                //设置显示风格这里是圆角矩形，默认SimpleBitmapDisplayer
                //设置图片的显示方式：
                //        RoundedBitmapDisplayer（int roundPixels）设置圆角图片
                //        FakeBitmapDisplayer（）这个类什么都没做
                //        FadeInBitmapDisplayer（int durationMillis）设置图片渐显的时间
                //        SimpleBitmapDisplayer()正常显示一张图片
                .displayer(new RoundedBitmapDisplayer(30))         
                //默认是ARGB_8888， 使用RGB_565会比使用ARGB_8888少消耗2倍的内存
                .bitmapConfig(Bitmap.Config.RGB_565)                
                // default false //设置图片在下载前是否重置，复位,//在ImageView显示图片之前先清空已有的图片内容
                .resetViewBeforeLoading(false)  
                .delayBeforeLoading(1000)//下载前的延迟时间
                //设置图片的缩放方式:
                //        EXACTLY :图像将完全按比例缩小的目标大小
                //        EXACTLY_STRETCHED:图片会缩放到目标大小完全
                //        IN_SAMPLE_INT:图像将被二次采样的整数倍
                //        IN_SAMPLE_POWER_OF_2:图片将降低2倍，直到下一减少步骤，使图像更小的目标大小
                //        NONE:图片不会调整
                .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // default
                .handler(new Handler()) // default
                .build();
//displayImage:异步加载并显示图片
ImageLoader.getInstance().displayImage(url,imagview,options); 

注意：url可以是网络、SD卡、assets、drawable，如下：

String url = "http://sd.daicash.cn/data/avatar/f1a7eb0aa2f4dad6136f6c5b50c6f4ee/a_1501_1.jpg";// from Web

String url = "file:///mnt/sdcard/image.png"; // from SD card

String url = "assets://image.png"; // from assets

String url = "drawable://" + R.drawable.image; // from drawables(only images, non-9patch)

String url = "content://media/external/audio/albumart/13"; //from content provider

ImageLoader 加载图片主要分为三类接口：

displayImage(…) 表示异步加载并显示图片到对应的ImageAware上。
loadImage(…) 表示异步加载图片并执行回调接口。
loadImageSync(…) 表示同步加载图片。

参数介绍：

uri: 图片的 uri。uri 支持多种来源的图片，包括 http、https、file、content、assets、drawable 及自定义。
imageAware: 一个接口，表示需要加载图片的对象，可包装 View。
options: 图片显示的配置项。比如加载前、加载中、加载失败应该显示的占位图片，图片是否需要在磁盘缓存，是否需要在内存缓存等。
ImageLoadingListener: 图片加载各种时刻的回调接口，包括开始加载、加载失败、加载成功、取消加载四个时刻的回调函数。
ImageLoadingProgressListener: 图片加载进度的回调接口。

示例：

imageLoader.loadImage(url, new ImageSize(35, 35), options, new ImageLoadingListener() {
            @Override
            public void onLoadingStarted(String imageUri, View view) {

            }

            @Override
            public void onLoadingFailed(String imageUri, View view, FailReason failReason) {

            }

            @Override
            public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {

            }

            @Override
            public void onLoadingCancelled(String imageUri, View view) {

            }
        }, new ImageLoadingProgressListener() {
            @Override
            public void onProgressUpdate(String imageUri, View view, int current, int total) {

            }
        });

5、在需要清除缓存的地方可以清除缓存

ImageLoader.getInstance().clearMemoryCache();  // 清除内存缓存

ImageLoader.getInstance().clearDiskCache();  // 清除本地文件缓存

6、设置滚动是否加载

//Universal-Image-Loader提供了PauseOnScrollListener这个类来控制ListView,GridView滑动过程中停止去加载图片。

// 第一个参数就是我们的图片加载对象ImageLoader,
// 第二个参数控制是否在滑动过程中暂停加载图片，如果需要暂停传true就行了，
// 第三个参数控制猛的滑动界面的时候图片是否加载图片，如果需要暂停传true就行了，
listView.setOnScrollListener(new PauseOnScrollListener(ImageLoader.getInstance(), true, true));

关于缓存：

内存缓存默认是：LruMemoryCache，

磁盘缓存默认是：UnlimitedDiscCache。

磁盘缓存文件名默认生成方式：HashCodeFileNameGenerator

1、 内存缓存：相关类继承关系及介绍

MemoryCache：内存缓存的接口，里面定义了内存缓存的先关操作，
            比如：读取一个缓存，放入一个缓存，移除一个缓存，清空缓存
    LruMemoryCache:框架默认，lru算法，强引用
    LimitedAgeMemoryCache：超出时间则删除，强引用
    FuzzyKeyMemoryCache：同一个图片新的尺寸会覆盖缓存中该图片老的尺寸。
    BaseMemoryCache：以强或弱引用的方式保存bitmap，便于虚拟机在内存不足时回收缓存对象。
        WeakMemoryCache：弱引用
        LimitedMemoryCache：强或弱引用，限制存储容量的内存缓存策略，
                            最大容量为16M，未超出容量强引用，超出容量软引用
            FIFOLimitedMemoryCache：先进先出的缓存策略，当超过缓存限定值，
                                    先删除最先加入缓存的bitmap
            LRULimitedMemoryCache：lru算法，弱引用，当超过缓存限定值，
                                    先删除最近最少使用的bitmap
            LargestLimitedMemoryCache：当超过缓存限定值，
                                    先删除最大的bitmap
            UsingFreqLimitedMemoryCache：当超过缓存限定值，
                                    先删除使用次数最少的bitmap

2、硬盘缓存：相关类继承关系及介绍

DiskCache
    LruDiskCache：lru算法，默认缓存大小32kb,超出容量则删除最近最少使用。
    BaseDiskCache：默认缓存大小32kb
        LimitedAgeDiskCache：设定文件存活的最长时间，当超过这个值，就删除该文件
        UnlimitedDiskCache：这个缓存类没有时间限制，框架默认

3、 磁盘缓存文件名的生成：相关类继承关系及介绍

FileNameGenerator：在缓存文件时对文件名称的修改
    HashCodeFileNameGenerator：该类负责获取文件名称的hashcode然后转换成字符串。默认
    Md5FileNameGenerator：该类把源文件的名称通过md5加密后保存。

关于图片显示

相关类继承关系及介绍：

BitmapDisplayer：在ImageAware中显示bitmap对象的接口。可在实现中对bitmap做一些额外处理，比如加圆角、动画效果。
    CircleBitmapDisplayer：
            显示原型图片在ImageAware中，实现了BitmapDisplayer接口。主要通过BitmapShader实现。
    FadeInBitmapDisplayer：
            图片淡入方式显示在ImageAware中，实现了BitmapDisplayer接口。
    RoundedBitmapDisplayer：
            为图片添加圆角显示在ImageAware中，实现了BitmapDisplayer接口。主要通过BitmapShader实现。
    RoundedVignetteBitmapDisplayer：
            为图片添加渐变效果的圆角显示在ImageAware中，实现了BitmapDisplayer接口，主要通过RadialGradient实现。
    SimpleBitmapDisplayer：
            直接将图片显示在ImageAware中，实现了BitmapDisplayer接口。