本文主要是介绍imageLoader解析,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
ImageLoader
是最早开源的Android
图片缓存库, 强大的缓存机制, 早期使用这个图片加载框架的android应用非常多, 至今仍然有不少Android
开发者在使用。
ImagerLoader特征
- 支持本地、网络图片,且支持图片下载的进度监听
- 支持个性化配置ImagerLoader,如线程池,内存缓存策略,图片显示选项等
- 三层缓存加快图片的加载速度
- 支持图片压缩
开始使用
鉴于这篇是对ImageLoader源码来进行解析,我们首先回顾一下ImageLoader
的使用。
可以通过这里下载universal-imager-loader
的jar包,并将其导入到自己的项目中。
然后可以在Application
或者Activity
中初始化ImageLoade
,参考如下:
public class YourApplication extends Application {@Overridepublic void onCreate() {super.onCreate();//创建默认的ImageLoader配置参数 ImageLoaderConfiguration configuration = ImageLoaderConfiguration .createDefault(this); //Initialize ImageLoader with configuration. ImageLoader.getInstance().init(configuration); }
}
当然,如果涉及到网络操作和磁盘缓存的话,有或者是在Application
中进行初始化的话,记得要在Manifest
中进行申明:
<manifest> <uses-permission android:name="android.permission.INTERNET" /> <!-- Include next permission if you want to allow UIL to cache images on SD card --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> ... <application android:name="YourApplication"> ... </application>
</manifest>
接下来我们就可以愉快的来加载图片了,如下所示:
ImageLoader.getInstance().displayImage(imageUri, imageView);
当然,如果你想添加监听,可以这么写:
ImageLoader.getInstance().loadImage(imageUrl, new SimpleImageLoadingListener(){ @Override public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) { super.onLoadingComplete(imageUri, view, loadedImage); mImageView.setImageBitmap(loadedImage); } });
至于更多的用法这里就不介绍了,如果有需要,可以参看这篇博客,了解更多关于ImageLoader的用法。下面就开始了源码的解析之路。
ImageLoaderConfiguration配置实现
我们首先还是从imageLoader
的配置开始开始源码的探究之旅把。在上面的使用实例中,我们使用createDefault()
方法来初始化配置,那么imageLoader
的默认配置究竟是些什么呢?下面直接上代码:
public static ImageLoaderConfiguration createDefault(Context context) {return new Builder(context).build();
}public ImageLoaderConfiguration build() {initEmptyFieldsWithDefaultValues();return new ImageLoaderConfiguration(this);
}private void initEmptyFieldsWithDefaultValues() {if (taskExecutor == null) {taskExecutor = DefaultConfigurationFactory.createExecutor(threadPoolSize, threadPriority, tasksProcessingType);} else {customExecutor = true;}if (taskExecutorForCachedImages == null) {taskExecutorForCachedImages = DefaultConfigurationFactory.createExecutor(threadPoolSize, threadPriority, tasksProcessingType);} else {customExecutorForCachedImages = true;}if (diskCache == null) {if (diskCacheFileNameGenerator == null) {diskCacheFileNameGenerator = DefaultConfigurationFactory.createFileNameGenerator();}diskCache = DefaultConfigurationFactory.createDiskCache(context, diskCacheFileNameGenerator, diskCacheSize, diskCacheFileCount);}if (memoryCache == null) {memoryCache = DefaultConfigurationFactory.createMemoryCache(context, memoryCacheSize);}if (denyCacheImageMultipleSizesInMemory) {memoryCache = new FuzzyKeyMemoryCache(memoryCache, MemoryCacheUtils.createFuzzyKeyComparator());}if (downloader == null) {downloader = DefaultConfigurationFactory.createImageDownloader(context);}if (decoder == null) {decoder = DefaultConfigurationFactory.createImageDecoder(writeLogs);}if (defaultDisplayImageOptions == null) {defaultDisplayImageOptions = DisplayImageOptions.createSimple();}}
} private ImageLoaderConfiguration(final Builder builder) {resources = builder.context.getResources();//程序本地资源访问器maxImageWidthForMemoryCache = builder.maxImageWidthForMemoryCache;//内存缓存的图片最大宽度 maxImageHeightForMemoryCache = builder.maxImageHeightForMemoryCache;//内存缓存的图片最大高度 maxImageWidthForDiskCache = builder.maxImageWidthForDiskCache;//磁盘缓存的图片最大宽度 maxImageHeightForDiskCache = builder.maxImageHeightForDiskCache;//磁盘缓存的图片最大高度 processorForDiskCache = builder.processorForDiskCache;//图片处理器,用于处理从磁盘缓存中读取到的图片 taskExecutor = builder.taskExecutor;//ImageLoaderEngine中用于执行从源获取图片任务的 Executor。taskExecutorForCachedImages = builder.taskExecutorForCachedImages;//ImageLoaderEngine中用于执行从缓存获取图片任务的 Executor。threadPoolSize = builder.threadPoolSize;//上面两个默认线程池的核心池大小,即最大并发数。threadPriority = builder.threadPriority;//上面两个默认线程池的线程优先级。tasksProcessingType = builder.tasksProcessingType;//上面两个默认线程池的线程队列类型。目前只有 FIFO, LIFO 两种可供选择。diskCache = builder.diskCache;//图片磁盘缓存,一般放在 SD 卡。memoryCache = builder.memoryCache;//图片内存缓存。defaultDisplayImageOptions = builder.defaultDisplayImageOptions;//图片显示的配置项。比如加载前、加载中、加载失败应该显示的占位图片,图片是否需要在磁盘缓存,是否需要在内存缓存等。downloader = builder.downloader;//图片下载器。decoder = builder.decoder;//图片解码器,内部可使用我们常用的BitmapFactory.decode(…)将图片资源解码成Bitmap对象。customExecutor = builder.customExecutor;//用户是否自定义了上面的 taskExecutor。customExecutorForCachedImages = builder.customExecutorForCachedImages;//用户是否自定义了上面的 taskExecutorForCachedImages。networkDeniedDownloader = new NetworkDeniedImageDownloader(downloader);//不允许访问网络的图片下载器。slowNetworkDownloader = new SlowNetworkImageDownloader(downloader);//慢网络情况下的图片下载器。L.writeDebugLogs(builder.writeLogs);
}
上面的代码有点多,但是很简单也很清晰,就是一些列初始化的代码。通过一些系列的调用,在initEmptyFieldsWithDefaultValues
方法中对一些没有配置的进行的项进行配置,并通过ImageLoaderConfiguration
给出默认的参数配置。对于其中的一些配置,在上面的注释中已经表明,ImageLoaderConfiguration
中默认的配置,可以参考第48-73行。
至于initEmptyFieldsWithDefaultValues
中的配置,在这里进行简单的介绍:
* taskExecutor 从源获取图片任务的线程池
* taskExecutorForCachedImages 用于执行从缓存获取图片任务的线程池
前面两个线程池的参数如下:
核心线程数 | 最大线程数 | 空闲线程等待时间 | 容器 |
---|---|---|---|
3 | 3 | 0s | FIFO |
前面两个线程池如果用户自定义的相应的线程池来实现的话,就会将customExecutor
置为true
,或将customExecutorForCachedImages
置为true
。其实customExecutor
存在的意义就在于判断用户有没有自定义从源获取图片任务的线程池,customExecutorForCachedImages
存在的意义判断在于用户判断用户有没有重写从缓存获取图片的线程池。
* diskCacheFileNameGenerator 默认实现为HashCodeFileNameGenerator
,即用mageUri.hashCode()
值当前图片名字。
* diskCache用于表示图片磁盘的缓存,默认实现为createDiskCache
,默认的算法为LruDiskCache
算法,缓存的目录为SD卡下的/data/data/" + context.getPackageName() + "/cache/uil-images
目录下。
* memoryCache用于表示图片内存的缓存,默认实现为createMemoryCache
,默认使用的算法为LruMemoryCache
。
* denyCacheImageMultipleSizesInMemory 为true
时,表示内存缓存不允许缓存一张图片的多个尺寸。这个时候用通过FuzzyKeyMemoryCache
来构建memoryCache
* downloader表示图片下载器,默认实现为createImageDownloader
,最终通过BaseImageDownloader
构建下载器,其下载器中重要的两个参数分别为:连接超时时间connectTimeout
默认值为5分钟,读取超时时间readTimeout
默认值为20分钟。
* decoder 表示图片解码器,默认实现为createImageDecoder
,最终通过BaseImageDecoder
实现。
* defaultDisplayImageOptions 表示默认参数,最终回调到DisplayImageOptions
方法中,里面设计相关的参数初始化。这里就不展开了。
加载配置
我们首先看Application
中imgaerLoader
设置配置的方法。
ImageLoader.getInstance().init(configuration);
接下来我们继续分析上面的代码是如何将配置应用到ImageLoader中的。首先是ImageLoader.getInstance()
实例化一个ImageLoader
,通过代码来看实例化的过程:
public static ImageLoader getInstance() {if (instance == null) {synchronized (ImageLoader.class) {if (instance == null) {instance = new ImageLoader();}}}return instance;
}
可以看出来,getInstance
就是获取一个ImageLoader
实例,运用了一个双重锁的单利模式,很简单,就不做解释了。
重点看init
方法。具体在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);}}
可以看出来,init
的实现也是非常简单的。首先判断传入的configuration
参数是否为空,为空就直接抛出一个异常,不为空就判断当前类属性configuration
是否为空,类中configuration
属性为空时调用ImageLoaderEngine
构建engine
对象,否则就打印警告日志。所以整个方法中最重要的一个语句就是new ImageLoaderEngine(configuration);
。这里首先介绍一个ImageLoaderEngine
类的作用。简单描述就是ImageLoaderEngine
是任务分发器,负责分发LoadAndDisplayImageTask
和ProcessAndDisplayImageTask
给具体的线程池去执行。具体实现后面会讲到。
加载图片
通过上面两个步骤,imgaeLoder的参数配置已经设置完毕,接下来我们就可以用imageLoader加载图片了。下面是三种加载图片的方式:
加载方式一,异步加载并显示图片到对应的imagerAware上
ImageLoader.getInstance().displayImage(imageUrl,imageView);
加载方式二,异步加载图片并执行回调接口
ImageLoader.getInstance().loadImage(imageUrl,new ImageLoadingListener() {@Overridepublic void onLoadingStarted(String imageUri, View view) {}@Overridepublic void onLoadingFailed(String imageUri, View view, FailReason failReason) {}@Overridepublic void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {}
这篇关于imageLoader解析的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!