android Universal-Image-Loader框架学习

android Universal-Image-Loader框架学习（上），androidimageloader

一.Universal-Image-Loader概述：

Android-Universal-Image-Loader是一个开源的图片加载框架，这个项目的目的是提供一个可重复使用的仪器为异步图像加载，缓存和显示。

开源库的特性：

(1).多线程下载图片。

(2).可通过配置ImageLoader，改变线程池，图片下载器，等等的配置。

(3).支持图片的在内存缓存，文件系统缓存或sd卡缓存。

(4).支持图片下载的监听。

(5).可以较好的控制图片的加载过程，例如在listview滑动时停止加载图片，停止滑动时加载图片。

其他的一些特性就去http://blog.csdn.net/xiaanming/article/details/26810303这位大神博客去看吧。

二.简单的使用：

效果图：

未加载出来时：



加载成功：



在项目里导入jar包后，先要配置ImageLoaderConfiguration，这个是对全局图片缓存还有线程，缓存大小，解析等等进行配置，然后ImageLoader是具体实现下载图片、缓存图片显示图片的执行类，把配置好的ImageLoaderConfiguration传入ImageLoader，完成初始化工作，也就是初始化后才能使用ImageLoader.getInstance().displayImage()加载图片。

ImageLoader的初始化可以在Application中实现：

public class MyApp extends Application {

@Override
public void onCreate() {
super.onCreate();
initImageLoader1(getApplicationContext());

}

/*
* 自定义配置
*/
public static void initImageLoader(Context context) {
ImageLoaderConfiguration.Builder config = new ImageLoaderConfiguration.Builder(
context);
config.threadPoolSize(3);//线程池内加载的数量
config.threadPriority(Thread.NORM_PRIORITY - 2);
config.denyCacheImageMultipleSizesInMemory();// 不缓存图片的多种尺寸在内存中
config.diskCacheFileNameGenerator(new Md5FileNameGenerator());// 将保存的时候的URI名称用MD5
config.diskCacheSize(50 * 1024 * 1024); // 50 MiB
config.tasksProcessingOrder(QueueProcessingType.LIFO);
config.writeDebugLogs();// Remove for release app
// 初始化ImageLoader
ImageLoader.getInstance().init(config.build());
}

/*
* 默认的配置，一般没有特殊的要求的时候就使用默认就好了。
*/
public static void initImageLoader1(Context context) {
// 创建默认的ImageLoader配置参数
ImageLoaderConfiguration configuration = ImageLoaderConfiguration
.createDefault(context);
// 初始化ImageLoader
ImageLoader.getInstance().init(configuration);
}
}

在diskCacheFileNameGenerator（）；这是表示将缓存下来的文件以什么方式命名，有以下两种方式：

1.new Md5FileNameGenerator() //使用MD5对UIL进行加密命名

2.new HashCodeFileNameGenerator()//使用HASHCODE对UIL进行加密命名

然后在AndroidManifest.xml配置下：

<!-- 网络权限和缓存权限 -->
<span style="color:#ff0000;"><uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /></span>
<application
android:name="com.example.androidimageview.MyApp"
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
<span style="color:#ff0000;">android:name="com.example.androidimageview.MainActivity"</span>
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>

定义布局文件：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
>
<ListView
android:id="@+id/listview1"
android:layout_width="fill_parent"
android:layout_height="fill_parent" />

</RelativeLayout>

图片加载使用DisplayImageOptions，这时我们可以配置一下这个图片显示的选项，比如图片加载完成之前先显示什么图片，加载失败显示什么图片等等：

<span style="font-size:24px;">options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub)//设置图片在下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_empty)//设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_error)//设置图片加载/解码过程中错误时候显示的图片
.delayBeforeLoading(1000)//设置延时多少时间后开始下载
.cacheInMemory(true)//设置下载的图片是否缓存在内存中
.cacheOnDisk(true)// 设置下载的资源是否缓存在SD卡中
.considerExifParams(true)// 是否考虑JPEG图像EXIF参数（旋转，翻转）
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)//设置图片以何种编码方式显示
.bitmapConfig(Bitmap.Config.RGB_565) // 设置图片的解码类型
.displayer(new RoundedBitmapDisplayer(20))//是否设置为圆角，弧度为多少
.displayer(new FadeInBitmapDisplayer(1000))//是否图片加载好后渐入的动画时间
.build();</span>

