Glide学习---glide的自定义模块与具体示例

1. 首先要做的是为应用引入glide:compiler依赖. 这是必须的

dependencies {
    ....
    annotationProcessor 'com.github.bumptech.glide:compiler:4.7.1'
     ....
}

2. 自定义一个AppGlideModule, 如下

@GlideModule
public class MyAppGlideModule extends AppGlideModule {
    private static final String TAG = "MyAppGlideModule";

    @Override
    public void applyOptions(Context context, GlideBuilder builder) {
        super.applyOptions(context, builder);
    }

    @Override
    public void registerComponents(Context context, Glide glide, Registry registry) {
        super.registerComponents(context, glide, registry)

    }
}

3. 我们再定义一个自定义类, 如下:

@GlideExtension
public class MyAppExtension {

    private static final int MIN_THUMB_SIZE = 100;

    private static final RequestOptions DECODE_TYPE_BITMAP = RequestOptions.decodeTypeOf(Bitmap.class).lock();

    private MyAppExtension() {
    }

    @GlideOption
    public static void miniThumb(RequestOptions options) {
        options
                .fitCenter()
                .override(MIN_THUMB_SIZE);
    }

    @GlideType(Bitmap.class)
    public static void asMyBitmap(RequestBuilder<Bitmap> requestBuilder) {
        requestBuilder
                .transition(new BitmapTransitionOptions())
                .apply(DECODE_TYPE_BITMAP);
    }

}

首先这个类必须添加@GlideExtension 注解.
另外对这个类的签名必须是 public的, 而且必须是私有的构造方法, 要进行扩展的方法必须是静态的.

这里我们有两个扩展方法, 分别是
@GlideOption
public static void miniThumb(RequestOptions options)
和
@GlideType(Bitmap.class)
public static void asMyBitmap(RequestBuilder<Bitmap> requestBuilder)

4. 使用

好了, 编译一遍应用之后, 系统会自动生成一些辅助类, 我们就可以使用我们的自定义方法了.
在MainActivity中使用如下:

private void showSmallImage() {
        final ImageView imageView = findViewById(R.id.small_image);
        String imgUrl = "https://i.guim.co.uk/img/media/eb8dd183506d1ff62ba4a899652d7582870f10a4/0_220_5476_3284/master/5476.jpg?w=1300&q=55&auto=format&usm=12&fit=max&s=76a40a50ff81f5b898afb8692cc3c0b9";
        Glide.with(this).load(imgUrl).apply(new GlideOptions().miniThumb()).into(imageView);
//        GlideApp.with(this).load(imgUrl).miniThumb().into(imageView);
    }

    private void showNormalImage() {
        final ImageView imageView = findViewById(R.id.imageview);
        String imgUrl = "https://i.guim.co.uk/img/media/eb8dd183506d1ff62ba4a899652d7582870f10a4/0_220_5476_3284/master/5476.jpg?w=1300&q=55&auto=format&usm=12&fit=max&s=76a40a50ff81f5b898afb8692cc3c0b9";
        RequestManager requestManager = Glide.with(this);
        Log.d(TAG, "showNormalImage: requestManager:" + requestManager);
        GlideApp.with(this).asMyBitmap().load(imgUrl).into(imageView);
    }

对于miniThumb这种定制, 我们使用的时候, 既可以这样用:
Glide.with(this).load(imgUrl).apply(new GlideOptions().miniThumb()).into(imageView);
也可以:
GlideApp.with(this).load(imgUrl).miniThumb().into(imageView);

而对于
asMyBitmap的定制, 最简单的使用方法是:
GlideApp.with(this).asMyBitmap().load(imgUrl).into(imageView);

5. 如何实现的.

Glide在初始化的时候, 会判断有没有自定义AppGlideModule:
Glide.java:

private static void initializeGlide(@NonNull Context context, @NonNull GlideBuilder builder) {
    Context applicationContext = context.getApplicationContext();
    GeneratedAppGlideModule annotationGeneratedModule = getAnnotationGeneratedGlideModules();
    List<com.bumptech.glide.module.GlideModule> manifestModules = Collections.emptyList();
    if (annotationGeneratedModule == null || annotationGeneratedModule.isManifestParsingEnabled()) {
      manifestModules = new ManifestParser(applicationContext).parse();
    }
........

如果存在annotationGeneratedModule , 那么下面会有不一样的处理:

......
 RequestManagerRetriever.RequestManagerFactory factory =
        annotationGeneratedModule != null
            ? annotationGeneratedModule.getRequestManagerFactory() : null;
......

可以看到, 如果annotationGeneratedModule 不为空, 那么会使用annotationGeneratedModule.getRequestManagerFactory() , 而这里的annotationGeneratedModule实际类型是自生成类:GeneratedAppGlideModuleImpl, 其getRequestManagerFactory()方法如下:

@Override
  @NonNull
  GeneratedRequestManagerFactory getRequestManagerFactory() {
    return new GeneratedRequestManagerFactory();
  }

所以从此处, Glide中的RequstManager类替换为GlideRequests子类. 这个子类是自动生成的, 当然也就包含了我们的扩展方法.

完整glide示例 :https://github.com/shaopx/GlideApp