圖片加載 經(jīng)典的UIL框架

因為情懷,所以很想研究下這個框架...
先梳理一下Java知識

在Java里, 當一個對象o被創(chuàng)建時, 它被放在Heap(堆內存)里. 當GC運行的時候, 如果發(fā)現(xiàn)沒有任何引用指向o, o就會被回收以騰出內存空間. 或者換句話說, 一個對象被回收, 必須滿足兩個條件:
1)沒有任何引用指向它
2)GC被運行.
在現(xiàn)實情況寫代碼的時候, 我們往往通過把所有指向某個對象的referece置空來保證這個對象在下次GC運行的時候被回收
為了減少咱們開發(fā)者去手動置空對象,Java中引入了主要的WeakReference和SoftReference

弱引用特性:

**當一個對象僅僅被WeakReference指向, 而沒有任何其他StrongReference指向的時候, 如果GC運行,不管當前內存空間足夠與否, 那么這個對象就會被回收. **

軟引用特性:

如果一個對象只具有軟引用,則內存空間足夠,垃圾回收器就不會回收它;如果內存空間不足了,就會回收這些對象的內存。只要垃圾回收器沒有回收它,該對象就可以被程序使用。軟引用可用來實現(xiàn)內存敏感的高速緩存.

好了,有了這些概念,可以向下看了!
先看看加載圖片主入口

public void displayImage(String uri, ImageAware imageAware, DisplayImageOptions options,
            ImageSize targetSize, ImageLoadingListener listener, ImageLoadingProgressListener progressListener)  

imageAware是一個包裝類ImageViewAware對象,父類是ViewAware,可以看到它內部維護的是一個ImageView的弱引用對象:

public ViewAware(View view, boolean checkActualViewSize) {
        if (view == null) throw new IllegalArgumentException("view must not be null");

        this.viewRef = new WeakReference<View>(view);
        this.checkActualViewSize = checkActualViewSize;
    }

ImageSize是一個對寬度和高度的包裝
加載過程:
1.如果uri地址為空,那么ImageLoaderEngine取消顯示任務

void cancelDisplayTaskFor(ImageAware imageAware) {
        cacheKeysForImageAwares.remove(imageAware.getId());
}

并將空圖片設置給ImageView或者不顯示圖片,任務顯示完成,返回return
2.地址不為空,繼續(xù)向下執(zhí)行,首先檢測尺寸大小,如果大小未指定就設置屏幕的尺寸

if (targetSize == null) {
            targetSize = ImageSizeUtils.defineTargetSizeForView(imageAware, configuration.getMaxImageSize());
        }

3.繼續(xù)向下執(zhí)行,生成緩存key,并將imageAware和key一一對應關系緩存起來

String memoryCacheKey = MemoryCacheUtils.generateKey(uri, targetSize);
engine.prepareDisplayTaskFor(imageAware, memoryCacheKey);

這個key是地址和大小的拼湊

Pattern for cache key - <b>[imageUri]_[width]x[height]</b>.

4.繼續(xù)向下,根據(jù)key從內存緩存中取bitmap

Bitmap bmp = configuration.memoryCache.get(memoryCacheKey);

而這個memoryCache是初始化ImageLoaderConfiguration的時候配置的,它在什么時候被實例化的呢?
UIL初始化的時候是這么用的

ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)  
        .memoryCacheExtraOptions(480, 800) // default = device screen dimensions  
        .diskCacheExtraOptions(480, 800, CompressFormat.JPEG, 75, null)  
        .taskExecutor(...)  
        .taskExecutorForCachedImages(...)  
        .threadPoolSize(3) // default  
        .threadPriority(Thread.NORM_PRIORITY - 1) // default  
        .tasksProcessingOrder(QueueProcessingType.FIFO) // default  
        .denyCacheImageMultipleSizesInMemory()  
        .memoryCache(new LruMemoryCache(2 * 1024 * 1024))  
        .memoryCacheSize(2 * 1024 * 1024)  
        .memoryCacheSizePercentage(13) // default  
        .diskCache(new UnlimitedDiscCache(cacheDir)) // default  
        .diskCacheSize(50 * 1024 * 1024)  
        .diskCacheFileCount(100)  
        .build();  

是不是建造者模式,在build()的時候

public ImageLoaderConfiguration build() {
    initEmptyFieldsWithDefaultValues();
    return new ImageLoaderConfiguration(this);
}

