fresco的源码学习自我总结

前言

　　对fresco框架源码的阅读学习，学习优秀的编码方式和较为实用常见设计模式，该篇讲得比较浅，主要是理清三个主要类的之间的关系。

 本篇目录 

• fresco框架的MVC模式
• fresco的DraweeView、DraweeHierarchy、DraweeController的简单介绍
• fresco的DraweeView、DraweeHierarchy、DraweeController的建立顺序
  
  

 fresco 框架的 MVC模式

View - DraweeView

Model - DraweeHierarchy

Controleer - DraweeController

其中Hierarchy和Controller保存在DraweeHolder中，须要从Holder中get方式获得。目的是将Hierarchy和Controller封装在一块儿，解耦出来，若是要自定义DraweeView只须要在类中新添DraweeHolder类就能够比较方便地拥有Hierarchy和Controller了。

　　DraweeView
　　DraweeHolder
　　　　|　　
　　　　|-- DraweeHierarchy
　　　　|
　　　　|-- DraweeController

----------------------------------------------------------------------------------------------------------------------------------------

 fresco的DraweeView、DraweeHierarchy、DraweeController的简单介绍 

 V-DraweeView 
　　　　　　　　　　　　　　　　　　
　　　　　　　　　　　　　　　　　　|--------- DraweeView
　　　　　　　　　　　　　　　　　　|　　　　　　
　　　　　　　　　　　　　　　　　　|(extends)

　　　　　　　　|--------- GenericDraweeView
　　　　　　　　|　　　　　　
　　　　　　　　|(extends)
　　　　SimpleDraweeView

(越接近开发者的层越为简单，方便理解，较为复杂的逻辑在顶层父类实现。)

SimpleDraweeViewView

　　控件对外的表层的model，只提供简单setImageURL方法，做用为修改显示图片URL

public void setImageURI(Uri uri)

public void setImageURI(@Nullable String uriString)

public void setImageURI(@Nullable String uriString, @Nullable Object callerContext)

public void setImageURI(Uri uri, @Nullable Object callerContext)

 

GenericDraweeView

　　其方法只有一个，在其构造方法中被调用，做用为初始化DraweeHierarchy

protected void inflateHierarchy(Context context, @Nullable AttributeSet attrs)

 

DraweeView

 　　0.11.0版本依然是继承自ImageView，看网上说后面会直接继承自View，负责图片的显示，其中重要的一个方法：getTopLevelDrawable()用来得到Hierarchy储存的顶层图片进行显示。

  @Nullable public Drawable getTopLevelDrawable() {
    return mDraweeHolder.getTopLevelDrawable();
  }

DraweeHolder: public Drawable getTopLevelDrawable() {
    return mHierarchy == null ? null : mHierarchy.getTopLevelDrawable();
  }

 

   M-DraweeHierarchy 

　　　　　　　　　　　　　　　　　　|--------- DraweeHierarchy
　　　　　　　　　　　　　　　　　　|　　　　　　
　　　　　　　　　　　　　　　　　　|(extends)

　　　　　　　　|--------- SettableDraweeHierarchy
　　　　　　　　|　　　　　　
　　　　　　　　|(implements)
　　　GenericDraweeHierarchy

　SettableDraweeHierarchy、DraweeHierarchy皆为接口类，GenericDraweeHierarchy实现他们的方法。

 

DraweeHierarchy

　　只有一个简单却重要的方法，做用得到在Hierarchy中的FadeDrawable中储存的顶层图片进行显示，FaceDrawable是个图片数组，里面包含所须要的全部图片。

  Drawable getTopLevelDrawable();

 

SettableDraweeHierarchy

　　里面的接口方法均为提供给Controller调用来控制图像，在GenericDraweeHierarchy中实现

  void reset();
  void setImage(Drawable drawable, float progress, boolean immediate);
  void setProgress(float progress, boolean immediate);
  void setFailure(Throwable throwable);
  void setRetry(Throwable throwable);
  void setControllerOverlay(Drawable drawable);

 

GenericDraweeHierarchy

　　GenericDraweeHierarchy实现了父类的接口，提供给Controller调用来控制图片的显示。

　　其中要三个主要的Drawable对象：

　　FadeDrawable，它存储了须要到的图片资源，包括显示图片、加载图片、失败时显示的图片等等。继承自ArrayDrawable，层级类图片集合。会选择图片数组中的最后一张进行显示。

　　RootDrawable（mTopLevelDrawable）即储存了FadeDrawable的顶层图片，为要即将要显示的图片

　　ForwardingDrawable（mActualImageWrapper） 即储存了目标图片

