Android 如何在ListView里加载远程图片？

ListView在Android应用里扮演非常重要的角色，但很多开发者在使用ListView时都遇到过不少麻烦。一个常见的问题是：列表中要显示一系列记录，每条记录带有一张缩略图（产品照片、用户头像等等），而这个缩略图是通过一个远程URL地址来标识的。这样的应用场景该如何实现呢？

为了避免下载图片带来的延迟，所有远程图片都应该使用异步方式加载，即使用单独的线程下载图片，待图片下载完毕后显示在ImageView里。Android里可以像普通Java一样启动新线程，但当这个线程要更新界面时，必须使用Handler来请求，否则会为应用程序带来潜在危害。

RemoteImageHelper

为了将复杂的逻辑分离，我们单独写一个名为RemoteImageHelper的类来处理“异步下载图片并更新到界面”这个问题，这个类能够实现以下功能：

• 图片开始下载前，ImageView里显示一个表示“正在加载”的占位图；
• 图片在后台下载，下载完成后显示在ImageView里；
• 若图片下载失败，ImageView显示一个表示下载失败的占位图；

下面让我们来看一下实现代码：

首先需要有一个方法下载远程图片，这里我们不用把图片下载到手机上，直接返回一个InputStream类型的结果即可。如果运行时这个方法报错，请检查是否在AndroidManifest.xml里添加了android.permission.INTERNET权限。

private InputStream download(String urlString) throws MalformedURLException, IOException {
    InputStream inputStream = (InputStream) new URL(urlString).getContent();
    return inputStream;
}

然后是最主要的异步加载图片方法，“正在下载”和“下载失败”的图片可根据需要自己替换。代码如下所示：

private final Map<String, Drawable> cache = new HashMap<String, Drawable>();

public void loadImage(final ImageView imageView, final String urlString, boolean useCache) {
    if (useCache && cache.containsKey(urlString)) {
        imageView.setImageDrawable(cache.get(urlString));
    }

    //Show a "Loading" image here
    imageView.setImageResource(R.drawable.image_indicator);

    Log.d(this.getClass().getSimpleName(), "Image url:" + urlString);

    final Handler handler = new Handler() {
        @Override
        public void handleMessage(Message message) {
            imageView.setImageDrawable((Drawable) message.obj);
        }
    };

    Runnable runnable = new Runnable() {
        public void run() {
            Drawable drawable = null;
            try {
                InputStream is = download(urlString);
                drawable = Drawable.createFromStream(is, "src");

                if (drawable != null) {
                    cache.put(urlString, drawable);
                }
            } catch (Exception e) {
                Log.e(this.getClass().getSimpleName(), "Image download failed", e);
                //Show a "download fail" image 
                drawable = imageView.getResources().getDrawable(R.drawable.image_fail);
            }
            
            //Notify UI thread to show this image using Handler
            Message msg = handler.obtainMessage(1, drawable);
            handler.sendMessage(msg);
        }
    };
    new Thread(runnable).start();
}

关于缓存：在这个例子里我们使用一个内存中的HashMap作为图片缓存，它实现简单但当应用退出后缓存就会被清除。在实际项目里，你可以考虑实现一个基于文件的缓存机制，即将下载的图片保存到SD卡上，注意要定期清除长期不用的图片以节约存储空间。

使用RemoteImageHelper

如何使用这个类呢？下面是一个例子。请注意，为了达到更好的演示效果，代码里在调用loadImage()方法时第三个参数用false禁止了图片缓存功能，在实际项目中，你很可能需要改为true来避免重复下载图片以便提高性能。

List<MyRecord> exampleRecords;
LazyImageHelper lazyImageHelper = new LazyImageHelper();

class MyAdapter extends ArrayAdapter<MyRecord> {

    public MyAdapter(Context context) {
        super(context, R.layout.record_row, R.id.lblLabel, exampleRecords);
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        View view = super.getView(position, convertView, parent);
        MyRecord record = getItem(position);

        TextView lblLabel = (TextView) view.findViewById(R.id.lblLabel);
        ImageView imageView = (ImageView) view.findViewById(R.id.img);

        lblLabel.setText(record.getLabel());

        //For demo purpose, cache is DISABLED here.
        lazyImageHelper.loadImage(imageView, record.getImageUrl(), false);

        //To enable cache, simply use following code:
        //lazyImageHelper.loadImage(imageView, record.getImageUrl(), true);

        return view;
    }
}

以上代码中的MyRecord是一个简单的POJO类，表示一个业务对象，它具有id、label和imageUrl三个属性。你可以在完整的工程代码中找到它。

代码下载

上述示例工程编译后的APK文件点击这里下载，可运行在Android 2.1或以上版本。

上述示例工程的源代码点击这里下载。

参考资料

Handler

android的消息处理机制

How do I do a lazy load of images in ListView

Issue 13959:Make listviews more programmer friendly