Glide 知识梳理(5) 自定义GlideModule

时间  2019-11-21
标签 glide 知识 梳理 自定义 glidemodule 繁體版
原文   原文链接

1、概述

前面说的都是如何使用Glide提供的接口来展现图片资源，今天这篇，咱们来说一下如何改变Glide的配置。android

2、定义GlideModule

2.1 步骤

首先，咱们须要一个实现了GlideModule接口的类，重写其中的方法来改变Glide的配置，而后让Glide在构造实例的过程当中，读取这个类中的配置信息。git

  • 第一步：实现GlideModule接口
public class CustomGlideModule implements GlideModule {

    @Override
    public void applyOptions(Context context, GlideBuilder builder) {
        //经过builder.setXXX进行配置.
    }

    @Override
    public void registerComponents(Context context, Glide glide) {
        //经过glide.register进行配置.
    }
}
复制代码
  • 第二步：在AndroidManifest.xml中的<application>标签下定义<meta-data>，这样Glide才能知道咱们定义了这么一个类，其中android:name是咱们自定义的GlideModule的完整路径，而android:value就固定写死GlideModule。
<application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <meta-data
            android:name="com.example.lizejun.repoglidelearn.CustomGlideModule"
            android:value="GlideModule"/>
    </application>
复制代码

2.2 源码分析

上面2.1所作的工做都是为了在Glide建立时能够读取咱们在两个回调中配置的信息，咱们来看一下Glide是如何使用这个自定义的类的，它的整个流程在Glide的get方法中：github

public static Glide get(Context context) {
        if (glide == null) {
            synchronized (Glide.class) {
                if (glide == null) {
                    Context applicationContext = context.getApplicationContext();

                    //第一步
                    List<GlideModule> modules = new ManifestParser(applicationContext).parse();
                    
                     //第二步
                    GlideBuilder builder = new GlideBuilder(applicationContext);
                    for (GlideModule module : modules) {
                        //在builder构造出glide以前，读取使用者自定义的配置.
                        module.applyOptions(applicationContext, builder);
                    }
                    glide = builder.createGlide();

                    //第三步
                    for (GlideModule module : modules) {
                        module.registerComponents(applicationContext, glide);
                    }
                }
            }
        }

        return glide;
    }
复制代码

能够看到，整个实例化Glide的过程分为三步：缓存

  • 第一步：去AndroidManifest中查找meta-data为GlideModule的类，而后经过反射实例化它。
  • 第二步：以后Glide会新建一个GlideBuilder对象，它会先调用咱们自定义的GlideModule的applyOptions方法，并把本身传进去，这样，自定义的GlideModule就能够经过GlideBuilder提供的接口来设置它内部的参数，在builder.createGlide()的过程当中就会根据它内部的参数来构建Glide，假如咱们没有设置相应的参数，那么在createGlide时，就会采起默认的实现，下面就是memoryCache的例子。
//咱们在applyOptions中，能够经过GlideBuilder的这个方法来设定本身的memoryCache.
    public GlideBuilder setMemoryCache(MemoryCache memoryCache) {
        this.memoryCache = memoryCache;
        return this;
    }

    Glide createGlide() {
        //若是builder中没有设定memoryCache，那么采用默认的实现.
        if (memoryCache == null) {
            memoryCache = new LruResourceCache(calculator.getMemoryCacheSize());
        }

        return new Glide(engine, memoryCache, bitmapPool, context, decodeFormat);
    }
复制代码
  • 第三步：在Glide实例化完毕以后，调用自定义GlideModule的registerComponents，并传入当前的Glide实例来让使用者注册本身的组件，其实在Glide实例化的过程当中已经注册了默认的组件，若是用户定义了相同的组件，那么就会替换以前的。
Glide(Engine engine, MemoryCache memoryCache, BitmapPool bitmapPool, Context context, DecodeFormat decodeFormat) {
        //Glide默认注册的组件.
        register(File.class, ParcelFileDescriptor.class, new FileDescriptorFileLoader.Factory());
        register(File.class, InputStream.class, new StreamFileLoader.Factory());
        register(int.class, ParcelFileDescriptor.class, new FileDescriptorResourceLoader.Factory());
        register(int.class, InputStream.class, new StreamResourceLoader.Factory());
        register(Integer.class, ParcelFileDescriptor.class, new FileDescriptorResourceLoader.Factory());
        register(Integer.class, InputStream.class, new StreamResourceLoader.Factory());
        register(String.class, ParcelFileDescriptor.class, new FileDescriptorStringLoader.Factory());
        register(String.class, InputStream.class, new StreamStringLoader.Factory());
        register(Uri.class, ParcelFileDescriptor.class, new FileDescriptorUriLoader.Factory());
        register(Uri.class, InputStream.class, new StreamUriLoader.Factory());
        register(URL.class, InputStream.class, new StreamUrlLoader.Factory());
        register(GlideUrl.class, InputStream.class, new HttpUrlGlideUrlLoader.Factory());
        register(byte[].class, InputStream.class, new StreamByteArrayLoader.Factory());
    }