初始化空值檢測

if (memoryCache == null) {
    memoryCache = DefaultConfigurationFactory.createMemoryCache(context, memoryCacheSize);
}

如果為空,也就是初始化的時候沒有指定實例對象,那么就賦值為默認的內存緩存對象,工廠模式來了

public static MemoryCache createMemoryCache(Context context, int memoryCacheSize) {
        if (memoryCacheSize == 0) {
            ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
            int memoryClass = am.getMemoryClass();
            if (hasHoneycomb() && isLargeHeap(context)) {
                memoryClass = getLargeMemoryClass(am);
            }
            memoryCacheSize = 1024 * 1024 * memoryClass / 8;
        }
        return new LruMemoryCache(memoryCacheSize);
    }

原來默認是LruMemoryCache緩存,默認大小是1/8的可用內存空間,似乎這已經(jīng)成為行業(yè)標準!


UIL框架一共提供了8種緩存策略,現(xiàn)在知道LruMemoryCache是默認的,它內部維護的是一個LinkedHashMap<String, Bitmap> map容器,
map = new LinkedHashMap<String, Bitmap>(0, 0.75f, true);
每次訪問的時候都會重新排序,把accessOrder設為true,也就是基于訪問順序 排序,每次訪問get或者put,都會把最不常用的移到表頭,如果超過了內存限制,會把最不常訪問的那個刪掉,也就是從表頭移除remove


這里從內存緩存中拿出了bitmap
1.如果不為空,沒有被回收
1.1 然后判斷options.shouldPostProcess(),是否需要額外處理bitmap
如果為true,判斷是同步還是異步

ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey,
                        options, listener, progressListener, engine.getLockForUri(uri));
ProcessAndDisplayImageTask displayTask = new ProcessAndDisplayImageTask(engine, bmp, imageLoadingInfo,
                        defineHandler(options));
if (options.isSyncLoading()) {
    displayTask.run();
} else {
    engine.submit(displayTask);
}

ProcessAndDisplayImageTask是一個Runnable 對象,如果是異步操作的話,這個任務會被分配到線程池中執(zhí)行taskExecutorForCachedImages.execute(task);
看一下線程池的初始化

 private Executor createTaskExecutor() {
         return DefaultConfigurationFactory
                .createExecutor(configuration.threadPoolSize, configuration.threadPriority,
                configuration.tasksProcessingType);
    }

線程池的大小,優(yōu)先級執(zhí)行策略的初始值,默認最多3個線程同時,先進先出的任務調度原則

private int threadPoolSize = DEFAULT_THREAD_POOL_SIZE;
private int threadPriority = DEFAULT_THREAD_PRIORITY;
private QueueProcessingType tasksProcessingType = DEFAULT_TASK_PROCESSING_TYPE;
public static final QueueProcessingType DEFAULT_TASK_PROCESSING_TYPE = QueueProcessingType.FIFO;
public static final int DEFAULT_THREAD_POOL_SIZE = 3;
public static final int DEFAULT_THREAD_PRIORITY = Thread.NORM_PRIORITY - 2;

工廠生產(chǎn)線程池執(zhí)行器過程:

public static Executor createExecutor(int threadPoolSize, int threadPriority,
            QueueProcessingType tasksProcessingType) {
        boolean lifo = tasksProcessingType == QueueProcessingType.LIFO;
        BlockingQueue<Runnable> taskQueue =
                lifo ? new LIFOLinkedBlockingDeque<Runnable>() : new LinkedBlockingQueue<Runnable>();
        return new ThreadPoolExecutor(threadPoolSize, threadPoolSize, 0L, TimeUnit.MILLISECONDS, taskQueue,
                createThreadFactory(threadPriority, "uil-pool-"));
    }

這里隊列區(qū)分了后進先出LIFO這個特殊模式!
回到異步執(zhí)行,run方法執(zhí)行

 @Override
    public void run() {
        BitmapProcessor processor = imageLoadingInfo.options.getPostProcessor();
        Bitmap processedBitmap = processor.process(bitmap);
        DisplayBitmapTask displayBitmapTask = new DisplayBitmapTask(processedBitmap, imageLoadingInfo, engine,
                LoadedFrom.MEMORY_CACHE);
        LoadAndDisplayImageTask.runTask(displayBitmapTask, imageLoadingInfo.options.isSyncLoading(), handler, engine);
    }

processor加工處理完bitmap后,交給顯示任務LoadAndDisplayImageTask顯示