　　其中FadeDrawable类中的主要方法有:

  public void setTransitionDuration(int durationMs);\\设置隐藏/显示图层渐变更画时间（默认为300ms）
  public void fadeInLayer(int index);\\显示指定图层
  public void fadeOutLayer(int index);\\隐藏指定图层
  public void fadeInAllLayers();\\显示全部图层
  public void fadeOutAllLayers();\\隐藏全部图层
  public void fadeToLayer(int index);\\显示指定图层同时隐藏其余图层
  public void fadeUpToLayer(int index);\\隐藏数组下标<=index的图层

　　以上方法 会修改 boolean[] mIsLayerOn布尔数组，来判断是否显示图片。

 

   C-DraweeController 

 

• 　　在初始化框架时会建立一个PipelineDraweeControllerBuilderSupplier，并保存在SimpleDraweeView和Fresco两个类中，以静态变量的方式，因此Controller的建立有两个入口。
• 　　建立Controller时经过初始化的sDraweeControllerBuilderSupplier得到一个SimpleDraweeControllerBuilder，再用建造器模式建立出一个DraweeController。
• 　　事实上DraweeController的建立是在AbstractDraweeControllerBuilder调用实现了的build()方法，buildr()方法又调用了PipelineDraweeControllerBuilder得到一个PipelineDraweeController，返回builder()后转换成AbstractDraweeController，在最外层的调用又转换成DraweeController。(java的多态)

　　提供给SimpleDraweeView建立Controller的方法只有简单的几个，即在SimpleDraweeControllerBuilder中的接口方法。

　SimpleDraweeControllerBuilder

  SimpleDraweeControllerBuilder setCallerContext(Object callerContext);
  SimpleDraweeControllerBuilder setUri(Uri uri);
  SimpleDraweeControllerBuilder setUri(@Nullable String uriString);
  SimpleDraweeControllerBuilder setOldController(@Nullable DraweeController oldController);
  DraweeController build();

　　而在代码中动态建立Controller再设置给SimpleDraweeView则有更多能够设置的属性方法，这些方法保存在AbstractDraweeController中，建立方式在下面会写到。

 

fresco的DraweeView、DraweeHierarchy、DraweeController的建立顺序

初始化顺序为：

1.DraweeView

其他都为DraweeView对象中的类，因此先有DraweeView

 

2.DraweeHolder (在DraweeView的init()方法中建立 保存在DraweeView中) 

DraweeView:
DraweeHolder.create(null, context)

DraweeHolder: public static <DH extends DraweeHierarchy> DraweeHolder<DH> create(
      @Nullable DH hierarchy,
      Context context) {
    DraweeHolder<DH> holder = new DraweeHolder<DH>(hierarchy);
    holder.registerWithContext(context);
    return holder;
  }

 

3.DraweeHierarchy (在GenericDraweeView的inflateHierarchy()方法中建立 保存在DraweeHolder和DraweeController中)

GenericDraweeView:
 protected void inflateHierarchy(Context context, @Nullable AttributeSet attrs) {
    GenericDraweeHierarchyBuilder builder =
        GenericDraweeHierarchyInflater.inflateBuilder(context, attrs);
    setAspectRatio(builder.getDesiredAspectRatio());
    setHierarchy(builder.build());
  }

 

 4.DraweeController

并不预先建立，而是在使用到控件的时候动态建立，有两种建立途径，但两种都是经过拿到DraweeControllerBuilderSupplier 用建造器模式去建立Controller

　　①.调用SimpleDraweeView中的setImageURL()，源码中已写好建立Controller的代码，只设置图片URL

例：（SimpleDraweeView中的源码）
  　　public void setImageURI(Uri uri, @Nullable Object callerContext) {
    　　DraweeController controller = mSimpleDraweeControllerBuilder
        　　.setCallerContext(callerContext)
        　　.setUri(uri)
        　　.setOldController(getController())
        　　.build();
    　　setController(controller);
  　　}

 

　　②.在代码中使用到的时候动态建立，能自定义更多关于图片的属性方法，如须要监听一张GIF图片的播放结束事件，就须要本身在代码中动态建立(高版本已经把对gif的支持单独出去，这里只作一个例子)

例：（本身项目代码）
        SimpleDraweeView view = (SimpleDraweeView) contentView.findViewById(R.id.exp_first_gif);

        ControllerListener listener = new BaseControllerListener() {
            @Override
            public void onFinalImageSet(String id, @Nullable Object imageInfo, @Nullable Animatable animatable) {
                super.onFinalImageSet(id, imageInfo, animatable);
                valueAnimator.start();
            }

        };

        Uri uri = Uri.parse("res://com.--------/" + R.drawable.gif_exp_one);
        DraweeController draweeController =
                Fresco.newDraweeControllerBuilder()
                        .setControllerListener(listener)
                        .setUri(uri)
                        .setAutoPlayAnimations(true) // 设置加载图片完成后是否直接进行播放
                        .build();
        view.setController(draweeController);