复制代码

通俗的来讲，注册组件的目的就是告诉Glide，当咱们调用load(xxxx)方法时，应该用什么方式来获取这个xxxx所指向的资源。所以，咱们能够看到register的第一个参数就是咱们load(xxxx)的类型，第二个参数是对应的输入流，而第三个参数就是定义获取资源的方式。 咱们也就分两个部分，在第3、四节，咱们分两部分讨论这两个回调函数的用法：applyOptions/registerComponents。bash

2.3 注意事项

  • 因为Glide是经过反射的方法来实例化GlideModule对象的，所以自定义的GlideModule只能有一个无参的构造方法。
  • 能够看到，上面是支持配置多个GlideModule的，可是GlideModule的读取顺序并不能保证，所以，不要在多个GlideModule对同一个属性进行不一样的配置。

3、applyOptions(Context context, GlideBuilder builder)方法详解

在第二节中，咱们已经解释过，这个回调方法的目的就是为了让使用者能经过builder定义本身的配置，而所支持的配置也就是GlideBuilder的setXXX方法，它们包括：网络

  • setBitmapPool(BitmapPool bitmapPool) 设置Bitmap的缓存池，用来重用Bitmap，须要实现BitmapPool接口，它的默认实现是LruBitmapPoolapp

  • setMemoryCache(MemoryCache memoryCache) 设置内存缓存，须要实现MemoryCache接口，默认实现是LruResourceCache。ide

  • setDiskCache(DiskCache.Factory diskCacheFactory) 设置磁盘缓存，须要实现DiskCache.Factory，默认实现是InternalCacheDiskCacheFactory函数

  • setResizeService(ExecutorService service) 当资源不在缓存中时，须要经过这个Executor发起请求，默认是实现是FifoPriorityThreadPoolExecutor。源码分析

  • setDiskCacheService(ExecutorService service) 读取磁盘缓存的服务，默认实现是FifoPriorityThreadPoolExecutor。

  • setDecodeFormat(DecodeFormat decodeFormat) 用于控制Bitmap解码的清晰度，DecodeFormat可选的值有PREFER_ARGB_8888/PREFER_RGB_565，默认为PREFER_RGB_565。

4、registerComponents(Context context, Glide glide)方法详解

registerComponents相对来讲就复杂了不少，它主要和三个接口有关：

  • ModelLoaderFactory
  • ModelLoader
  • DataFetcher

为了便于理解，咱们先经过它内部一个默认Module的实现来看一下源码是如何实现的。

咱们选取是通用的加载普通图片的url的例子，它对应的注册方法是下面这句：

Glide(Engine engine, MemoryCache memoryCache, BitmapPool bitmapPool, Context context, DecodeFormat decodeFormat) {
        //注册加载网络url的组件.
        register(GlideUrl.class, InputStream.class, new HttpUrlGlideUrlLoader.Factory());
    }
复制代码

4.1 源码分析

4.1.1 HttpUrlGlideUrlLoader.Factory

首先看一下HttpUrlGlideUrlLoader的内部工厂类，它实现了ModelLoaderFactory<T, Y>接口

public interface ModelLoaderFactory<T, Y> {
    ModelLoader<T, Y> build(Context context, GenericLoaderFactory factories);
    void teardown();
}
复制代码

它要求咱们返回一个ModelLoader，咱们看一下HttpUrlGlideUrlLoader.Factory是怎么作的，能够看到，它返回了HttpUrlGlideUrlLoader，而它的两个泛型参数就是咱们register中指定的前两个参数类型。

public static class Factory implements ModelLoaderFactory<GlideUrl, InputStream> {
        private final ModelCache<GlideUrl, GlideUrl> modelCache = new ModelCache<GlideUrl, GlideUrl>(500);

        @Override
        public ModelLoader<GlideUrl, InputStream> build(Context context, GenericLoaderFactory factories) {
            return new HttpUrlGlideUrlLoader(modelCache);
        }

        @Override
        public void teardown() {}
    }
复制代码

4.1.2 HttpUrlGlideUrlLoader

HttpUrlGlideUrlLoader实现了ModelLoader接口：

public interface ModelLoader<T, Y> {
    DataFetcher<Y> getResourceFetcher(T model, int width, int height);
}
复制代码

ModelLoader提供了一个DataFetcher，它会去请求这个抽象模型所表示的数据：

  • T：模型的类型。
  • Y：一个能够被ResourceDecoder解析出数据的表示。

