glason / android-http-image-manager Goto Github PK

This is a simple library that can address most of the requirement of asynchronously dowloading, caching and managing network resource (images).

Loading an image is straightforward:

To load an image, one will have to instantiate an HttpImageManager object, then

• Set a target ImageView for displaying the loaded image

• Or set a listener for being notified of the result

        HttpImageManager.loadImage(new HttpImageManager.LoadRequest(uri, new HttpImageManager.OnLoadResponseListener() {

                    @Override
                    public void onLoadResponse(LoadRequest r, Bitmap data) {
                    }
        
                    @Override
                    public void onLoadError(LoadRequest r, Throwable e) {
                    }
        
                    @Override
                    public void onLoadProgress(LoadRequest r, long totalContentSize,
                                long loadedContentSize) {
                    }
        }));

[memory cache] -> [persistent storage cache] -> [network loader]

The memory cache is optional. To use too much memory cache may kill the system resource very fast. It is important to do so with a list view, though.

We use a LIFO queue for threading pool. This is to improve responsiveness of a listview, for example, when a user scrolls down the list that loads a quite number of images sequentially.

When used in list adapters that utilize techniques of reusing inflated view objects, the same ImageView object might be set as targets in a row of requests for difference resources. Since HttpImageManager works asynchronously, the previously requested resource may come late and gets written back to the wrong ImageView object. To prevent this write-back, we always bind the requested URL to the ImageView object. After the resource being downloaded, a comparison will be performed to check if the ImageView object is still representing the requested URL. This binding is realized by setting the ImageView's tag object. So, caller can not use the setTag() for other purpose during the process of HttpImageManager.

• Loading progress listener for large full-sized pictures
• Post manipulation of the loaded image by plugging in BitmapFilter
• Synchronous call wrapper