Android图片异步加载框架Android-Universal-Image-Loader

Android-Universal-Image-Loader是一个图片异步加载，缓存和显示的框架。这个框架已经被很多开发者所使用，是最常用的几个Android开源项目之一，主流的应用，随便反编译几个，都可以见到它的身影。淘宝，天猫，Facebook，京东商城等都用到了这个项目。
该项目的Github地址链接：https://github.com/nostra13/Android-Universal-Image-Loader

运行流程：
每一个图片的加载和显示任务都运行在独立的线程中，除非这个图片缓存在内存中，这种情况下图片会立即显示。如果需要的图片缓存在本地，它会开启一个独立的线程队列。如果在缓存中没有正确的图片，任务线程会从网络中获取。

使用步骤：
1、加载图片之前，先要做初始化配置，这个类似很多游戏引擎使用前要做一下初始化，其实只做了一件事，实例化一个全局的ImageLoader对象，同时传入图片加载缓存的配置，ImageLoaderConfiguration封装了基本的配置信息，比如加载图片事用的线程池大小，线程的优先级，内存缓存大小，是否支持同一图片的多尺寸缓存（默认是支持的，可以手动关闭），还有缓存的命名规则等等。

2、配置完后，就可以开始使用了，通过ImageLoader的displayImage()绑定一个图片和ImageView。
displayImage(String uri, ImageView imageView, DisplayImageOptions options)
DisplayImageOptions用于指导每一个Imageloader根据网络图片的状态（空白、下载错误、正在下载）显示对应的图片，是否将缓存加载到磁盘上，下载完后对图片进行怎么样的处理。
 

实例：UniversalImageLoaderDemo

运行效果：


代码清单：
AndroidManifest.xml

布局文件：activity_main.xml

[html] view plaincopy

 

1. xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     xmlns:tools="http://schemas.android.com/tools"  
4.     android:layout_width="match_parent"  
5.     android:layout_height="match_parent"  
6.     android:orientation="vertical"  
7.     tools:context=".MainActivity" >  
8.   
9.     <ListView  
10.         android:id="@+id/list"  
11.         android:layout_width="match_parent"  
12.         android:layout_height="match_parent" >  
13.     ListView>  
14.   
15. LinearLayout>  

布局文件：item_list.xml

[html] view plaincopy

 

1. xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="match_parent"  
4.     android:layout_height="wrap_content" >  
5.   
6.     <ImageView  
7.         android:id="@+id/image"  
8.         android:layout_width="72dip"  
9.         android:layout_height="72dip"  
10.         android:layout_margin="3dip"  
11.         android:adjustViewBounds="true"  
12.         android:contentDescription="@string/descr_image"  
13.         android:scaleType="centerCrop" />  
14.   
15.     <TextView  
16.         android:id="@+id/text"  
17.         android:layout_width="fill_parent"  
18.         android:layout_height="wrap_content"  
19.         android:layout_gravity="start|center_vertical"  
20.         android:layout_marginLeft="20dip"  
21.         android:textSize="22sp" />  
22.   
23. LinearLayout>  

Java源代码文件：UILApplication.java

[java] view plaincopy

 

1. package com.rainsong.universalimageloaderdemo;  
2.   
3. import java.io.File;  
4.   
5. import com.nostra13.universalimageloader.cache.disc.impl.UnlimitedDiscCache;  
6. import com.nostra13.universalimageloader.cache.disc.naming.Md5FileNameGenerator;  
7. import com.nostra13.universalimageloader.cache.memory.impl.UsingFreqLimitedMemoryCache;  
8. import com.nostra13.universalimageloader.core.ImageLoader;  
9. import com.nostra13.universalimageloader.core.ImageLoaderConfiguration;  
10. import com.nostra13.universalimageloader.core.assist.QueueProcessingType;  
11. import com.nostra13.universalimageloader.core.download.BaseImageDownloader;  
12. import com.nostra13.universalimageloader.utils.StorageUtils;  
13.   
14. import android.app.Application;  
15. import android.content.Context;  
16.   
17. public class UILApplication extends Application {  
18.   
19.     @Override  
20.     public void onCreate() {  
21.         super.onCreate();  
22.         initImageLoader(getApplicationContext());  
23.     }  
24.   
25.     public static void initImageLoader(Context context) {  
26.         //缓存文件的目录  
27.         File cacheDir = StorageUtils.getOwnCacheDirectory(context, "universalimageloader/Cache");   
28.         ImageLoaderConfiguration config = new ImageLoaderConfiguration.Builder(context)  
29.                 .memoryCacheExtraOptions(480, 800) // max width, max height，即保存的每个缓存文件的最大长宽   
30.                 .threadPoolSize(3) //线程池内线程的数量  
31.                 .threadPriority(Thread.NORM_PRIORITY - 2)  
32.                 .denyCacheImageMultipleSizesInMemory()  
33.                 .diskCacheFileNameGenerator(new Md5FileNameGenerator()) //将保存的时候的URI名称用MD5 加密  
34.                 .memoryCache(new UsingFreqLimitedMemoryCache(2 * 1024 * 1024))  
35.                 .memoryCacheSize(2 * 1024 * 1024) // 内存缓存的最大值  
36.                 .diskCacheSize(50 * 1024 * 1024)  // SD卡缓存的最大值  
37.                 .tasksProcessingOrder(QueueProcessingType.LIFO)  
38.                 // 由原先的discCache -> diskCache  
39.                 .diskCache(new UnlimitedDiscCache(cacheDir))//自定义缓存路径    
40.                 .imageDownloader(new BaseImageDownloader(context, 5 * 1000, 30 * 1000)) // connectTimeout (5 s), readTimeout (30 s)超时时间    
41.                 .writeDebugLogs() // Remove for release app  
42.                 .build();  
43.         //全局初始化此配置    
44.         ImageLoader.getInstance().init(config);  
45.     }  
46. }  

