内容简介:UniversalImageLoader的用法总结
作为图片加载类库的”老大哥”,相信大部分人都用过它!
不管是自己再项目里面用,还是自己造轮子,了解UIL的用法和框架原理都是有帮助的!
下面就来总结下UIL的基本使用!
UIL的功能及优点
-
支持从网络,本地,项目内读取图片
-
多线程下载图片
-
支持图片下载进度监听
-
支持图片加载起始,加载中,加载结束等毁掉函数
-
包含内存缓存和磁盘缓存, 并可进行缓存大小等参数的配置
-
支持占位图,及图片加载过程中图片,以及图片加载失败图片的显示
-
支持图片加载成功后再处理
-
支持对bitmap裁剪等处理
-
可在ListView等滚动控件发生滚动时,暂定图片加载
-
提供在网路较慢时图片的加载
-
扩展性强,内存缓存和磁盘缓存策略可自行实现,图片加载各种参数也可自由配置!
UIL的使用
方式一:
下载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" />
接着, 配置UIL的初始化:
ImageLoaderConfiguration configuration = ImageLoaderConfiguration.createDefault(this); ImageLoader.getInstance().init(configuration);
通过上面两行代码就可以完成UIL的初始配置!不错这是最简单的配置, 后面会详细说具体的配置!
然后需要配置显示图片的相关参数,比如图片是否需要缓存,是否需要占位图,是否需要圆角处理等等
DisplayImageOptions imageOptions = DisplayImageOptions.createSimple();
老规矩,还是先来个最简单的配置。
最后就显示图片了
ImageLoader.getInstance().displayImage("http://img.hb.aicdn.com/278475ced55b8361e0d2beb9b568dd225f1c8c9d1593b-1F63BW_fw658", imageView1, imageOptions);
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());
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() { }
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); } }
所以当没有设置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() // 图片加入缓存之前的处理 .postProcessor() // 图片 .decodingOptions(BitmapFactory.Options) // 解码参数 .cacheInMemory(true) // 需要缓存在内存中 .cacheOnDisk(true) // 需要缓存到磁盘中 .considerExifParams(true) // .imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2) // 缩放类型 .bitmapConfig(Bitmap.Config.RGB_565) // bitmap模式 .displayer(new RoundedBitmapDisplayer(20)) // 设置图片显示形式(圆角 or 渐变等) .build();
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); }
也可以使用它的实现类 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 } }
按照项目所需进行配置即可!!!
滚动时暂定加载
当使用ListView,RecyclerView, GridView的时候,滚动屏幕时暂停图片加载可减少界面卡顿!
listView.setOnScrollListener(new PauseOnScrollListener(ImageLoader.getInstance(), true, true));
gridView.setOnScrollListener(new PauseOnScrollListener(imageLoader, pauseOnScroll, pauseOnFling));
recyclerView.addOnScrollListener(new RVPauseOnScrollListener(ImageLoader.getInstance(), true, true));
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; } } }
源码请移步:
https://github.com/crazy1235/About-Image/tree/master/UniversalImageLoaderDemo
OVER !!!~
以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网
猜你喜欢:本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。
《电脑报》2005年合订本(上下)
电脑报社主编 / 西南师范大学出版社 / 2006-1 / 45.00元
全套上、下两册,浓缩2005年电脑报精华文章;附录包含70余篇简明IT应用指南,涵盖软件、硬件、数码、网络四大领域,配赠权威实用的2005-2006中国计算机年鉴光盘,近1.4GB海量信息与资源超值奉献,提供2005-2006全系列硬件、数码产品资讯,兼具知识性与资料性,连结购买每年《电脑报合订本》,你将拥有一套完整的实用大型电脑文库。一起来看看 《《电脑报》2005年合订本(上下)》 这本书的介绍吧!