@Override
    public void run() {
        if (imageAware.isCollected()) {
            L.d(LOG_TASK_CANCELLED_IMAGEAWARE_COLLECTED, memoryCacheKey);
            listener.onLoadingCancelled(imageUri, imageAware.getWrappedView());
        } else if (isViewWasReused()) {
            L.d(LOG_TASK_CANCELLED_IMAGEAWARE_REUSED, memoryCacheKey);
            listener.onLoadingCancelled(imageUri, imageAware.getWrappedView());
        } else {
            L.d(LOG_DISPLAY_IMAGE_IN_IMAGEAWARE, loadedFrom, memoryCacheKey);
            displayer.display(bitmap, imageAware, loadedFrom);
            engine.cancelDisplayTaskFor(imageAware);
            listener.onLoadingComplete(imageUri, imageAware.getWrappedView(), bitmap);
        }
    }

如果正常顯示,是交給了displayer這個顯示器,而這個顯示器默認也是配置工廠生產(chǎn)的

public static BitmapDisplayer createBitmapDisplayer() {
        return new SimpleBitmapDisplayer();
}

字面理解就是最簡單的顯示器,看看它的內容

public final class SimpleBitmapDisplayer implements BitmapDisplayer {
    @Override
    public void display(Bitmap bitmap, ImageAware imageAware, LoadedFrom loadedFrom) {
        imageAware.setImageBitmap(bitmap);
    }
}

直接imageview顯示bitmap



BitmapDisplayer是父類,那么一共有5種顯示器,還有圓形的,圓角的,漸變的等顯示器,比較豐富!
1.2回到options.shouldPostProcess(),如果為false,也就是不需要處理從內存中取出的bitmap,那么就直接交給顯示器顯示

 options.getDisplayer().display(bmp, imageAware, LoadedFrom.MEMORY_CACHE);

2.如果從內存中取出的bitmap為空或者已經(jīng)被回收了呢?繼續(xù)向下看碼

           if (options.shouldShowImageOnLoading()) {
                imageAware.setImageDrawable(options.getImageOnLoading(configuration.resources));
            } else if (options.isResetViewBeforeLoading()) {
                imageAware.setImageDrawable(null);
            }

            ImageLoadingInfo imageLoadingInfo = new ImageLoadingInfo(uri, imageAware, targetSize, memoryCacheKey,
                    options, listener, progressListener, engine.getLockForUri(uri));
            LoadAndDisplayImageTask displayTask = new LoadAndDisplayImageTask(engine, imageLoadingInfo,
                    defineHandler(options));
            if (options.isSyncLoading()) {
                displayTask.run();
            } else {
                engine.submit(displayTask);
            }

首先從配置信息中判斷是否需要在加載的時候顯示自定義加載圖片,為了體驗更好通常會顯示Loading的Icon,好了,進入核心代碼,準備從本地磁盤或者網(wǎng)絡下載圖片 ,這里和上面一樣,也是區(qū)分同步還是異步操作
2.1 如果是同步的,直接執(zhí)行run()方法
一行行的看

if (waitIfPaused()) return; 
if (delayIfNeed()) return;

首先判斷一些狀態(tài),有這么幾種情況,會返回
(1)如果任務被中斷了interrupted
(2)如果ImageAware被GC回收了
(3)如果image的地址和任務的地址不一致


ReentrantLock loadFromUriLock = imageLoadingInfo.loadFromUriLock;
loadFromUriLock.lock();

獲取鎖,從內存中獲取bitmap

bmp = configuration.memoryCache.get(memoryCacheKey);

如果bmp是不可用的,加載本地圖片

bmp = tryLoadBitmap();
File imageFile = configuration.diskCache.get(uri);

首先從硬盤中取圖片文件,如果沒有的話tryCacheImageOnDisk(),就嘗試去網(wǎng)絡下載然后緩存到磁盤上,跟進去

loaded = downloadImage();
if (loaded) {
    int width = configuration.maxImageWidthForDiskCache;
    int height = configuration.maxImageHeightForDiskCache;
    if (width > 0 || height > 0) {
        L.d(LOG_RESIZE_CACHED_IMAGE_FILE, memoryCacheKey);
        resizeAndSaveImage(width, height); // TODO : process boolean result
    }
}
private boolean downloadImage() throws IOException {
        InputStream is = getDownloader().getStream(uri, options.getExtraForDownloader());
        if (is == null) {
            L.e(ERROR_NO_IMAGE_STREAM, memoryCacheKey);
            return false;
        } else {
            try {
                return configuration.diskCache.save(uri, is, this);
            } finally {
                IoUtils.closeSilently(is);
            }
        }
    }

