Fresco的源码学习
前言
Fresco android图片加载的框架,facebook出品。
本文是对Fresco框架源码的阅读学习后的记录,主要是理清三个主要类的之间的关系。
本篇目录
Fresco框架的MVC模式
Fresco的DraweeView、DraweeHierarchy、DraweeController的简单介绍
Fresco的DraweeView、DraweeHierarchy、DraweeController的创建顺序
一、Fresco 框架的 MVC模式
View DraweeView
Model DraweeHierarchy
Controleer DraweeController
类关系其中DraweeHierarchy和DraweeController保存在DraweeHolder中,需要从DraweeHolder中get方式得到。
目的是将DraweeHierarchy和DraweeController封装在一起,解耦出来。
如果要自定义DraweeView只需要在类中新添DraweeHolder类就可以比较方便地拥有DraweeHierarchy和DraweeController了。
二、DraweeView、DraweeHierarchy、DraweeController的简单介绍
V-DraweeView
DraweeView,及其子类
SimpleDraweeViewView
SimpleDraweeView为开发人员使用Fresco加载图片的直接创建对象,控件对外的表层的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
Hierarchy类关系SettableDraweeHierarchy、DraweeHierarchy皆为接口类,GenericDraweeHierarchy实现他们的方法。
DraweeHierarchy
接口类,只有一个简单却重要的方法,FaceDrawable是个图片数组,里面包含所需要的所有图片。
作用:获得在Hierarchy中的FadeDrawable中储存的顶层图片进行显示
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
DraweeController相关类在初始化框架时,会创建一个PipelineDraweeControllerBuilderSupplier,并保存在SimpleDraweeView和Fresco两个类中,以静态变量的方式,所以DraweeController的创建有两个入口。
一、使用Fresco类方式(代码中创建):
code片段DraweeController的创建过程:
1.调用Fresco.newDraweeControllerBuilder(),获得PipelineDraweeControllerBuilder。
2.再调用PipelineDraweeControllerBuilder的父类AbstractDraweeControllerBuilder 的 build()方法,build()又调用了obtainController(),该方法又调用了PipelineDraweeControllerBuilder的obtainController(),获得PipelineDraweeController。
3.最后build()方法返回的是,获得的PipelineDraweeController的父类AbstractDraweeController。
这里有点绕,大致的顺序是:
Fresco.newDraweeControllerBuilder()获得PipelineDraweeControllerBuilder
class Fresco
--public static PipelineDraweeControllerBuilder newDraweeControllerBuilder()
class PipelineDraweeControllerBuilderSupplier
--public PipelineDraweeControllerBuilder get()
PipelineDraweeControllerBuilder.build()获得AbstractDraweeController
class AbstractDraweeControllerBuilder
--public AbstractDraweeController build()
---protected AbstractDraweeController buildController()
----protected abstract AbstractDraweeController obtainController()
class PipelineDraweeControllerBuilder
--protected PipelineDraweeController obtainController()
二、使用默认方式(不用自己创建):
提供给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去操作View(第二种),如果需要加上一些图片加载监听之类的操作,则自己创建Controller去操作(第一种)。
三、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 holder =newDraweeHolder(hierarchy);
holder.registerWithContext(context);returnholder;
}
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
②.在代码中使用到的时候动态创建,能自定义更多关于图片的属性方法,如需要监听一张GIF图片的播放结束事件,就需要自己在代码中动态创建(高版本已经把对gif的支持单独出去)