GlideUrl的实现以下：

public class HttpUrlGlideUrlLoader implements ModelLoader<GlideUrl, InputStream> {

    private final ModelCache<GlideUrl, GlideUrl> modelCache;

    public HttpUrlGlideUrlLoader() {
        this(null);
    }

    public HttpUrlGlideUrlLoader(ModelCache<GlideUrl, GlideUrl> modelCache) {
        this.modelCache = modelCache;
    }

     //最主要的方法，它决定了咱们获取数据的方式.
    @Override
    public DataFetcher<InputStream> getResourceFetcher(GlideUrl model, int width, int height) {
        GlideUrl url = model;
        if (modelCache != null) {
            url = modelCache.get(model, 0, 0);
            if (url == null) {
                modelCache.put(model, 0, 0, model);
                url = model;
            }
        }
        return new HttpUrlFetcher(url);
    }
}
复制代码

4.1.3 HttpUrlFetcher

DataFetcher就是咱们读取数据的方式，它的关键方法是loadData，该loadData的返回值就是咱们register的第二个参数：

public interface DataFetcher<T> {
    T loadData(Priority priority) throws Exception;
    void cleanup();
    String getId();
    void cancel();
}
复制代码

HttpUrlFetcher实现了DataFetcher接口，在它的loadData方法中，经过传入的url发起请求，最终返回一个InputStream。

public class HttpUrlFetcher implements DataFetcher<InputStream> {
    private static final String TAG = "HttpUrlFetcher";
    private static final int MAXIMUM_REDIRECTS = 5;
    private static final HttpUrlConnectionFactory DEFAULT_CONNECTION_FACTORY = new DefaultHttpUrlConnectionFactory();

    private final GlideUrl glideUrl;
    private final HttpUrlConnectionFactory connectionFactory;

    private HttpURLConnection urlConnection;
    private InputStream stream;
    private volatile boolean isCancelled;

    public HttpUrlFetcher(GlideUrl glideUrl) {
        this(glideUrl, DEFAULT_CONNECTION_FACTORY);
    }

    HttpUrlFetcher(GlideUrl glideUrl, HttpUrlConnectionFactory connectionFactory) {
        this.glideUrl = glideUrl;
        this.connectionFactory = connectionFactory;
    }

    @Override
    public InputStream loadData(Priority priority) throws Exception {
        return loadDataWithRedirects(glideUrl.toURL(), 0 /*redirects*/, null /*lastUrl*/, glideUrl.getHeaders());
    }

    private InputStream loadDataWithRedirects(URL url, int redirects, URL lastUrl, Map<String, String> headers) throws IOException {
        //就是调用HttpUrlConnection请求.
    }

    @Override
    public void cleanup() {
        if (stream != null) {
            try {
                stream.close();
            } catch (IOException e) {
                // Ignore
            }
        }
        if (urlConnection != null) {
            urlConnection.disconnect();
        }
    }

    @Override
    public String getId() {
        return glideUrl.getCacheKey();
    }

    @Override
    public void cancel() {
        isCancelled = true;
    }
}
复制代码

4.1.4 小结

对上面作个总结，整个流程以下：经过register传入一个ModelLoaderFactory<T, Y>工厂类，该工厂生产的是ModelLoader<T, Y>，而这个ModelLoader会根据T返回一个DataFetcher<Y>，在DataFetcher<Y>中，咱们去获取数据。（在上面的例子中T就是GlideUrl，Y就是InputStream）

4.2 自定义ModuleLoader示例：用OkHttpClient替换HttpURLConnection

下面的例子来自于这篇文章：

https://futurestud.io/tutorials/glide-module-example-accepting-self-signed-https-certificates

  • 第一步：定义ModelLoader和ModelLoader.Factory
public class OkHttpGlideUrlLoader implements ModelLoader<GlideUrl, InputStream> {

        @Override
        public ModelLoader<GlideUrl, InputStream> build(Context context, GenericLoaderFactory factories) {
            return new OkHttpGlideUrlLoader(getOkHttpClient());
        }

        @Override
        public void teardown() {}
    }

    @Override
    public DataFetcher<InputStream> getResourceFetcher(GlideUrl model, int width, int height) {
        return new OkHttpGlideUrlFetcher(mOkHttpClient, model);
    }
}
复制代码
  • 第二步：ModelLoader的getResourceFetcher返回一个DataFetcher，咱们给它传入一个OkHttpClient实例，让它经过OkHttpClient发起请求。
public class OkHttpGlideUrlFetcher implements DataFetcher<InputStream> {

    public OkHttpGlideUrlFetcher(OkHttpClient client, GlideUrl url) {
        this.client = client;
        this.url = url;
    }