图片的显示大小会根据你ImageView的狂傲在上边的配置中：

imageScaleType(ImageScaleType imageScaleType):

缩放类型mageScaleType：

（1）. EXACTLY :图像将完全按比例缩小的目标大小。

（2）. EXACTLY_STRETCHED:图片会缩放到目标大小完全

（3）. IN_SAMPLE_INT:图像将被二次采样的整数倍

（4）. IN_SAMPLE_POWER_OF_2:图片将降低2倍，直到下一减少步骤，使图像更小的目标大小

（5）. NONE:图片不会调整

item的布局：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">

<ImageView
android:id="@+id/image"
android:layout_width="72dp"
android:layout_height="72dp"
android:layout_margin="3dip"
android:adjustViewBounds="true"
android:contentDescription="@string/descr_image"
android:scaleType="centerCrop" />

<TextView
android:id="@+id/text"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="start|center_vertical"
android:layout_marginLeft="20dip"
android:textSize="22sp" />

</LinearLayout>

主界面实现：

public class MainActivity extends Activity {

private static final String TEST_FILE_NAME = "Universal Image Loader @#&=+-_.,!()~'%20.png";

ListView listview1 ;
public static final String[] IMAGES = new String[] {"http://img.dapixie.com/uploads/allimg/111105/1-111105145231.jpg"};
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
listview1 = (ListView)findViewById(R.id.listview1);
listview1.setAdapter(new ImageAdapter(this));
}

@Override
protected void onDestroy() {
super.onDestroy();
AnimateFirstDisplayListener.displayedImages.clear();
ImageLoader.getInstance().clearMemoryCache();
ImageLoader.getInstance().stop();
}

private static class ImageAdapter extends BaseAdapter {

private static final String[] IMAGE_URLS = MainActivity.IMAGES;

private LayoutInflater inflater;
private ImageLoadingListener animateFirstListener = new AnimateFirstDisplayListener();

private DisplayImageOptions options;

ImageAdapter(Context context) {
inflater = LayoutInflater.from(context);

options = new DisplayImageOptions.Builder()
.showImageOnLoading(R.drawable.ic_stub)//设置图片在下载期间显示的图片
.showImageForEmptyUri(R.drawable.ic_empty)//设置图片Uri为空或是错误的时候显示的图片
.showImageOnFail(R.drawable.ic_error)//设置图片加载/解码过程中错误时候显示的图片
.delayBeforeLoading(1000)//设置延时多少时间后开始下载
.cacheInMemory(true)//设置下载的图片是否缓存在内存中
.cacheOnDisk(true)// 设置下载的资源是否缓存在SD卡中
.considerExifParams(true)// 是否考虑JPEG图像EXIF参数（旋转，翻转）
.imageScaleType(ImageScaleType.IN_SAMPLE_POWER_OF_2)//设置图片以何种编码方式显示
.bitmapConfig(Bitmap.Config.RGB_565) // 设置图片的解码类型
.displayer(new RoundedBitmapDisplayer(20))//是否设置为圆角，弧度为多少
.displayer(new FadeInBitmapDisplayer(1000))//是否图片加载好后渐入的动画时间
.build();
}

@Override
public int getCount() {
return IMAGE_URLS.length;
}

@Override
public Object getItem(int position) {
return position;
}

@Override
public long getItemId(int position) {
return position;
}

@Override
public View getView(final int position, View convertView, ViewGroup parent) {
View view = convertView;
final ViewHolder holder;
if (convertView == null) {
view = inflater.inflate(R.layout.listview_item, parent, false);
holder = new ViewHolder();
holder.text = (TextView) view.findViewById(R.id.text);
holder.image = (ImageView) view.findViewById(R.id.image);
view.setTag(holder);
} else {
holder = (ViewHolder) view.getTag();
}

holder.text.setText("Item " + (position + 1));

ImageLoader.getInstance().displayImage(IMAGE_URLS[position], holder.image, options, animateFirstListener);

return view;
}
}

