Android-Universal-Image-Loader 属性设置

设置Android-Universal-Image-Loader缓存图片的目录

其默认的缓存目录是mnt/sdcard/Android/data/your project/下，因为没有提供接口，所以想修改只能改其源代码。

1.到https://github.com/nostra13/Android-Universal-Image-Loader把源代码拿下来
2.导入library项目，修改com.nostra13.universalimageloader.utils.StorageUtils这个类，getExternalCacheDir(Context context)这个方法返回的就是缓存图片目录，getCacheDirectory(Context context)是真正返回缓存目录的方法，该怎么做就不说了，相信都明白
3.重新打成jar包使用或直接将代码拷到你的项目

 1     //设置图片在下载期间显示的图片
 2     showStubImage(R.drawable.ic_launcher)
 3     
 4     //设置图片Uri为空或是错误的时候显示的图片
 5     showImageForEmptyUri(R.drawable.ic_empty)
 6     
 7     //设置图片加载/解码过程中错误时候显示的图片
 8     showImageOnFail(R.drawable.ic_error)
 9     
10     //设置图片在下载前是否重置，复位
11     resetViewBeforeLoading()
12     
13     //设置下载的图片是否缓存在内存中
14     cacheInMemory()
15     
16     //设置下载的图片是否缓存在SD卡中
17     cacheOnDisc()
18     
19     //设置图片的解码类型
20     bitmapConfig(Bitmap.Config.RGB_565)
21     
22     //设置图片的解码配置
23     decodingOptions(android.graphics.BitmapFactory.Options decodingOptions)
24     
25     //设置图片下载前的延迟
26     delayBeforeLoading(int delayInMillis) 
27     
28     //设置额外的内容给ImageDownloader
29     extraForDownloader(Object extra)
30     
31     //设置图片加入缓存前，对bitmap进行设置
32     preProcessor(BitmapProcessor preProcessor)
33     
34     //设置显示前的图片，显示后这个图片一直保留在缓存中
35     postProcessor(BitmapProcessor postProcessor) 
36     
37     //设置图片以如何的编码方式显示
38     imageScaleType(ImageScaleType imageScaleType)

2.此类的两种创建方式:

        /**
         * DisplayImageOptions 创建的两种方式。
         */
        // 创建默认的DisplayImageOptions
        DisplayImageOptions option_0 = DisplayImageOptions.createSimple();

        // 使用DisplayImageOptions.Builder()创建DisplayImageOptions
        DisplayImageOptions option_1 = new DisplayImageOptions.Builder()
                .showStubImage(R.drawable.ic_launcher)
                .showImageOnFail(R.drawable.ic_error)
                .showImageForEmptyUri(R.drawable.ic_empty).cacheInMemory()
                .cacheOnDisc().displayer(new RoundedBitmapDisplayer(20))
                .build();

3.类中的方法使用：

     /**
     * 设置图片的显示方式
     * @param displayer 
     */
    displayer(BitmapDisplayer displayer)
    displayer：
              RoundedBitmapDisplayer（int roundPixels）设置圆角图片
              FakeBitmapDisplayer（）这个类什么都没做
              FadeInBitmapDisplayer（int durationMillis）设置图片渐显的时间
　　　　　　　  SimpleBitmapDisplayer()正常显示一张图片

/**
 * 图片的缩放方式
 * @param imageScaleType
 */

    imageScaleType(ImageScaleType imageScaleType)
    imageScaleType:
                   EXACTLY :图像将完全按比例缩小的目标大小
                   EXACTLY_STRETCHED:图片会缩放到目标大小完全
                   IN_SAMPLE_INT:图像将被二次采样的整数倍
                   IN_SAMPLE_POWER_OF_2:图片将降低2倍，直到下一减少步骤，使图像更小的目标大小
                   NONE:图片不会调整

支持的URI类型
String imageUri = "http://site.com/image.png"; // 网络资源
String imageUri = "file:///mnt/sdcard/image.png"; // SD card 资源
String imageUri = "content://media/external/audio/albumart/13"; // content provider 资源
String imageUri = "assets://image.png"; // assets 资源
String imageUri = "drawable://" + R.drawable.image; // drawables 资源(针对非.9.png图片)
注：为提高效率，当使用"drawable://格式uri"时，尽量使用本地方法ImageView.setImageResource(...)

配置选项：
该项目包含2个配置选项的类：
1.ImageLoaderConfiguration 是全局配置，创建ImageLoader时使用
2.DisplayImageOptions 是局部配置，每次加载或显示图片时都可指定显示选项