    @Override
    public InputStream loadData(Priority priority) throws Exception {
        Request.Builder requestBuilder = new Request.Builder().url(url.toStringUrl());
        for (Map.Entry<String, String> headerEntry : url.getHeaders().entrySet()) {
            String key = headerEntry.getKey();
            requestBuilder.addHeader(key, headerEntry.getValue());
        }
        Request request = requestBuilder.build();
        Response response = client.newCall(request).execute();
        responseBody = response.body();
        if (!response.isSuccessful()) {
            throw new IOException("Request failed with code: " + response.code());
        }
        long contentLength = responseBody.contentLength();
        stream = ContentLengthInputStream.obtain(responseBody.byteStream(), contentLength);
        return stream;
    }

}
复制代码

第三步：在CustomGlideModule中注册这个组件：

public class CustomGlideModule implements GlideModule {

    @Override
    public void applyOptions(Context context, GlideBuilder builder) {
        //经过builder.setXXX进行配置.
    }

    @Override
    public void registerComponents(Context context, Glide glide) {
        //经过glide.register进行配置.
        glide.register(GlideUrl.class, InputStream.class, new OkHttpGlideUrlLoader.Factory());
    }
}
复制代码

接着咱们发起一次请求，经过断点能够发现，调用的是OkHttpClient来进行数据的拉取：

4.3 自定义处理的Module

上面咱们分析了如何定义ModuleLoader来关联已有的Module和最终的数据类型，下面咱们介绍一些如何定义本身的Model，也就是前面在基础介绍中，所说的load(Module)方法。

  • 第一步：定义Module的接口
public interface AutoSizeModel {
    String requestSizeUrl(int width, int height);
}
复制代码
  • 第二步：实现Module接口
public class AutoSizeModelImpl implements AutoSizeModel {

    String mUrl;

    public AutoSizeModelImpl(String url) {
        mUrl = url;
    }

    @Override
    public String requestSizeUrl(int width, int height) {
        return mUrl;
    }
}
复制代码
  • 第三步：定义ModuleLoader和ModuleLoader.Factory
public class AutoSizeModelLoader extends BaseGlideUrlLoader<AutoSizeModel> {

    public static class Factory implements ModelLoaderFactory<AutoSizeModel, InputStream> {

        @Override
        public ModelLoader<AutoSizeModel, InputStream> build(Context context, GenericLoaderFactory factories) {
            return new AutoSizeModelLoader(context);
        }

        @Override
        public void teardown() {}
    }

    public AutoSizeModelLoader(Context context) {
        super(context);
    }

    @Override
    protected String getUrl(AutoSizeModel model, int width, int height) {
        return model.requestSizeUrl(width, height);
    }
}
复制代码
  • 第四步：在CustomGlideModule中进行关联：
public class CustomGlideModule implements GlideModule {

    @Override
    public void applyOptions(Context context, GlideBuilder builder) {
        //经过builder.setXXX进行配置.
    }

    @Override
    public void registerComponents(Context context, Glide glide) {
        //经过glide.register进行配置.
        glide.register(AutoSizeModel.class, InputStream.class, new AutoSizeModelLoader.Factory());
    }
}
复制代码
  • 第五步：调用
public void loadCustomModule(View view) {
        AutoSizeModelImpl autoSizeModel = new AutoSizeModelImpl("http://i.imgur.com/DvpvklR.png");
        Glide.with(this)
                .load(autoSizeModel)
                .diskCacheStrategy(DiskCacheStrategy.NONE)
                .skipMemoryCache(true)
                .into(mImageView);
    }
复制代码

4.4 动态指定ModelLoader

在上面的例子中，咱们是在自定义的CustomGlideModule中指定了Model和ModuleLoader的关联，固然，咱们也能够采用动态指定ModelLoader的方法，也就是说，咱们去掉4.3中的第四步，并把第五步改为下面这样：

public void loadDynamicModule(View view) {
        AutoSizeModelImpl autoSizeModel = new AutoSizeModelImpl("http://i.imgur.com/DvpvklR.png");
        AutoSizeModelLoader autoSizeModelLoader = new AutoSizeModelLoader(this);
        Glide.with(this)
                .using(autoSizeModelLoader)
                .load(autoSizeModel)
                .diskCacheStrategy(DiskCacheStrategy.NONE)
                .skipMemoryCache(true)
                .into(mImageView);
    }
复制代码

使用using方法，咱们就能够在运行时根据状况为同一个Module选择不一样类型的ModuleLoader了。

5、小结

这也是咱们Glide学习的最后一章，全部的源码均可以从下面的连接中找到：

https://github.com/imZeJun/RepoGlideLearn

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程