Java源代码文件：MainActivity.java

[java] view plaincopy

 

1. package com.rainsong.universalimageloaderdemo;  
2.   
3. import com.nostra13.universalimageloader.core.DisplayImageOptions;  
4. import com.nostra13.universalimageloader.core.ImageLoader;  
5. import com.nostra13.universalimageloader.core.display.RoundedBitmapDisplayer;  
6. import android.os.Bundle;  
7. import android.app.Activity;  
8. import android.view.Menu;  
9. import android.view.MenuItem;  
10. import android.view.View;  
11. import android.view.ViewGroup;  
12. import android.widget.BaseAdapter;  
13. import android.widget.ImageView;  
14. import android.widget.ListView;  
15. import android.widget.TextView;  
16.   
17. public class MainActivity extends Activity {  
18.     private ImageLoader imageLoader;  
19.     private ListView lv;  
20.     private String[] imageUrls;  
21.     private DisplayImageOptions options;  
22.   
23.     @Override  
24.     protected void onCreate(Bundle savedInstanceState) {  
25.         super.onCreate(savedInstanceState);  
26.         setContentView(R.layout.activity_main);  
27.         imageLoader = ImageLoader.getInstance();  
28.         lv = (ListView)findViewById(R.id.list);  
29.           
30.         imageUrls = Constants.images;  
31.   
32.         // 使用DisplayImageOptions.Builder()创建DisplayImageOptions  
33.         options = new DisplayImageOptions.Builder()  
34.                 .showImageOnLoading(R.drawable.ic_stub) // 设置图片下载期间显示的图片  
35.                 .showImageForEmptyUri(R.drawable.ic_empty) // 设置图片Uri为空或是错误的时候显示的图片  
36.                 .showImageOnFail(R.drawable.ic_error) // 设置图片加载或解码过程中发生错误显示的图片  
37.                 .cacheInMemory(true) // 设置下载的图片是否缓存在内存中  
38.                 .cacheOnDisk(true) // 设置下载的图片是否缓存在SD卡中  
39.                 .displayer(new RoundedBitmapDisplayer(20)) // 设置成圆角图片  
40.                 .build(); // 构建完成  
41.         lv.setAdapter(new ItemListAdapter());  
42.     }  
43.   
44.     @Override  
45.     public boolean onCreateOptionsMenu(Menu menu) {  
46.         // Inflate the menu; this adds items to the action bar if it is present.  
47.         getMenuInflater().inflate(R.menu.main, menu);  
48.         return true;  
49.     }  
50.   
51.     @Override  
52.     public boolean onOptionsItemSelected(MenuItem item) {  
53.         switch (item.getItemId()) {  
54.             case R.id.item_clear_memory_cache:  
55.                 ImageLoader.getInstance().clearMemoryCache();  
56.                 return true;  
57.             case R.id.item_clear_disc_cache:  
58.                 ImageLoader.getInstance().clearDiskCache();  
59.                 return true;  
60.             default:  
61.                 return false;  
62.         }  
63.     }  
64.   
65.     class ItemListAdapter extends BaseAdapter {  
66.         @Override  
67.         public int getCount() {  
68.             // TODO Auto-generated method stub  
69.             return imageUrls.length;  
70.         }  
71.   
72.         @Override  
73.         public Object getItem(int position) {  
74.             // TODO Auto-generated method stub  
75.             return imageUrls[position];  
76.         }  
77.   
78.         @Override  
79.         public View getView(int position, View convertView, ViewGroup parent) {  
80.             // TODO Auto-generated method stub  
81.             ViewHolder holder = null;  
82.             if (convertView == null) {  
83.                 convertView = getLayoutInflater().inflate(R.layout.item_list, parent, false);  
84.                 holder = new ViewHolder();  
85.                 holder.text = (TextView) convertView.findViewById(R.id.text);  
86.                 holder.image = (ImageView) convertView.findViewById(R.id.image);  
87.                 convertView.setTag(holder);  
88.             } else {  
89.                 holder = (ViewHolder) convertView.getTag();  
90.             }  
91.             holder.text.setText("Item " + (position + 1));  
92.             imageLoader.displayImage(imageUrls[position], holder.image, options);  
93.             return convertView;  
94.         }  
95.   
96.         @Override  
97.         public long getItemId(int position) {  
98.             // TODO Auto-generated method stub  
99.             return position;  
100.         }  
101.   
102.         class ViewHolder {  
103.             public ImageView image;  
104.             public TextView text;  
105.         }  
106.     }  
107.   
108. }  
109.