ImageLoaderConfiguration 示例
//这里只是列出各种情况的例子，在设置自己的选项时不要完全拷贝这里的代码
//ImageLoaderConfiguration类中有个方法会判断如果某项没有设置，则创建默认的选项
File cacheDir = StorageUtils.getCacheDirectory(context);
ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)
.memoryCacheExtraOptions(480, 800) //解析图片时使用的最大尺寸，默认为设备屏幕宽高
.discCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null) //从网络下载图片后保存到磁盘时使用的图片尺寸及压缩方法，如果不设置则保存原始图片
.taskExecutor(...)  //加载显示图片任务，默认创建一个以FIFO（先进先出）方式调度线程池的任务
.taskExecutorForCachedImages(...)  //显示图片任务（只针对已缓存到磁盘的图片），默认创建一个以FIFO（先进先出）方式调度线程池的任务
.threadPoolSize(3) // 线程池大小，这里是默认值（注意不要设太大，否则会有OOM问题）
.threadPriority(Thread.NORM_PRIORITY - 1) // 线程优先级，这里是默认值
.tasksProcessingOrder(QueueProcessingType.FIFO) // 线程调度方式，这里是默认值
.denyCacheImageMultipleSizesInMemory()  //关闭内存缓存同一张图片不同情况尺寸，对于同一张图片，当有不同尺寸缓存时后面尺寸会覆盖前面的尺寸
.memoryCache(new LruMemoryCache(2 * 1024 * 1024))   //设置内存缓存，默认会创建缓存大小为应用可用内存总大小1/8的LruMemoryCache
.memoryCacheSize(2 * 1024 * 1024)  //设置内存缓存大小
.memoryCacheSizePercentage(13) // 设置内存缓存大小在应用可用总内存大小的比例
.discCache(new UnlimitedDiscCache(cacheDir)) // 磁盘缓存，这里是默认方式
.discCacheSize(50 * 1024 * 1024)  //磁盘缓存大小
.discCacheFileCount(100)   //磁盘缓存文件数量（如果使用FileCountLimitedDiscCache）
.discCacheFileNameGenerator(new HashCodeFileNameGenerator()) // 磁盘缓存时文件命名方法，这里是默认值。另外该库还提供了MD5方式命名。
.imageDownloader(new BaseImageDownloader(context)) // 图片下载器，这里是默认方式
.imageDecoder(new BaseImageDecoder()) // 图片解码器，这里为默认方式
.defaultDisplayImageOptions(DisplayImageOptions.createSimple()) // 图片显示器，这里是默认方式
.writeDebugLogs()  //是否打印调试log
.build();

DisplayImageOptions 示例：
//这里只是列出各种情况的例子，在设置自己的选项时不要完全拷贝这里的代码
DisplayImageOptions options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub) // 加载图片时显示的图标
.showImageForEmptyUri(R.drawable.ic_empty) // uri为空时显示的图标
.showImageOnFail(R.drawable.ic_error) // 下载图片失败时显示的图标
.resetViewBeforeLoading(false)  // 加载图片前是否清空ImageView，默认为false
.delayBeforeLoading(1000) //加载图片前延迟时间，默认为0
.cacheInMemory(false) // 是否启用内存缓存，默认为false
.cacheOnDisc(false) // 是否启用磁盘缓存，默认为false
.preProcessor(...)  //图片处理函数，在图片缓存到内存之前运行
.postProcessor(...) //图片处理函数，在图片缓存到内存之后但显示图片之前运行
.extraForDownloader(...)  //下载图片时额外信息
.considerExifParams(false) // 解析图片时是否考虑JPEG图片的Exif信息，默认为false
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // 解析图片时缩放因子，这里是默认值
.bitmapConfig(Bitmap.Config.ARGB_8888) // 解析图片时采用的色彩格式，这里是默认值
.decodingOptions(...)  //解析图片时的option参数，该参数会覆盖上面的bitmapConfig中的参数，但其中的inSampleSize会被忽略，其采用imageScaleType设定的值
.displayer(new SimpleBitmapDisplayer()) // 图片显示器，这里是默认方式
.handler(new Handler()) // UI线程handler，用于绑定ImageView和Bitmap
.build();

ImageLoaderEngine： 控制并发任务
LoadAndDisplayImageTask：加载和显示图片任务
xxxImageDownloader： 负责从网络，文件等获取图片数据流
xxxImageDecoder：解析图片
xxxBitmapDisplayer: 负责显示图片效果
  SimpleBitmapDisplayer：直接显示图片
  FadeInBitmapDisplayer：淡入淡出效果
  RoundedBitmapDisplayer：显示圆角
  RoundedVignetteBitmapDisplayer：圆角带光晕效果
 
Cache: 缓存
  MemoryCache: 内存缓存，通常使用元素为<String,Bitmap> 的Map来维护缓存内容
WeakMemoryCache：弱引用缓存，简单地对每个bitmap做弱引用
FuzzyKeyMemoryCache：可以传入比较规则，将不同的key视作相同，这样Map中新加元素时会将原来对应key的value覆盖
LruMemoryCache：当缓存容量超过最大值时，删除最近最少使用的对象
LRULimitedMemoryCache：当缓存容量超过最大值时，删除最近最少使用的对象
FIFOLimitedMemoryCache：当缓存容量超过最大值时，删除最先放入队列的对象
LargestLimitedMemoryCache：当缓存容量超过最大值时，删除当前最大的对象
LimitedAgeMemoryCache：当缓存容量超过最大值时，删除存活时间最长的对象
UsingFreqLimitedMemoryCache：当缓存容量超过最大值时，删除最不常使用的对象

  DiscCache: 磁盘缓存，使用元素为<String,Key>的Map来维护缓存内容
UnlimitedDiscCache：无限制
LimitedAgeDiscCache：当缓存对象缓存时间超过设定值时，将会被删除
TotalSizeLimitedDiscCache：当缓存容量超过最大值时，删除最不活跃的对象（上一次使用时间最早的对象）
FileCountLimitedDiscCache：当缓存文件数量超过最大值时，删除最不活跃的对象（上一次使用时间最早的对象）