1. 功能介紹
1.1 Android Universal Image Loader
Android Universal Image Loader 是一個強大的、可高度定製的圖片緩存，本文簡稱爲UIL。
簡單的說 UIL 就做了一件事——獲取圖片並顯示在相應的控件上。
1.2 基本使用
1.2.1 初始化
添加完依賴後在Application或Activity中初始化ImageLoader，如下：
public class YourApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
ImageLoaderConfiguration configuration = new ImageLoaderConfiguration.Builder(this)
// 添加你的配置需求
.build();
ImageLoader.getInstance().init(configuration);
}
}
其中 configuration 表示ImageLoader的配置信息，可包括圖片最大尺寸、線程池、緩存、下載器、解碼器等等。
1.2.2 Manifest 配置
<manifest>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<application
android:name=".YourApplication"
…… >
……
</application>
</manifest>
添加網絡權限。如果允許磁盤緩存，需要添加寫外設的權限。
1.2.3 下載顯示圖片
下載圖片，解析爲 Bitmap 並在 ImageView 中顯示。
imageLoader.displayImage(imageUri, imageView);
下載圖片，解析爲 Bitmap 傳遞給回調接口。
imageLoader.loadImage(imageUri, new SimpleImageLoadingListener() {
@Override
public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
// 圖片處理
}
});
以上是簡單使用，更復雜 API 見本文詳細設計。
1.3 特點
- 可配置度高。支持任務線程池、下載器、解碼器、內存及磁盤緩存、顯示選項等等的配置。
- 包含內存緩存和磁盤緩存兩級緩存。
- 支持多線程，支持異步和同步加載。
- 支持多種緩存算法、下載進度監聽、ListView 圖片錯亂解決等。
2. 總體設計
2.1. 總體設計圖
上面是 UIL 的總體設計圖。整個庫分爲ImageLoaderEngine，Cache及ImageDownloader，ImageDecoder，BitmapDisplayer，BitmapProcessor五大模塊，其中Cache分爲MemoryCache和DiskCache兩部分。
簡單的講就是ImageLoader收到加載及顯示圖片的任務，並將它交給ImageLoaderEngine，ImageLoaderEngine分發任務到具體線程池去執行，任務通過Cache及ImageDownloader獲取圖片，中間可能經過BitmapProcessor和ImageDecoder處理，最終轉換爲Bitmap交給BitmapDisplayer在ImageAware中顯示。
2.2. UIL 中的概念
簡單介紹一些概念，在4. 詳細設計中會仔細介紹。
ImageLoaderEngine：任務分發器，負責分發LoadAndDisplayImageTask和ProcessAndDisplayImageTask給具體的線程池去執行，本文中也稱其爲engine，具體參考4.2.6 ImageLoaderEngine.java。
ImageAware：顯示圖片的對象，可以是ImageView等，具體參考4.2.9 ImageAware.java。
ImageDownloader：圖片下載器，負責從圖片的各個來源獲取輸入流, 具體參考4.2.22 ImageDownloader.java。
Cache：圖片緩存，分爲MemoryCache和DiskCache兩部分。
MemoryCache：內存圖片緩存，可向內存緩存緩存圖片或從內存緩存讀取圖片，具體參考4.2.24 MemoryCache.java。
DiskCache：本地圖片緩存，可向本地磁盤緩存保存圖片或從本地磁盤讀取圖片，具體參考4.2.38 DiskCache.java。
ImageDecoder：圖片解碼器，負責將圖片輸入流InputStream轉換爲Bitmap對象, 具體參考4.2.53 ImageDecoder.java。
BitmapProcessor：圖片處理器，負責從緩存讀取或寫入前對圖片進行處理。具體參考4.2.61 BitmapProcessor.java。
BitmapDisplayer：將Bitmap對象顯示在相應的控件ImageAware上, 具體參考4.2.56 BitmapDisplayer.java。
LoadAndDisplayImageTask：用於加載並顯示圖片的任務, 具體參考4.2.20 LoadAndDisplayImageTask.java。
ProcessAndDisplayImageTask：用於處理並顯示圖片的任務, 具體參考4.2.19 ProcessAndDisplayImageTask.java。
DisplayBitmapTask：用於顯示圖片的任務, 具體參考4.2.18 DisplayBitmapTask.java。
3. 流程圖
上圖爲圖片加載及顯示流程圖，在 uil 庫中給出，這裏用中文重新畫出。
4. 詳細設計
4.1 類關係圖
4.2 核心類功能介紹
4.2.1 ImageLoader.java
圖片加載器，對外的主要 API，採取了單例模式，用於圖片的加載和顯示。
主要函數：
(1). getInstance()
得到ImageLoader的單例。通過雙層是否爲 null 判斷提高性能。
(2). init(ImageLoaderConfiguration configuration)
初始化配置參數，參數configuration爲ImageLoader的配置信息，包括圖片最大尺寸、任務線程池、磁盤緩存、下載器、解碼器等等。
實現中會初始化ImageLoaderEngine engine屬性，該屬性爲任務分發器。
(3). displayImage(String uri, ImageAware imageAware, DisplayImageOptions options, ImageLoadingListener listener, ImageLoadingProgressListener progressListener)
加載並顯示圖片或加載並執行回調接口。ImageLoader 加載圖片主要分爲三類接口：
displayImage(…)表示異步加載並顯示圖片到對應的ImageAware上。loadImage(…)表示異步加載圖片並執行回調接口。loadImageSync(…)表示同步加載圖片。
以上三類接口最終都會調用到這個函數進行圖片加載。函數參數解釋如下：
uri: 圖片的 uri。uri 支持多種來源的圖片，包括 http、https、file、content、assets、drawable 及自定義，具體介紹可見ImageDownloader。
imageAware: 一個接口，表示需要加載圖片的對象，可包裝 View。
options: 圖片顯示的配置項。比如加載前、加載中、加載失敗應該顯示的佔位圖片，圖片是否需要在磁盤緩存，是否需要在內存緩存等。
listener: 圖片加載各種時刻的回調接口，包括開始加載、加載失敗、加載成功、取消加載四個時刻的回調函數。
progressListener: 圖片加載進度的回調接口。
函數流程圖如下：
4.2.2 ImageLoaderConfiguration.java
ImageLoader的配置信息，包括圖片最大尺寸、線程池、緩存、下載器、解碼器等等。
主要屬性：
(1). Resources resources
程序本地資源訪問器，用於加載DisplayImageOptions中設置的一些 App 中圖片資源。
(2). int maxImageWidthForMemoryCache
內存緩存的圖片最大寬度。
(3). int maxImageHeightForMemoryCache
內存緩存的圖片最大高度。
(4). int maxImageWidthForDiskCache
磁盤緩存的圖片最大寬度。
(5). int maxImageHeightForDiskCache
磁盤緩存的圖片最大高度。
(6). BitmapProcessor processorForDiskCache
圖片處理器，用於處理從磁盤緩存中讀取到的圖片。
(7). Executor taskExecutor
ImageLoaderEngine中用於執行從源獲取圖片任務的 Executor。
(18). Executor taskExecutorForCachedImages
ImageLoaderEngine中用於執行從緩存獲取圖片任務的 Executor。
(19). boolean customExecutor
用戶是否自定義了上面的 taskExecutor。
(20). boolean customExecutorForCachedImages
用戶是否自定義了上面的 taskExecutorForCachedImages。
(21). int threadPoolSize
上面兩個默認線程池的核心池大小，即最大併發數。
(22). int threadPriority
上面兩個默認線程池的線程優先級。
(23). QueueProcessingType tasksProcessingType
上面兩個默認線程池的線程隊列類型。目前只有 FIFO, LIFO 兩種可供選擇。
(24). MemoryCache memoryCache
圖片內存緩存。
(25). DiskCache diskCache
圖片磁盤緩存，一般放在 SD 卡。
(26). ImageDownloader downloader
圖片下載器。
(27). ImageDecoder decoder
圖片解碼器，內部可使用我們常用的BitmapFactory.decode(…)將圖片資源解碼成Bitmap對象。
(28). DisplayImageOptions defaultDisplayImageOptions
圖片顯示的配置項。比如加載前、加載中、加載失敗應該顯示的佔位圖片，圖片是否需要在磁盤緩存，是否需要在內存緩存等。
(29). ImageDownloader networkDeniedDownloader
不允許訪問網絡的圖片下載器。
(30). ImageDownloader slowNetworkDownloader
慢網絡情況下的圖片下載器。
4.2.3 ImageLoaderConfiguration.Builder.java 靜態內部類
Builder 模式，用於構造參數繁多的ImageLoaderConfiguration。
其屬性與ImageLoaderConfiguration類似，函數多是屬性設置函數。
主要函數及含義：
(1). build()
按照配置，生成 ImageLoaderConfiguration。代碼如下：
public ImageLoaderConfiguration build() {
initEmptyFieldsWithDefaultValues();
return new ImageLoaderConfiguration(this);
}
(2). initEmptyFieldsWithDefaultValues()
初始化值爲null的屬性。若用戶沒有配置相關項，UIL 會通過調用DefaultConfigurationFactory中的函數返回一個默認值當配置。taskExecutorForCachedImages、taskExecutor及ImageLoaderEngine的taskDistributor的默認值如下：
| parameters | taskDistributor | taskExecutorForCachedImages/taskExecutor |
|---|---|---|
| corePoolSize | 0 | 3 |
| maximumPoolSize | Integer.MAX_VALUE | 3 |
| keepAliveTime | 60 | 0 |
| unit | SECONDS | MILLISECONDS |
| workQueue | SynchronousQueue | LIFOLinkedBlockingDeque / LinkedBlockingQueue |
| priority | 5 | 3 |
diskCacheFileNameGenerator默認值爲HashCodeFileNameGenerator。memoryCache默認值爲LruMemoryCache。如果內存緩存不允許緩存一張圖片的多個尺寸，則用FuzzyKeyMemoryCache做封裝，同一個圖片新的尺寸會覆蓋緩存中該圖片老的尺寸。diskCache默認值與diskCacheSize和diskCacheFileCount值有關，如果他們有一個大於 0，則默認爲LruDiskCache，否則使用無大小限制的UnlimitedDiskCache。downloader默認值爲BaseImageDownloader。decoder默認值爲BaseImageDecoder。
詳細及其他屬性默認值請到DefaultConfigurationFactory中查看。
(3). denyCacheImageMultipleSizesInMemory()
設置內存緩存不允許緩存一張圖片的多個尺寸，默認允許。
後面會講到 View 的 getWidth() 在初始化前後的不同值與這個設置的關係。
(4). diskCacheSize(int maxCacheSize)
設置磁盤緩存的最大字節數，如果大於 0 或者下面的maxFileCount大於 0，默認的DiskCache會用LruDiskCache，否則使用無大小限制的UnlimitedDiskCache。
(5). diskCacheFileCount(int maxFileCount)
設置磁盤緩存文件夾下最大文件數，如果大於 0 或者上面的maxCacheSize大於 0，默認的DiskCache會用LruDiskCache，否則使用無大小限制的UnlimitedDiskCache。
4.2.4 ImageLoaderConfiguration.NetworkDeniedImageDownloader.java 靜態內部類
不允許訪問網絡的圖片下載器，實現了ImageDownloader接口。
實現也比較簡單，包裝一個ImageDownloader對象，通過在 getStream(…) 函數中禁止 Http 和 Https Scheme 禁止網絡訪問，如下：
@Override
public InputStream getStream(String imageUri, Object extra) throws IOException {
switch (Scheme.ofUri(imageUri)) {
case HTTP:
case HTTPS:
throw new IllegalStateException();
default:
return wrappedDownloader.getStream(imageUri, extra);
}
}
4.2.5 ImageLoaderConfiguration.SlowNetworkImageDownloader.java 靜態內部類
慢網絡情況下的圖片下載器，實現了ImageDownloader接口。
通過包裝一個ImageDownloader對象實現，在 getStream(…) 函數中當 Scheme 爲 Http 和 Https 時，用FlushedInputStream代替InputStream處理慢網絡情況，具體見後面FlushedInputStream的介紹。
4.2.6 ImageLoaderEngine.java
LoadAndDisplayImageTask和ProcessAndDisplayImageTask任務分發器，負責分發任務給具體的線程池。
主要屬性：
(1). ImageLoaderConfiguration configuration
ImageLoader的配置信息，可包括圖片最大尺寸、線程池、緩存、下載器、解碼器等等。
(2). Executor taskExecutor
用於執行從源獲取圖片任務的 Executor，爲configuration中的 taskExecutor，如果爲null，則會調用DefaultConfigurationFactory.createExecutor(…)根據配置返回一個默認的線程池。
(3). Executor taskExecutorForCachedImages
用於執行從緩存獲取圖片任務的 Executor，爲configuration中的 taskExecutorForCachedImages，如果爲null，則會調用DefaultConfigurationFactory.createExecutor(…)根據配置返回一個默認的線程池。
(4). Executor taskDistributor
任務分發線程池，任務指LoadAndDisplayImageTask和ProcessAndDisplayImageTask，因爲只需要分發給上面的兩個 Executor 去執行任務，不存在較耗時或阻塞操作，所以用無併發數(Int 最大值)限制的線程池即可。
(5). Map cacheKeysForImageAwares
ImageAware與內存緩存 key 對應的 map，key 爲ImageAware的 id，value 爲內存緩存的 key。
(6). Map uriLocks
圖片正在加載的重入鎖 map，key 爲圖片的 uri，value 爲標識其正在加載的重入鎖。
(7). AtomicBoolean paused
是否被暫停。如果爲true，則所有新的加載或顯示任務都會等待直到取消暫停(爲false)。
(8). AtomicBoolean networkDenied
是否不允許訪問網絡，如果爲true，通過ImageLoadingListener.onLoadingFailed(…)獲取圖片，則所有不在緩存中需要網絡訪問的請求都會失敗，返回失敗原因爲網絡訪問被禁止。
(9). AtomicBoolean slowNetwork
是否是慢網絡情況，如果爲true，則自動調用SlowNetworkImageDownloader下載圖片。
(10). Object pauseLock
暫停的等待鎖，可在engine被暫停後調用這個鎖等待。
主要函數：
(1). void submit(final LoadAndDisplayImageTask task)
添加一個LoadAndDisplayImageTask。直接用taskDistributor執行一個 Runnable，在 Runnable 內部根據圖片是否被磁盤緩存過確定使用taskExecutorForCachedImages還是taskExecutor執行該 task。
(2). void submit(ProcessAndDisplayImageTask task)
添加一個ProcessAndDisplayImageTask。直接用taskExecutorForCachedImages執行該 task。
(3). void pause()
暫停圖片加載任務。所有新的加載或顯示任務都會等待直到取消暫停(爲false)。
(4). void resume()
繼續圖片加載任務。
(5). stop()
暫停所有加載和顯示圖片任務並清除這裏的內部屬性值。
(6). fireCallback(Runnable r)
taskDistributor立即執行某個任務。
(7). getLockForUri(String uri)
得到某個 uri 的重入鎖，如果不存在則新建。
(8). createTaskExecutor()
調用DefaultConfigurationFactory.createExecutor(…)創建一個線程池。
(9). getLoadingUriForView(ImageAware imageAware)
得到某個imageAware正在加載的圖片 uri。
(10). prepareDisplayTaskFor(ImageAware imageAware, String memoryCacheKey)
準備開始一個Task。向cacheKeysForImageAwares中插入ImageAware的 id 和圖片在內存緩存中的 key。
(11). void cancelDisplayTaskFor(ImageAware imageAware)
取消一個顯示任務。從cacheKeysForImageAwares中刪除ImageAware對應元素。
(12). denyNetworkDownloads(boolean denyNetworkDownloads)
設置是否不允許網絡訪問。
(13). handleSlowNetwork(boolean handleSlowNetwork)
設置是否慢網絡情況。
4.2.7 DefaultConfigurationFactory.java
爲ImageLoaderConfiguration及ImageLoaderEngine提供一些默認配置。
主要函數：
(1). createExecutor(int threadPoolSize, int threadPriority, QueueProcessingType tasksProcessingType)
創建線程池。threadPoolSize表示核心池大小(最大併發數)。threadPriority表示線程優先級。tasksProcessingType表示線程隊列類型，目前只有 FIFO, LIFO 兩種可供選擇。
內部實現會調用createThreadFactory(…)返回一個支持線程優先級設置，並且以固定規則命名新建的線程的線程工廠類DefaultConfigurationFactory.DefaultThreadFactory。
(2). createTaskDistributor()
爲ImageLoaderEngine中的任務分發器taskDistributor提供線程池，該線程池爲 normal 優先級的無併發大小限制的線程池。
(3). createFileNameGenerator()
返回一個HashCodeFileNameGenerator對象，即以 uri HashCode 爲文件名的文件名生成器。
(4). createDiskCache(Context context, FileNameGenerator diskCacheFileNameGenerator, long diskCacheSize, int diskCacheFileCount)
創建一個 Disk Cache。如果 diskCacheSize 或者 diskCacheFileCount 大於 0，返回一個LruDiskCache，否則返回無大小限制的UnlimitedDiskCache。
(5). createMemoryCache(Context context, int memoryCacheSize)
創建一個 Memory Cache。返回一個LruMemoryCache，若 memoryCacheSize 爲 0，則設置該內存緩存的最大字節數爲 App 最大可用內存的 1/8。
這裏 App 的最大可用內存也支持系統在 Honeycomb 之後(ApiLevel >= 11) application 中android:largeHeap="true"的設置。
(6). createImageDownloader(Context context)
創建圖片下載器，返回一個BaseImageDownloader。
(7). createImageDecoder(boolean loggingEnabled)
創建圖片解碼器，返回一個BaseImageDecoder。
(8). createBitmapDisplayer()
創建圖片顯示器，返回一個SimpleBitmapDisplayer。
4.2.8 DefaultConfigurationFactory.DefaultThreadFactory
默認的線程工廠類，爲DefaultConfigurationFactory.createExecutor(…)
和DefaultConfigurationFactory.createTaskDistributor(…)
提供線程工廠。支持線程優先級設置，並且以固定規則命名新建的線程。
PS：重命名線程是個很好的習慣，它的一大作用就是方便問題排查，比如性能優化，用 TraceView 查看線程，根據名字很容易分辨各個線程。
4.2.9 ImageAware.java
需要顯示圖片的對象的接口，可包裝 View 表示某個需要顯示圖片的 View。
主要函數：
(1). View getWrappedView()
得到被包裝的 View，圖片在該 View 上顯示。
(2). getWidth() 與 getHeight()
得到寬度高度，在計算圖片縮放比例時會用到。
(3). getId()
得到唯一標識 id。ImageLoaderEngine中用這個 id 標識正在加載圖片的ImageAware和圖片內存緩存 key 的對應關係，圖片請求前會將內存緩存 key 與新的內存緩存 key 進行比較，如果不相等，則之前的圖片請求會被取消。這樣當ImageAware被複用時就不會因異步加載(前面任務未取消)而造成錯亂了。
4.2.10 ViewAware.java
封裝 Android View 來顯示圖片的抽象類，實現了ImageAware接口，利用Reference來 Warp View 防止內存泄露。
主要函數：
(1). ViewAware(View view, boolean checkActualViewSize)
構造函數。view表示需要顯示圖片的對象。checkActualViewSize表示通過getWidth()和getHeight()獲取圖片寬高時返回真實的寬和高，還是LayoutParams的寬高，true 表示返回真實寬和高。
如果爲true會導致一個問題，View在還沒有初始化完成時加載圖片，這時它的真實寬高爲 0，會取它LayoutParams的寬高，而圖片緩存的 key 與這個寬高有關，所以當View初始化完成再次需要加載該圖片時，getWidth()和getHeight()返回的寬高都已經變化，緩存 key 不一樣，從而導致緩存命中失敗會再次從網絡下載一次圖片。可通過ImageLoaderConfiguration.Builder.denyCacheImageMultipleSizesInMemory()設置不允許內存緩存緩存一張圖片的多個尺寸。
(2). setImageDrawable(Drawable drawable)
如果當前操作在主線程並且 View 沒有被回收，則調用抽象函數setImageDrawableInto(Drawable drawable, View view)去向View設置圖片。
(3). setImageBitmap(Bitmap bitmap)
如果當前操作在主線程並且 View 沒有被回收，則調用抽象函數setImageBitmapInto(Bitmap bitmap, View view)去向View設置圖片。
4.2.11 ImageViewAware.java
封裝 Android ImageView 來顯示圖片的ImageAware，繼承了ViewAware，利用Reference來 Warp View 防止內存泄露。
如果getWidth()函數小於等於 0，會利用反射獲取mMaxWidth的值作爲寬。
如果getHeight()函數小於等於 0，會利用反射獲取mMaxHeight的值作爲高。
4.2.12 NonViewAware.java
僅包含處理圖片相關信息卻沒有需要顯示圖片的 View 的ImageAware，實現了ImageAware接口。常用於加載圖片後調用回調接口而不是顯示的情況。
4.2.13 DisplayImageOptions.java
圖片顯示的配置項。比如加載前、加載中、加載失敗應該顯示的佔位圖片，圖片是否需要在磁盤緩存，是否需要在 memory 緩存等。
主要屬性及含義：
(1). int imageResOnLoading
圖片正在加載中的佔位圖片的 resource id，優先級比下面的imageOnLoading高，當存在時，imageOnLoading不起作用。
(2). int imageResForEmptyUri
空 uri 時的佔位圖片的 resource id，優先級比下面的imageForEmptyUri高，當存在時，imageForEmptyUri不起作用。
(3). int imageResOnFail
加載失敗時的佔位圖片的 resource id，優先級比下面的imageOnFail高，當存在時，imageOnFail不起作用。
(4). Drawable imageOnLoading
加載中的佔位圖片的 drawabled 對象，默認爲 null。
(5). Drawable imageForEmptyUri
空 uri 時的佔位圖片的 drawabled 對象，默認爲 null。
(6). Drawable imageOnFail
加載失敗時的佔位圖片的 drawabled 對象，默認爲 null。
(7). boolean resetViewBeforeLoading
在加載前是否重置 view，通過 Builder 構建的對象默認爲 false。
(8). boolean cacheInMemory
是否緩存在內存中，通過 Builder 構建的對象默認爲 false。
(9). boolean cacheOnDisk
是否緩存在磁盤中，通過 Builder 構建的對象默認爲 false。
(10). ImageScaleType imageScaleType
圖片的縮放類型，通過 Builder 構建的對象默認爲IN_SAMPLE_POWER_OF_2。
(11). Options decodingOptions;
爲 BitmapFactory.Options，用於BitmapFactory.decodeStream(imageStream, null, decodingOptions)得到圖片尺寸等信息。
(12). int delayBeforeLoading
設置在開始加載前的延遲時間，單位爲毫秒，通過 Builder 構建的對象默認爲 0。
(13). boolean considerExifParams
是否考慮圖片的 EXIF 信息，通過 Builder 構建的對象默認爲 false。
(14). Object extraForDownloader
下載器需要的輔助信息。下載時傳入ImageDownloader.getStream(String, Object)的對象，方便用戶自己擴展，默認爲 null。
(15). BitmapProcessor preProcessor
緩存在內存之前的處理程序，默認爲 null。
(16). BitmapProcessor postProcessor
緩存在內存之後的處理程序，默認爲 null。
(17). BitmapDisplayer displayer
圖片的顯示方式，通過 Builder 構建的對象默認爲SimpleBitmapDisplayer。
(18). Handler handler
handler 對象，默認爲 null。
(19). boolean isSyncLoading
是否同步加載，通過 Builder 構建的對象默認爲 false。
4.2.14 DisplayImageOptions.Builder.java 靜態內部類
Builder 模式，用於構造參數繁多的DisplayImageOptions。
其屬性與DisplayImageOptions類似，函數多是屬性設置函數。
4.2.15 ImageLoadingListener.java
圖片加載各種時刻的回調接口，可在圖片加載的某些點做監聽。
包括開始加載(onLoadingStarted)、加載失敗(onLoadingFailed)、加載成功(onLoadingComplete)、取消加載(onLoadingCancelled)四個回調函數。
4.2.16 SimpleImageLoadingListener.java
實現ImageLoadingListener接口，不過各個函數都是空實現，表示不在 Image 加載過程中做任何回調監聽。ImageLoader.displayImage(…)函數中當入參listener爲空時的默認值。
4.2.17 ImageLoadingProgressListener.java
Image 加載進度的回調接口。其中抽象函數
void onProgressUpdate(String imageUri, View view, int current, int total)
會在獲取圖片存儲到文件系統時被回調。其中total表示圖片總大小，爲網絡請求結果Response Header中content-length字段，如果不存在則爲 -1。
4.2.18 DisplayBitmapTask.java
顯示圖片的Task，實現了Runnable接口，必須在主線程調用。
主要函數：
(1) run()
首先判斷imageAware是否被 GC 回收，如果是直接調用取消加載回調接口ImageLoadingListener.onLoadingCancelled(…)；
否則判斷imageAware是否被複用，如果是直接調用取消加載回調接口ImageLoadingListener.onLoadingCancelled(…)；
否則調用displayer顯示圖片，並將imageAware從正在加載的 map 中移除。調用加載成功回調接口ImageLoadingListener.onLoadingComplete(…)。
對於 ListView 或是 GridView 這類會緩存 Item 的 View 來說，單個 Item 中如果含有 ImageView，在滑動過程中可能因爲異步加載及 View 複用導致圖片錯亂，這裏對imageAware是否被複用的判斷就能很好的解決這個問題。原因類似：Android
ListView 滑動過程中圖片顯示重複錯位閃爍問題原因及解決方案。
4.2.19 ProcessAndDisplayImageTask.java
處理並顯示圖片的Task，實現了Runnable接口。
主要函數：
(1) run()
主要通過 imageLoadingInfo 得到BitmapProcessor處理圖片，並用處理後的圖片和配置新建一個DisplayBitmapTask在ImageAware中顯示圖片。
4.2.20 LoadAndDisplayImageTask.java
加載並顯示圖片的Task，實現了Runnable接口，用於從網絡、文件系統或內存獲取圖片並解析，然後調用DisplayBitmapTask在ImageAware中顯示圖片。
主要函數：
(1) run()
獲取圖片並顯示，核心代碼如下：
bmp = configuration.memoryCache.get(memoryCacheKey);
if (bmp == null || bmp.isRecycled()) {
bmp = tryLoadBitmap();
...
...
...
if (bmp != null && options.isCacheInMemory()) {
L.d(LOG_CACHE_IMAGE_IN_MEMORY, memoryCacheKey);
configuration.memoryCache.put(memoryCacheKey, bmp);
}
}
……
DisplayBitmapTask displayBitmapTask = new DisplayBitmapTask(bmp, imageLoadingInfo, engine, loadedFrom);
runTask(displayBitmapTask, syncLoading, handler, engine);
從上面代碼段中可以看到先是從內存緩存中去讀取 bitmap 對象，若 bitmap 對象不存在，則調用 tryLoadBitmap() 函數獲取 bitmap 對象，獲取成功後若在 DisplayImageOptions.Builder 中設置了 cacheInMemory(true), 同時將 bitmap 對象緩存到內存中。
最後新建DisplayBitmapTask顯示圖片。
函數流程圖如下：
- 判斷圖片的內存緩存是否存在，若存在直接執行步驟 8；
- 判斷圖片的磁盤緩存是否存在，若存在直接執行步驟 5；
- 從網絡上下載圖片；
- 將圖片緩存在磁盤上；
- 將圖片 decode 成 bitmap 對象；
- 根據
DisplayImageOptions配置對圖片進行預處理(Pre-process Bitmap)； - 將 bitmap 對象緩存到內存中；
- 根據
DisplayImageOptions配置對圖片進行後處理(Post-process Bitmap)； - 執行
DisplayBitmapTask將圖片顯示在相應的控件上。
流程圖可以參見3. 流程圖。
(2) tryLoadBitmap()
從磁盤緩存或網絡獲取圖片，核心代碼如下：
File imageFile = configuration.diskCache.get(uri);
if (imageFile != null && imageFile.exists()) {
...
bitmap = decodeImage(Scheme.FILE.wrap(imageFile.getAbsolutePath()));
}
if (bitmap == null || bitmap.getWidth() <= 0 || bitmap.getHeight() <= 0) {
...
String imageUriForDecoding = uri;
if (options.isCacheOnDisk() && tryCacheImageOnDisk()) {
imageFile = configuration.diskCache.get(uri);
if (imageFile != null) {
imageUriForDecoding = Scheme.FILE.wrap(imageFile.getAbsolutePath());
}
}
checkTaskNotActual();
bitmap = decodeImage(imageUriForDecoding);
...
}
首先根據 uri 看看磁盤中是不是已經緩存了這個文件，如果已經緩存，調用 decodeImage 函數，將圖片文件 decode 成 bitmap 對象；如果 bitmap 不合法或緩存文件不存在，判斷是否需要緩存在磁盤，需要則調用tryCacheImageOnDisk()函數去下載並緩存圖片到本地磁盤，再通過decodeImage(imageUri)函數將圖片文件 decode 成 bitmap 對象，否則直接通過decodeImage(imageUriForDecoding)下載圖片並解析。
(3) tryCacheImageOnDisk()
下載圖片並存儲在磁盤內，根據磁盤緩存圖片最長寬高的配置處理圖片。
loaded = downloadImage();
主要就是這一句話，調用下載器下載並保存圖片。
如果你在ImageLoaderConfiguration中還配置了maxImageWidthForDiskCache或者maxImageHeightForDiskCache，還會調用resizeAndSaveImage()函數，調整圖片尺寸，並保存新的圖片文件。
(4) downloadImage()
下載圖片並存儲在磁盤內。調用getDownloader()得到ImageDownloader去下載圖片。
(4) resizeAndSaveImage(int maxWidth, int maxHeight)
從磁盤緩存中得到圖片，重新設置大小及進行一些處理後保存。
(5) getDownloader()
根據ImageLoaderEngine配置得到下載器。
如果不允許訪問網絡，則使用不允許訪問網絡的圖片下載器NetworkDeniedImageDownloader；如果是慢網絡情況，則使用慢網絡情況下的圖片下載器SlowNetworkImageDownloader；否則直接使用ImageLoaderConfiguration中的downloader。
4.2.21 ImageLoadingInfo.java
加載和顯示圖片任務需要的信息。String uri 圖片 url。String memoryCacheKey 圖片緩存 key。ImageAware imageAware 需要加載圖片的對象。ImageSize targetSize 圖片的顯示尺寸。DisplayImageOptions options 圖片顯示的配置項。ImageLoadingListener listener 圖片加載各種時刻的回調接口。ImageLoadingProgressListener progressListener 圖片加載進度的回調接口。ReentrantLock loadFromUriLock 圖片加載中的重入鎖。
4.2.22 ImageDownloader.java
圖片下載接口。待實現函數
getStream(String imageUri, Object extra)
表示通過 uri 得到 InputStream。
通過內部定義的枚舉Scheme, 可以看出 UIL 支持哪些圖片來源。
HTTP("http"), HTTPS("https"), FILE("file"), CONTENT("content"), ASSETS("assets"), DRAWABLE("drawable"), UNKNOWN("");
4.2.23 BaseImageDownloader.java
ImageDownloader的具體實現類。得到上面各種Scheme對應的圖片 InputStream。
主要函數
(1). getStream(String imageUri, Object extra)
在getStream(…)函數內根據不同Scheme類型獲取圖片輸入流。
@Override
public InputStream getStream(String imageUri, Object extra) throws IOException {
switch (Scheme.ofUri(imageUri)) {
case HTTP:
case HTTPS:
return getStreamFromNetwork(imageUri, extra);
case FILE:
return getStreamFromFile(imageUri, extra);
case CONTENT:
return getStreamFromContent(imageUri, extra);
case ASSETS:
return getStreamFromAssets(imageUri, extra);
case DRAWABLE:
return getStreamFromDrawable(imageUri, extra);
case UNKNOWN:
default:
return getStreamFromOtherSource(imageUri, extra);
}
}
具體見下面各函數介紹。
(2). getStreamFromNetwork(String imageUri, Object extra)
通過HttpURLConnection從網絡獲取圖片的InputStream。支持 response code 爲 3xx 的重定向。這裏有個小細節代碼如下：
try {
imageStream = conn.getInputStream();
} catch (IOException e) {
// Read all data to allow reuse connection (http://bit.ly/1ad35PY)
IoUtils.readAndCloseStream(conn.getErrorStream());
throw e;
}
在發生異常時會調用conn.getErrorStream()繼續讀取 Error Stream，這是爲了利於網絡連接回收及複用。但有意思的是在 Froyo(2.2) 之前，HttpURLConnection 有個重大 Bug，調用 close() 函數會影響連接池，導致連接複用失效，不少庫通過在 2.3 之前使用 AndroidHttpClient 解決這個問題。
(3). getStreamFromFile(String imageUri, Object extra)
從文件系統獲取圖片的InputStream。如果 uri 是 video 類型，則需要單獨得到 video 的縮略圖返回，否則按照一般讀取文件操作返回。
(4). getStreamFromContent(String imageUri, Object extra)
從 ContentProvider 獲取圖片的InputStream。
如果是 video 類型，則先從MediaStore得到 video 的縮略圖返回；
如果是聯繫人類型，通過ContactsContract.Contacts.openContactPhotoInputStream(res, uri)讀取內容返回。
否則通過 ContentResolver.openInputStream(…) 讀取內容返回。
(5). getStreamFromAssets(String imageUri, Object extra)
從 Assets 中獲取圖片的InputStream。
(6). getStreamFromDrawable(String imageUri, Object extra)
從 Drawable 資源中獲取圖片的InputStream。
(7). getStreamFromOtherSource(String imageUri, Object extra)
UNKNOWN(自定義)類型的處理，目前是直接拋出不支持的異常。
4.2.24 MemoryCache.java
Bitmap 內存緩存接口，需要實現的接口包括 get(…)、put(…)、remove(…)、clear()、keys()。
4.2.25 BaseMemoryCache.java
實現了MemoryCache主要函數的抽象類，以 Map\> softMap 做爲緩存池，利於虛擬機在內存不足時回收緩存對象。提供抽象函數：
protected abstract Reference<Bitmap> createReference(Bitmap value)
表示根據 Bitmap 創建一個 Reference 做爲緩存對象。Reference 可以是 WeakReference、SoftReference 等。
4.2.26 WeakMemoryCache.java
以WeakReference<Bitmap>做爲緩存 value 的內存緩存，實現了BaseMemoryCache。
實現了BaseMemoryCache的createReference(Bitmap value)函數，直接返回一個new WeakReference<Bitmap>(value)做爲緩存 value。
4.2.27 LimitedMemoryCache.java
限制總字節大小的內存緩存，繼承自BaseMemoryCache的抽象類。
會在 put(…) 函數中判斷總體大小是否超出了上限，是則循環刪除緩存對象直到小於上限。刪除順序由抽象函數
protected abstract Bitmap removeNext()
決定。抽象函數
protected abstract int getSize(Bitmap value)
表示每個元素大小。
4.2.28 LargestLimitedMemoryCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除 size 最大的元素，繼承自LimitedMemoryCache。
實現了LimitedMemoryCache緩存removeNext()函數，總是返回當前緩存中 size 最大的元素。
4.2.29 UsingFreqLimitedMemoryCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除使用次數最少的元素，繼承自LimitedMemoryCache。
實現了LimitedMemoryCache緩存removeNext()函數，總是返回當前緩存中使用次數最少的元素。
4.2.30 LRULimitedMemoryCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除最近最少使用的元素，繼承自LimitedMemoryCache。
通過new LinkedHashMap<String, Bitmap>(10, 1.1f, true)作爲緩存池。LinkedHashMap 第三個參數表示是否需要根據訪問順序(accessOrder)排序，true 表示根據accessOrder排序，最近訪問的跟最新加入的一樣放到最後面，false 表示根據插入順序排序。這裏爲 true 且緩存滿時始終刪除第一個元素，即始終刪除最近最少訪問的元素。
實現了LimitedMemoryCache緩存removeNext()函數，總是返回第一個元素，即最近最少使用的元素。
4.2.31 FIFOLimitedMemoryCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除先進入緩存的元素，繼承自LimitedMemoryCache。
實現了LimitedMemoryCache緩存removeNext()函數，總是返回最先進入緩存的元素。
以上所有LimitedMemoryCache子類都有個問題，就是 Bitmap 雖然通過WeakReference<Bitmap>包裝，但實際根本不會被虛擬機回收，因爲他們子類中同時都保留了 Bitmap 的強引用。大都是 UIL 早期實現的版本，不推薦使用。
4.2.32 LruMemoryCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除最近最少使用的元素，實現了MemoryCache。LRU(Least Recently Used) 爲最近最少使用算法。
以new LinkedHashMap<String, Bitmap>(0, 0.75f, true)作爲緩存池。LinkedHashMap 第三個參數表示是否需要根據訪問順序(accessOrder)排序，true 表示根據accessOrder排序，最近訪問的跟最新加入的一樣放到最後面，false 表示根據插入順序排序。這裏爲 true 且緩存滿時始終刪除第一個元素，即始終刪除最近最少訪問的元素。
在put(…)函數中通過trimToSize(int maxSize)函數判斷總體大小是否超出了上限，是則刪除第緩存池中第一個元素，即最近最少使用的元素，直到總體大小小於上限。
LruMemoryCache功能上與LRULimitedMemoryCache類似，不過在實現上更加優雅。用簡單的實現接口方式，而不是不斷繼承的方式。
4.2.33 LimitedAgeMemoryCache.java
限制了對象最長存活週期的內存緩存。MemoryCache的裝飾者，相當於爲MemoryCache添加了一個特性。以一個MemoryCache內存緩存和一個 maxAge 做爲構造函數入參。在 get(…) 時判斷如果對象存活時間已經超過設置的最長時間，則刪除。
4.2.34 FuzzyKeyMemoryCache.java
可以將某些原本不同的 key 看做相等，在 put 時刪除這些相等的 key。MemoryCache的裝飾者，相當於爲MemoryCache添加了一個特性。以一個MemoryCache內存緩存和一個 keyComparator 做爲構造函數入參。在 put(…) 時判斷如果 key 與緩存中已有 key 經過Comparator比較後相等，則刪除之前的元素。
4.2.35 FileNameGenerator.java
根據 uri 得到文件名的接口。
4.2.36 HashCodeFileNameGenerator.java
以 uri 的 hashCode 作爲文件名。
4.2.37 Md5FileNameGenerator.java
以 uri 的 MD5 值作爲文件名。
4.2.38 DiskCache.java
圖片的磁盤緩存接口。
主要函數:
(1) File get(String imageUri)
根據原始圖片的 uri 去獲取緩存圖片的文件。
(2) boolean save(String imageUri, InputStream imageStream, IoUtils.CopyListener listener)
保存 imageStream 到磁盤中，listener 表示保存進度且可在其中取消某些段的保存。
(3) boolean save(String imageUri, Bitmap bitmap)
保存圖片到磁盤。
(4) boolean remove(String imageUri)
根據圖片 uri 刪除緩存圖片。
(5) void close()
關閉磁盤緩存，並釋放資源。
(6) void clear()
清空磁盤緩存。
(7) File getDirectory()
得到磁盤緩存的根目錄。
4.2.39 BaseDiskCache.java
一個無大小限制的本地圖片緩存，實現了DiskCache主要函數的抽象類。
圖片緩存在cacheDir文件夾內，當cacheDir不可用時，則使用備庫reserveCacheDir。
主要函數：
(1). save(String imageUri, InputStream imageStream, IoUtils.CopyListener listener)
先根據imageUri得到目標文件，將imageStream先寫入與目標文件同一文件夾的 .tmp 結尾的臨時文件內，若未被listener取消且寫入成功則將臨時文件重命名爲目標文件並返回 true，否則刪除臨時文件並返回 false。
(2). save(String imageUri, Bitmap bitmap)
先根據imageUri得到目標文件，通過Bitmap.compress(…)函數將bitmap先寫入與目標文件同一文件夾的 .tmp 結尾的臨時文件內，若寫入成功則將臨時文件重命名爲目標文件並返回 true，否則刪除臨時文件並返回 false。
(3). File getFile(String imageUri)
根據 imageUri 和 fileNameGenerator得到文件名，返回cacheDir內該文件，若cacheDir不可用，則使用備庫reserveCacheDir。
4.2.40 LimitedAgeDiskCache.java
限制了緩存對象最長存活週期的磁盤緩存，繼承自BaseDiskCache。
在 get(…) 時判斷如果緩存對象存活時間已經超過設置的最長時間，則刪除。在 save(…) 時保存當存時間作爲對象的創建時間。
4.2.41 UnlimitedDiskCache.java
一個無大小限制的本地圖片緩存。與BaseDiskCache無異，只是用了個意思明確的類名。
4.2.42 DiskLruCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除最近最少使用的元素。
通過緩存目錄下名爲journal的文件記錄緩存的所有操作，並在緩存open時讀取journal的文件內容存儲到LinkedHashMap<String, Entry> lruEntries中，後面get(String key)獲取緩存內容時，會先從lruEntries中得到圖片文件名返回文件。
LRU 的實現跟上面內存緩存類似，lruEntries爲new LinkedHashMap<String, Entry>(0, 0.75f, true)，LinkedHashMap 第三個參數表示是否需要根據訪問順序(accessOrder)排序，true 表示根據accessOrder排序，最近訪問的跟最新加入的一樣放到最後面，false 表示根據插入順序排序。這裏爲 true 且緩存滿時trimToSize()函數始終刪除第一個元素，即始終刪除最近最少訪問的文件。
來源於 JakeWharton 的開源項目 DiskLruCache，具體分析請等待 DiskLruCache 源碼解析 完成。
4.2.43 LruDiskCache.java
限制總字節大小的內存緩存，會在緩存滿時優先刪除最近最少使用的元素，實現了DiskCache。
內部有個DiskLruCache cache屬性，緩存的存、取操作基本都是由該屬性代理完成。
4.2.44 StrictLineReader.java
通過readLine()函數從InputStream中讀取一行，目前僅用於磁盤緩存操作記錄文件journal的解析。
4.2.45 Util.java
工具類。String readFully(Reader reader)讀取 reader 中內容。deleteContents(File dir)遞歸刪除文件夾內容。
4.2.46 ContentLengthInputStream.java
InputStream的裝飾者，可通過available()函數得到 InputStream 對應數據源的長度(總字節數)。主要用於計算文件存儲進度即圖片下載進度時的總進度。
4.2.47 FailReason.java
圖片下載及顯示時的錯誤原因，目前包括：IO_ERROR 網絡連接或是磁盤存儲錯誤。DECODING_ERROR decode image 爲 Bitmap 時錯誤。NETWORK_DENIED 當圖片不在緩存中，且設置不允許訪問網絡時的錯誤。OUT_OF_MEMORY 內存溢出錯誤。UNKNOWN 未知錯誤。
4.2.48 FlushedInputStream.java
爲了解決早期 Android 版本BitmapFactory.decodeStream(…)在慢網絡情況下 decode image 異常的 Bug。
主要通過重寫FilterInputStream的 skip(long n) 函數解決，確保 skip(long n) 始終跳過了 n 個字節。如果返回結果即跳過的字節數小於 n，則不斷循環直到 skip(long n) 跳過 n 字節或到達文件尾。
4.2.49 ImageScaleType.java
Image 的縮放類型，目前包括：NONE不縮放。NONE_SAFE根據需要以整數倍縮小圖片，使得其尺寸不超過 Texture 可接受最大尺寸。IN_SAMPLE_POWER_OF_2根據需要以 2 的 n 次冪縮小圖片，使其尺寸不超過目標大小，比較快的縮小方式。IN_SAMPLE_INT根據需要以整數倍縮小圖片，使其尺寸不超過目標大小。EXACTLY根據需要縮小圖片到寬或高有一個與目標尺寸一致。EXACTLY_STRETCHED根據需要縮放圖片到寬或高有一個與目標尺寸一致。
4.2.50 ViewScaleType.java
ImageAware的 ScaleType。
將 ImageView 的 ScaleType 簡化爲兩種FIT_INSIDE和CROP兩種。FIT_INSIDE表示將圖片縮放到至少寬度和高度有一個小於等於 View 的對應尺寸，CROP表示將圖片縮放到寬度和高度都大於等於 View 的對應尺寸。
4.2.51 ImageSize.java
表示圖片寬高的類。scaleDown(…) 等比縮小寬高。scale(…) 等比放大寬高。
4.2.52 LoadedFrom.java
圖片來源枚舉類，包括網絡、磁盤緩存、內存緩存。
4.2.53 ImageDecoder.java
將圖片轉換爲 Bitmap 的接口，抽象函數：
Bitmap decode(ImageDecodingInfo imageDecodingInfo) throws IOException;
表示根據ImageDecodingInfo信息得到圖片並根據參數將其轉換爲 Bitmap。
4.2.54 BaseImageDecoder.java
實現了ImageDecoder。調用ImageDownloader獲取圖片，然後根據ImageDecodingInfo或圖片 Exif 信息處理圖片轉換爲 Bitmap。
主要函數：
(1). decode(ImageDecodingInfo decodingInfo)
調用ImageDownloader獲取圖片，再調用defineImageSizeAndRotation(…)函數得到圖片的相關信息，調用prepareDecodingOptions(…)得到圖片縮放的比例，調用BitmapFactory.decodeStream將 InputStream 轉換爲 Bitmap，最後調用considerExactScaleAndOrientatiton(…)根據參數將圖片放大、翻轉、旋轉爲合適的樣子返回。
(2). defineImageSizeAndRotation(InputStream imageStream, ImageDecodingInfo decodingInfo)
得到圖片真實大小以及 Exif 信息(設置考慮 Exif 的條件下)。
(3). defineExifOrientation(String imageUri)
得到圖片 Exif 信息中的翻轉以及旋轉角度信息。
(4). prepareDecodingOptions(ImageSize imageSize, ImageDecodingInfo decodingInfo)
得到圖片縮放的比例。
- 如果
scaleType等於ImageScaleType.NONE，則縮放比例爲 1； - 如果
scaleType等於ImageScaleType.NONE_SAFE，則縮放比例爲(int)Math.ceil(Math.max((float)srcWidth / maxWidth, (float)srcHeight / maxHeight))； - 否則，調用
ImageSizeUtils.computeImageSampleSize(…)計算縮放比例。
在 computeImageSampleSize(…) 中 - 如果
viewScaleType等於ViewScaleType.FIT_INSIDE；
1.1 如果scaleType等於ImageScaleType.IN_SAMPLE_POWER_OF_2，則縮放比例從 1 開始不斷 *2 直到寬或高小於最大尺寸；
1.2 否則取寬和高分別與最大尺寸比例中較大值，即Math.max(srcWidth / targetWidth, srcHeight / targetHeight)。 - 如果
scaleType等於ViewScaleType.CROP；
2.1 如果scaleType等於ImageScaleType.IN_SAMPLE_POWER_OF_2，則縮放比例從 1 開始不斷 *2 直到寬和高都小於最大尺寸。
2.2 否則取寬和高分別與最大尺寸比例中較小值，即Math.min(srcWidth / targetWidth, srcHeight / targetHeight)。 - 最後判斷寬和高是否超過最大值，如果是 *2 或是 +1 縮放。
(5). considerExactScaleAndOrientatiton(Bitmap subsampledBitmap, ImageDecodingInfo decodingInfo, int rotation, boolean flipHorizontal)
根據參數將圖片放大、翻轉、旋轉爲合適的樣子返回。
4.2.55 ImageDecodingInfo.java
Image Decode 需要的信息。String imageKey 圖片。String imageUri 圖片 uri，可能是緩存文件的 uri。String originalImageUri 圖片原 uri。ImageSize targetSize 圖片的顯示尺寸。imageScaleType 圖片的 ScaleType。ImageDownloader downloader 圖片的下載器。Object extraForDownloader 下載器需要的輔助信息。boolean considerExifParams 是否需要考慮圖片 Exif 信息。Options decodingOptions 圖片的解碼信息，爲 BitmapFactory.Options。
4.2.56 BitmapDisplayer.java
在ImageAware中顯示 bitmap 對象的接口。可在實現中對 bitmap 做一些額外處理，比如加圓角、動畫效果。
4.2.57 FadeInBitmapDisplayer.java
圖片淡入方式顯示在ImageAware中，實現了BitmapDisplayer接口。
4.2.58 RoundedBitmapDisplayer.java
爲圖片添加圓角顯示在ImageAware中，實現了BitmapDisplayer接口。主要通過BitmapShader實現。
4.2.59 RoundedVignetteBitmapDisplayer.java
爲圖片添加漸變效果的圓角顯示在ImageAware中，實現了BitmapDisplayer接口。主要通過RadialGradient實現。
4.2.60 SimpleBitmapDisplayer.java
直接將圖片顯示在ImageAware中，實現了BitmapDisplayer接口。
4.2.61 BitmapProcessor.java
圖片處理接口。可用於對圖片預處理(Pre-process Bitmap)和後處理(Post-process Bitmap)。抽象函數：
public interface BitmapProcessor {
Bitmap process(Bitmap bitmap);
}
用戶可以根據自己需求去實現它。比如你想要爲你的圖片添加一個水印，那麼可以自己去實現 BitmapProcessor 接口，在DisplayImageOptions中配置 Pre-process 階段預處理圖片，這樣設置後存儲在文件系統以及內存緩存中的圖片都是加了水印後的。如果只希望在顯示時改變不動原圖片，可以在BitmapDisplayer中處理。
4.2.62 PauseOnScrollListener.java
可在 View 滾動過程中暫停圖片加載的 Listener，實現了 OnScrollListener 接口。
它的好處是防止滾動中不必要的圖片加載，比如快速滾動不希望滾動中的圖片加載。在 ListView 或 GridView 中 item 加載圖片最好使用它，簡單的一行代碼:
gridView.setOnScrollListener(new PauseOnScrollListener(ImageLoader.getInstance(), false, true));
主要的成員變量：pauseOnScroll 觸摸滑動(手指依然在屏幕上)過程中是否暫停圖片加載。pauseOnFling 甩指滾動(手指已離開屏幕)過程中是否暫停圖片加載。externalListener 自定義的 OnScrollListener 接口，適用於 View 原來就有自定義 OnScrollListener 情況設置。
實現原理：
重寫onScrollStateChanged(…)函數判斷不同的狀態下暫停或繼續圖片加載。OnScrollListener.SCROLL_STATE_IDLE表示 View 處於空閒狀態，沒有在滾動，這時候會加載圖片。OnScrollListener.SCROLL_STATE_TOUCH_SCROLL表示 View 處於觸摸滑動狀態，手指依然在屏幕上，通過pauseOnScroll變量確定是否需要暫停圖片加載。這種時候大都屬於慢速滾動瀏覽狀態，所以建議繼續圖片加載。OnScrollListener.SCROLL_STATE_FLING表示 View 處於甩指滾動狀態，手指已離開屏幕，通過pauseOnFling變量確定是否需要暫停圖片加載。這種時候大都屬於快速滾動狀態，所以建議暫停圖片加載以節省資源。
4.2.63 QueueProcessingType.java
任務隊列的處理類型，包括FIFO先進先出、LIFO後進先出。
4.2.64 LIFOLinkedBlockingDeque.java
後進先出阻塞隊列。重寫LinkedBlockingDeque的offer(…)函數如下：
@Override
public boolean offer(T e) {
return super.offerFirst(e);
}
讓LinkedBlockingDeque插入總在最前，而remove()本身始終刪除第一個元素，所以就變爲了後進先出阻塞隊列。
實際一般情況只重寫offer(…)函數是不夠的，但因爲ThreadPoolExecutor默認只用到了BlockingQueue的offer(…)函數，所以這種簡單重寫後做爲ThreadPoolExecutor的任務隊列沒問題。
LIFOLinkedBlockingDeque.java包下的LinkedBlockingDeque.java、BlockingDeque.java、Deque.java都是 Java 1.6 源碼中的，這裏不做分析。
4.2.65 DiskCacheUtils.java
磁盤緩存工具類，可用於查找或刪除某個 uri 對應的磁盤緩存。
4.2.66 MemoryCacheUtils.java
內存緩存工具類。可用於根據 uri 生成內存緩存 key，緩存 key 比較，根據 uri 得到所有相關的 key 或圖片，刪除某個 uri 的內存緩存。generateKey(String imageUri, ImageSize targetSize)
根據 uri 生成內存緩存 key，key 規則爲[imageUri]_[width]x[height]。
4.2.67 StorageUtils.java
得到圖片 SD 卡緩存目錄路徑。
緩存目錄優先選擇/Android/data/[app_package_name]/cache；若無權限或不可用，則選擇 App 在文件系統的緩存目錄context.getCacheDir()；若無權限或不可用，則選擇/data/data/[app_package_name]/cache。
如果緩存目錄選擇了/Android/data/[app_package_name]/cache，則新建.nomedia文件表示不允許類似 Galley 這些應用顯示此文件夾下圖片。不過在 4.0 系統有 Bug 這種方式不生效。
4.2.68 ImageSizeUtils.java
用於計算圖片尺寸、縮放比例相關的工具類。
4.2.69 IoUtils.java
IO 相關工具類，包括 stream 拷貝，關閉等。
4.2.70 L.java
Log 工具類。
5. 雜談
聊聊 LRU
UIL 的內存緩存默認使用了 LRU 算法。LRU: Least Recently Used 近期最少使用算法, 選用了基於鏈表結構的 LinkedHashMap 作爲存儲結構。
假設情景：內存緩存設置的閾值只夠存儲兩個 bitmap 對象，當 put 第三個 bitmap 對象時，將近期最少使用的 bitmap 對象移除。
圖 1: 初始化 LinkedHashMap, 並按使用順序來排序, accessOrder = true;
圖 2: 向緩存池中放入 bitmap1 和 bitmap2 兩個對象。
圖 3: 繼續放入第三個 bitmap3，根據假設情景，將會超過設定緩存池閾值。
圖 4: 釋放對 bitmap1 對象的引用。
圖 5: bitmap1 對象被 GC 回收。