拿到流后給diskCache硬盤緩存保存,默認的文件名生成器是HashCodeFileNameGenerator 默認的磁盤緩存器是UnlimitedDiskCache,無限制的緩存

緩存目錄:/Android/data/[app_package_name]/cache

Hash文件名生成

public class HashCodeFileNameGenerator implements FileNameGenerator {
    @Override
    public String generate(String imageUri) {
        return String.valueOf(imageUri.hashCode());
    }
}

這里下載緩存到本地之后,resizeAndSaveImage執(zhí)行,把bitmap從剛才緩存的文件中讀上來,調整大小,然后二次保存!


好,disk緩存工作全部結束,然后要讀圖片,加載到內存并且顯示

bitmap = decodeImage(imageUriForDecoding);
private Bitmap decodeImage(String imageUri) throws IOException {
        ViewScaleType viewScaleType = imageAware.getScaleType();
        ImageDecodingInfo decodingInfo = new ImageDecodingInfo(memoryCacheKey, imageUri, uri, targetSize, viewScaleType,
                getDownloader(), options);
        return decoder.decode(decodingInfo);
    }

這里包裝了一個ImageDecodingInfo對象,倒數(shù)第二個參數(shù)是一個下載器對象,跟進去看看

private ImageDownloader getDownloader() {
        ImageDownloader d;
        if (engine.isNetworkDenied()) {
            d = networkDeniedDownloader;
        } else if (engine.isSlowNetwork()) {
            d = slowNetworkDownloader;
        } else {
            d = downloader;
        }
        return d;
    }

networkDeniedDownloader指向的是NetworkDeniedImageDownloader,它是一個裝飾器Decorator(包裹了ImageDownloader對象), 從1.8.0版本開始有了這個類,目的是為了阻止從網(wǎng)絡下載圖片,看看它的getStream()方法,根據(jù)加載地址判斷,如果是http和https開頭,就直接拋出異常了,那么只能從本地資源加載了!
slowNetworkDownloader指向的是SlowNetworkImageDownloader,同樣是一個裝飾器Decorator,它為了處理比較慢的網(wǎng)絡情況,如訪問
http://code.google.com/p/android/issues/detail?id=6066這樣的地址
downloader可以由開發(fā)者外部定義傳入,或者是默認的,BaseImageDownloader這個對象,好了3種下載器都介紹了!繼續(xù)往下看!


解碼器decoder要工作了decoder.decode(decodingInfo)
這個decoder可以開發(fā)者從外部定義傳入,默認值是BaseImageDecoder
跟進去,看如何decode的

 public Bitmap decode(ImageDecodingInfo decodingInfo) throws IOException {
        Bitmap decodedBitmap;
        ImageFileInfo imageInfo;

        InputStream imageStream = getImageStream(decodingInfo);
        if (imageStream == null) {
            L.e(ERROR_NO_IMAGE_STREAM, decodingInfo.getImageKey());
            return null;
        }
        try {
            imageInfo = defineImageSizeAndRotation(imageStream, decodingInfo);
            imageStream = resetStream(imageStream, decodingInfo);
            Options decodingOptions = prepareDecodingOptions(imageInfo.imageSize, decodingInfo);
            decodedBitmap = BitmapFactory.decodeStream(imageStream, null, decodingOptions);
        } finally {
            IoUtils.closeSilently(imageStream);
        }

        if (decodedBitmap == null) {
            L.e(ERROR_CANT_DECODE_IMAGE, decodingInfo.getImageKey());
        } else {
            decodedBitmap = considerExactScaleAndOrientatiton(decodedBitmap, decodingInfo, imageInfo.exif.rotation,
                    imageInfo.exif.flipHorizontal);
        }
        return decodedBitmap;
    }

首先是獲得網(wǎng)絡流InputStream,這里只分析默認的情況BaseImageDownloader下載器

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);
        }
    }

根據(jù)地址區(qū)分圖片的源頭,分析網(wǎng)絡流