static class ViewHolder {
TextView text;
ImageView image;
}

private static class AnimateFirstDisplayListener extends SimpleImageLoadingListener {

static final List<String> displayedImages = Collections.synchronizedList(new LinkedList<String>());

@Override
public void onLoadingComplete(String imageUri, View view, Bitmap loadedImage) {
if (loadedImage != null) {
ImageView imageView = (ImageView) view;
boolean firstDisplay = !displayedImages.contains(imageUri);
if (firstDisplay) {
FadeInBitmapDisplayer.animate(imageView, 500);
displayedImages.add(imageUri);
}
}
}
}
}

在使用，主要是这几个ImageLoader.getInstance().displayImage(),ImageLoader.getInstance().loadImage(),ImageLoader.getInstance().loadImageSync()，ImageLoader.getInstance().loadImageSync()方法是同步的，android4.0有个特性，网络操作不能在主线程，所以ImageLoader.getInstance().loadImageSync()方法我们就不去使用。

主要介绍ImageLoader.getInstance().displayImage()其中三种重载方法：

(1).ImageLoader.getInstance().displayImage(imageUrl, imageView):其中参数imageUrl代表图片的URL地址，imageView代表承载图片的IMAGEVIEW控件 

(2).ImageLoader.getInstance().displayImage(imageUrl, imageView，options):其中的参数imageUrl代表图片的URL地址，imageView代表承载图片的IMAGEVIEW控件 ， options代表DisplayImageOptions配置文件

(3).ImageLoader.getInstance().displayImage(IMAGE_URLS[position], holder.image, options, animateFirstListener):这就是上面代码中使用的一种方式。animateFirstListener图片加载监听的。

图片下载监听还有可以用ImageLoadingListener，这种方式就是比较复杂，可以使用简单点的SimpleImageLoadingListener。

new ImageLoadingListener(){

@Override
public void onLoadingCancelled(String arg0, View arg1) {
//加载取消的时候执行
}

@Override
public void onLoadingComplete(String arg0, View arg1,
Bitmap arg2) {
//加载成功的时候执行
}

@Override
public void onLoadingFailed(String arg0, View arg1,
FailReason arg2) {
//加载失败的时候执行
}

@Override
public void onLoadingStarted(String arg0, View arg1) {
//开始加载的时候执行
}

};

三.加载其他来源的图片：

String imageUri = "http://site.com/image.png"; // from Web
String imageUri = "file:///mnt/sdcard/image.png"; // from SD card
String imageUri = "content://media/external/audio/albumart/13"; // from content provider
String imageUri = "assets://image.png"; // from assets
String imageUri = "drawable://" + R.drawable.image; // from drawables (only images, non-9patch)

四.避免oom（我也从别人的博客学习来的，贴上大神博客地址http://blog.csdn.net/xiaanming/article/details/26810303）：

1.减少线程池中线程的个数，在ImageLoaderConfiguration中的（.threadPoolSize）中配置，推荐配置1-5。

2.在DisplayImageOptions选项中配置bitmapConfig为Bitmap.Config.RGB_565，因为默认是ARGB_8888， 使用RGB_565会比使用ARGB_8888少消耗2倍的内存

3.在ImageLoaderConfiguration中配置图片的内存缓存为memoryCache(new WeakMemoryCache()) 或者不使用内存缓存

4.在DisplayImageOptions选项中设置.imageScaleType(ImageScaleType.IN_SAMPLE_INT)或者imageScaleType(ImageScaleType.EXACTLY)

通过上面这些，相信大家对Universal-Image-Loader框架的使用已经非常的了解了，我们在使用该框架的时候尽量的使用displayImage()方法去加载图片，loadImage()是将图片对象回调到ImageLoadingListener接口的onLoadingComplete()方法中，需要我们手动去设置到ImageView上面，displayImage()方法中，对ImageView对象使用的是Weak references，方便垃圾回收器回收ImageView对象，如果我们要加载固定大小的图片的时候，使用loadImage()方法需要传递一个ImageSize对象，而displayImage()方法会根据ImageView对象的测量值，或者android:layout_width
and android:layout_height设定的值，或者android:maxWidth and/or android:maxHeight设定的值来裁剪图片