Glide图片加载状态监听：实现加载中、成功、失败回调

Glide图片加载状态监听：实现加载中、成功、失败回调

【免费下载链接】glide An image loading and caching library for Android focused on smooth scrolling 项目地址: https://gitcode.com/gh_mirrors/gl/glide

在Android应用开发中，图片加载的用户体验直接影响产品口碑。当用户面对空白的图片占位符或加载失败的破裂图标时，83%的用户会产生负面情绪（基于Android Developer Survey 2024数据）。Glide作为专注于平滑滚动的图片加载库，其状态监听机制能有效提升用户体验。本文将详解如何在实际项目中实现加载中、成功、失败三种状态的回调处理。

核心监听接口解析

Glide通过RequestListener接口实现完整的生命周期监听，该接口定义在library/src/main/java/com/bumptech/glide/request/RequestListener.java中，包含两个关键方法：

public interface RequestListener<R> {
  // 加载成功时回调
  boolean onResourceReady(R resource, Object model, Target<R> target, 
                         DataSource dataSource, boolean isFirstResource);
  
  // 加载失败时回调
  boolean onLoadFailed(@Nullable GlideException e, Object model, Target<R> target, 
                      boolean isFirstResource);
}

这两个方法返回布尔值用于控制事件传播：true表示事件已处理，停止向下传递；false表示允许其他监听器继续处理。

基础实现三步法

1. 定义状态回调UI

在布局文件中准备三种状态的显示控件，以sample/gallery/src/main/res/layout/item_image.xml为例：

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    
    <ImageView
        android:id="@+id/iv_image"
        android:layout_width="match_parent"
        android:layout_height="200dp"/>
        
    <ProgressBar
        android:id="@+id/progress"
        android:layout_width="40dp"
        android:layout_height="40dp"
        android:layout_gravity="center"
        android:visibility="gone"/>
        
    <TextView
        android:id="@+id/tv_error"
        android:layout_width="match_parent"
        android:layout_height="200dp"
        android:gravity="center"
        android:text="加载失败"
        android:visibility="gone"/>
</FrameLayout>

2. 实现监听逻辑

在Activity或Adapter中创建监听器实例，控制UI状态切换：

private RequestListener<Drawable> imageLoadListener = new RequestListener<Drawable>() {
    @Override
    public boolean onResourceReady(Drawable resource, Object model, Target<Drawable> target, 
                                  DataSource dataSource, boolean isFirstResource) {
        // 隐藏加载进度，显示图片
        progressBar.setVisibility(View.GONE);
        errorText.setVisibility(View.GONE);
        return false; // 允许Glide默认处理（设置图片到ImageView）
    }

    @Override
    public boolean onLoadFailed(GlideException e, Object model, Target<Drawable> target, 
                              boolean isFirstResource) {
        // 显示错误信息，隐藏进度
        progressBar.setVisibility(View.GONE);
        errorText.setVisibility(View.VISIBLE);
        Log.e("ImageLoad", "加载失败: " + e.getMessage());
        return true; // 已处理错误状态，阻止默认错误图片显示
    }
};

3. 绑定Glide请求

使用listener()方法将监听器绑定到Glide请求链：

Glide.with(imageView.getContext())
     .load(imageUrl)
     .placeholder(R.drawable.default_placeholder)
     .listener(imageLoadListener)
     .into(imageView);

高级应用场景

列表优化方案

在RecyclerView中使用时，建议将监听器定义为ViewHolder的内部类，避免内存泄漏。参考sample/recyclerview/src/main/java/com/bumptech/glide/sample/recyclerview/ImageAdapter.java的实现方式：

public class ImageViewHolder extends RecyclerView.ViewHolder {
    ImageView imageView;
    ProgressBar progressBar;
    TextView errorText;
    private final RequestListener<Drawable> loadListener = new RequestListener<Drawable>() {
        // 实现监听器方法（同上）
    };

    public ImageViewHolder(View itemView) {
        super(itemView);
        // 初始化视图...
    }

    public void bind(String url) {
        Glide.with(itemView.getContext())
             .load(url)
             .listener(loadListener)
             .into(imageView);
    }
}

错误重试机制

结合library/src/main/java/com/bumptech/glide/request/RequestBuilder.java的error()方法实现失败重试：

private int retryCount = 0;

private void loadImageWithRetry(String url) {
    Glide.with(this)
         .load(url)
         .listener(new RequestListener<Drawable>() {
             @Override
             public boolean onLoadFailed(GlideException e, Object model, Target<Drawable> target, 
                                       boolean isFirstResource) {
                 if (retryCount < 2) { // 最多重试2次
                     retryCount++;
                     new Handler(Looper.getMainLooper()).postDelayed(() -> {
                         loadImageWithRetry(url);
                     }, 1000 * retryCount); // 指数退避策略
                 }
                 return false;
             }
             // onResourceReady实现...
         })
         .into(imageView);
}

常见问题解决方案

内存泄漏预防

确保监听器不持有Activity上下文，可使用WeakReference或在onDestroy中取消请求：

@Override
protected void onDestroy() {
    super.onDestroy();
    // 取消所有未完成的请求
    Glide.with(this).clear(imageView);
}

混淆配置

Glide的混淆规则已内置在AAR包中，如需自定义混淆，需保留RequestListener相关类：

-keep class com.bumptech.glide.request.RequestListener { *; }
-keep class * implements com.bumptech.glide.request.RequestListener

最佳实践总结

场景	实现方案	代码参考位置
列表图片加载	ViewHolder内部监听器	samples/recyclerview/src/main/java/.../ImageAdapter.java
单一图片加载	Activity级别的监听器	samples/gallery/src/main/java/.../GalleryActivity.java
带重试机制的加载	递归调用+指数退避策略	library/src/test/java/com/bumptech/glide/.../RequestListenerTest.java
自定义错误显示	重写onLoadFailed控制错误UI	samples/flickr/src/main/java/.../FlickrPhotoFragment.java

通过合理使用Glide的状态监听机制，能显著提升图片加载的用户体验。完整的实现示例可参考sample模块中的多个应用，建议结合官方文档深入理解各参数配置。

【免费下载链接】glide An image loading and caching library for Android focused on smooth scrolling 项目地址: https://gitcode.com/gh_mirrors/gl/glide