protected InputStream getStreamFromNetwork(String imageUri, Object extra) throws IOException {
        HttpURLConnection conn = createConnection(imageUri, extra);

        int redirectCount = 0;
        while (conn.getResponseCode() / 100 == 3 && redirectCount < MAX_REDIRECT_COUNT) {
            conn = createConnection(conn.getHeaderField("Location"), extra);
            redirectCount++;
        }

        InputStream imageStream;
        try {
            imageStream = conn.getInputStream();
        } catch (IOException e) {
            // Read all data to allow reuse connection (http://bit.ly/1ad35PY)
            IoUtils.readAndCloseStream(conn.getErrorStream());
            throw e;
        }
        if (!shouldBeProcessed(conn)) {
            IoUtils.closeSilently(imageStream);
            throw new IOException("Image request failed with response code " + conn.getResponseCode());
        }

        return new ContentLengthInputStream(new BufferedInputStream(imageStream, BUFFER_SIZE), conn.getContentLength());
    }

這里如果連接不能建立的話,會重連5次,達到5次就不繼續(xù)連接了,這里網(wǎng)絡用的是HttpURLConnection,最后返回ContentLengthInputStream這個流,又是一個包裝類,繼承自InputStream, 這個流是從1.9.1版本開始有的,她的解釋是可以獲取自定義長度的流,她通過重寫int available()方法來限制讀取length長度的內容,而這個長度可以看到是conn.getContentLength(),也就是文件大小
繼續(xù)看碼,拿到流了,定義文件大小和圖片旋轉方向

imageInfo = defineImageSizeAndRotation(imageStream, decodingInfo);

補充一句獲取bitmap的時候盡量用BitmapFactory.decodeStream而不要用decodeFile\decodeResource之類的

protected ImageFileInfo defineImageSizeAndRotation(InputStream imageStream, ImageDecodingInfo decodingInfo)
            throws IOException {
        Options options = new Options();
        options.inJustDecodeBounds = true;
        BitmapFactory.decodeStream(imageStream, null, options);

        ExifInfo exif;
        String imageUri = decodingInfo.getImageUri();
        if (decodingInfo.shouldConsiderExifParams() && canDefineExifParams(imageUri, options.outMimeType)) {
            exif = defineExifOrientation(imageUri);
        } else {
            exif = new ExifInfo();
        }
        return new ImageFileInfo(new ImageSize(options.outWidth, options.outHeight, exif.rotation), exif);
    }

ExifInfo保存了圖片的一些旋轉、翻轉等信息,接下來因為已經(jīng)讀了一次流InputStream取到了圖片大小信息,后面還要讀流,怎么辦呢?
答案是重置流resetStream

if (imageStream.markSupported()) {
    try {
        imageStream.reset();
        return imageStream;
        } catch (IOException ignored) {
    }
 }
 IoUtils.closeSilently(imageStream);
 return getImageStream(decodingInfo);

首先判斷流是否支持標記mark,如果支持就可以調用reset()方法重置,默認的InputStream是不支持的,也就是只能讀一次,輸入管道內容就沒了,但是當前這個流是
ContentLengthInputStream這個包裝對象,它重寫了markSupported

@Override
public boolean markSupported() {
    return stream.markSupported();
}

退回到獲取流的時候,最后ContentLengthInputStream包裹的是BufferedInputStream緩沖輸入流,而她是支持reset()的
當然如果包裹的是其它不支持標記的流,這里 往下執(zhí)行,就要重新建立連接獲得流對象了,getImageStream(decodingInfo)再次完成建立連接,獲取Inputstream!
此時就可以通過流去獲取bitmap對象了

decodedBitmap = BitmapFactory.decodeStream(imageStream, null, decodingOptions)

拿到原始bitmap還不能馬上返回,還要根據(jù)上面獲得的圖片大小,旋轉,翻轉等信息,看看bitmap是否需要二次加工,涉及Matrix矩陣變換...

decodedBitmap = considerExactScaleAndOrientatiton(decodedBitmap, decodingInfo, imageInfo.exif.rotation,
                    imageInfo.exif.flipHorizontal)

加工完成后bitmap返回,繼續(xù)回到LoadAndDisplayImageTask的run方法里,向下執(zhí)行

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);

啟動了一個任務,交給顯示器displayer顯示

public void run() {
   ...
   displayer.display(bitmap, imageAware, loadedFrom);
}

基本上一個請求的過程就算分析完了,最后看一下整體流程圖

這里下載器,解碼器,Bitmap處理器,顯示器都可以自己制定.

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容