Picasso 源码及流程

具体点说，图片显示到界面上这个过程中可能会遇到这些情况：

加载的图片可能有网络、本地等多种来源；
如果是网络的话，就得先下载下来；
下载过程中可能需要暂停、恢复或者取消；
下载后需要解码、对图片进行一些额外操作（比如裁剪、转变等）；
最好还有个缓存系统，避免每次都去网络请求；
为了实现性能监控，最好再有个数据统计功能…

有了以上需求，根据职责分离的原则，我们可以定义一些核心类来完成上述功能：

请求信息类：其中包含了所有可以配置的选项，比如图片地址、要进行的操作等
图片获取类：根据不同的来源去不同地方获取，比如网络、本地、内存等
调度器类：实现图片获取的入队、执行、完成、取消、暂停等
图片处理类：图片拿到后进行解码、反转、裁剪等
缓存类：图片的内存、磁盘缓存控制
监控类：统计核心数据，比如当前内存、磁盘缓存的大小、某个图片的加载时间等

认识核心 API

图片.png

我给 Picasso 文件夹结构进行了调整，变成了这样：

图片.png

主要分为几个关键部分：

request 文件夹中的：请求信息相关的类
action 文件夹中的：加载行为相关的类
handler 文件夹中的：图片获取具体处理的类
Dispatcher：调度器
BitmapHunter：耗时任务执行者
Picasso：暴露给用户的类

请求信息相关的类

图片.png

上图中的 request 文件夹里放的是 Picasso 中构建图片请求信息相关的类，总共有五个，我们来分别了解下它们。

首先看 Request.java的成员变量（直接看它的 Builder ）：

/** Builder for creating {@link Request} instances. */
public static final class Builder {
  private Uri uri;
  private int resourceId;
  private String stableKey;
  private int targetWidth;
  private int targetHeight;
  private boolean centerCrop;
  private int centerCropGravity;
  private boolean centerInside;
  private boolean onlyScaleDown;
  private float rotationDegrees;
  private float rotationPivotX;
  private float rotationPivotY;
  private boolean hasRotationPivot;
  private boolean purgeable;
  private List transformations;
  private Bitmap.Config config;
  private Priority priority;
  //...
}

可以看到，Request 中放的是一个图片的本地信息、要进行的转换操作信息、图片配置信息以及优先级等。

这里我们可以学习到的是：如果一个请求参数很多，我们最好用一个类给它封装起来，避免在传递时传递多个参数；如果经常使用的话，还可以创建一个对象池，节省开销。

接着看第二个类 RequestCreator:

public class RequestCreator {
  private static final AtomicInteger nextId = new AtomicInteger();

  private final Picasso picasso;
  private final Request.Builder data;

  private boolean noFade;
  private boolean deferred;
  private boolean setPlaceholder = true;
  private int placeholderResId;
  private int errorResId;
  private int memoryPolicy;
  private int networkPolicy;
  private Drawable placeholderDrawable;
  private Drawable errorDrawable;
  private Object tag;
   //...
}

可以看到， RequestCreator 中包含了 Request.Builder，此外还有了些额外的信息，比如是否设置占位图、是否有渐变动画、是否延迟处理、以及占位图错误图资源 ID、内存使用策略、网络请求策略等。
RequestCreator 是相当重要的一个类，我们后面会进一步介绍它。

接着看第三个类 DeferredRequestCreator:

public class DeferredRequestCreator implements OnPreDrawListener, OnAttachStateChangeListener {
  private final RequestCreator creator;
  public @VisibleForTesting final WeakReference target;
  @VisibleForTesting
  public Callback callback;
  //...
}

可以看到， DeferredRequestCreator 中引用了 RequestCreator，此外还有一个要加载的 ImageView 弱引用对象，还有一个 Callback，它实现了 OnPreDrawListener 和 onAttachStateChangeListener 接口，这两个接口的作用如下：

OnPreDrawListener：当布局树将要绘制前，会回调这个借口的 onPreDraw() 方法
onAttachStateChangeListener：当布局绑定到一个 window 或者解除绑定和一个 window 时会调用

DeferredRequestCreator 中比较重要的就是这个 onPreDraw() 方法：

@Override public boolean onPreDraw() {
  ImageView target = this.target.get();
  if (target == null) {
    return true;
  }

  ViewTreeObserver vto = target.getViewTreeObserver();
  if (!vto.isAlive()) {
    return true;
  }

  int width = target.getWidth();
  int height = target.getHeight();

  if (width <= 0 || height <= 0) {
    return true;
  }

  target.removeOnAttachStateChangeListener(this);
  vto.removeOnPreDrawListener(this);
  this.target.clear();

  this.creator.unfit().resize(width, height).into(target, callback);
  return true;
}

在加载网络图片后需要让图片的尺寸和目标 ImageView 一样大时（即调用 RequestCreator.fit() 方法），会使用到 DeferredRequestCreator。

剩下的两个枚举 MemoryPolicy 和 NetworkPolicy 就简单多了。
MemoryPolicy 指定了两种内存缓存策略：不去内存缓存里查找和不写入内存缓存。

public enum MemoryPolicy {
  //当请求图片时不去内存缓存里找
  NO_CACHE(1 << 0),
  //拿到图片后不写到内存缓存里，一般用于一次性请求
  NO_STORE(1 << 1);

  public static boolean shouldReadFromMemoryCache(int memoryPolicy) {
    return (memoryPolicy & MemoryPolicy.NO_CACHE.index) == 0;
  }

  public static boolean shouldWriteToMemoryCache(int memoryPolicy) {
    return (memoryPolicy & MemoryPolicy.NO_STORE.index) == 0;
  }
}

NetworkPolicy 指定了三种网络请求策略：

NO_CACHE： 跳过检查磁盘缓存，强制请求网络
NO_STORE: 拿到结果不写入磁盘缓存中
OFFLINE: 不请求网络，只能去磁盘缓存里查找

public enum NetworkPolicy {
  NO_CACHE(1 << 0),
  NO_STORE(1 << 1),
  OFFLINE(1 << 2);

  public static boolean shouldReadFromDiskCache(int networkPolicy) {
    return (networkPolicy & NetworkPolicy.NO_CACHE.index) == 0;
  }

  public static boolean shouldWriteToDiskCache(int networkPolicy) {
    return (networkPolicy & NetworkPolicy.NO_STORE.index) == 0;
  }

  public static boolean isOfflineOnly(int networkPolicy) {
    return (networkPolicy & NetworkPolicy.OFFLINE.index) != 0;
  }
}

上面介绍了 Picasso 中关于请求信息的五个类，小结一下，它们的作用如下：

Request：保存一个图片的本地信息、要进行的转换操作信息、图片配置信息以及优先级
RequestCreator：保存了一个图片加载请求的完整信息，包括图片信息、是否设置占位图、是否有渐变动画、是否延迟处理、以及占位图错误图资源 ID、内存使用策略、网络请求策略等
MemoryPolicy：定义了加载图片时的两种图片缓存策略
NetworkPolicy：定义了加载图片时的三种网络请求策略

加载行为相关的类

了解完请求信息相关的类后，我们再看看 action 文件夹下，关于加载行为的类（这里的 “加载行为” 是我临时起的名，可能不是很容易理解，稍后我再解释一下）。

图片.png

public abstract class Action {

  public final Picasso picasso;
  public final Request request;
  public final WeakReference target;
  public final boolean noFade;
  public final int memoryPolicy;
  public final int networkPolicy;
  public final int errorResId;
  public final Drawable errorDrawable;
  public final String key;
  public final Object tag;

  public boolean willReplay;
  public boolean cancelled;

  /**
   * 图片获取到后要调用的方法
   * @param result
   * @param from
   */
  public abstract void complete(Bitmap result, Picasso.LoadedFrom from);

  /**
   * 图片获取失败后要调用的方法
   * @param e
   */
  public  abstract void error(Exception e);
}

可以看到， Action 的成员变量里包含了一个图片的请求信息和加载策略、错误占位图，同时定义了两个抽象方法，这两个方法的作用是当图片加载成功后会调用 complete()（参数是拿到的图片和加载来源），加载失败后会调用 eror()，子类继承后可以实现自己特定的操作。

前面提到这些 action 表示的是加载行为，所谓“加载行为”简单点说就是“拿到图片要干啥”

发起一个图片加载请求的目的可能有多种，最常见的就是加载到图片上，对应 Picasso 里的 ImageViewAction（加载完成时它会把图片设置给 ImageView）:

public class ImageViewAction extends Action {

  Callback callback;

    //加载成功，将图片设置给 ImageView
  @Override public void complete(Bitmap result, Picasso.LoadedFrom from) {
    if (result == null) {
      throw new AssertionError(
          String.format("Attempted to complete action with no result!\n%s", this));
    }

    ImageView target = this.target.get();
    if (target == null) {
      return;
    }

    Context context = picasso.context;
    boolean indicatorsEnabled = picasso.indicatorsEnabled;
    PicassoDrawable.setBitmap(target, context, result, from, noFade, indicatorsEnabled);  //设置图片

    if (callback != null) {
      callback.onSuccess();
    }
  }

    //失败时给 ImageView 设置错误图片
  @Override public void error(Exception e) {
    ImageView target = this.target.get();
    if (target == null) {
      return;
    }
    Drawable placeholder = target.getDrawable();
    if (placeholder instanceof Animatable) {
      ((Animatable) placeholder).stop();
    }
    if (errorResId != 0) {
      target.setImageResource(errorResId);
    } else if (errorDrawable != null) {
      target.setImageDrawable(errorDrawable);
    }

    if (callback != null) {
      callback.onError(e);
    }
  }
}

除此外，Picasso 还提供了四种其他用途的加载行为类，源码比较容易理解，这里就直接贴出作用：

FetchAction: 拿到图片后会有个回调，除此外不会将图片显示到界面上
    Picasso.fetch() 方法会使用到它，这个方法在后台线程异步加载图片，只会将图片保存到硬盘或者内存上，不会显示到界面上。如果你不久之后就用这个图片，或者想要减少加载时间，你可以提前将图片下载缓存起来。
GetAction：拿到图片后不会有任何操作，不知道干啥的
    Picasso.get() 方法会使用到它，这个方法会同步加载图片并返回 Bitmap 对象，请确保你没有在Ui线程里面使用.get() 方法。这将会阻塞UI！
RemoteViewsAction： 拿到图片后设置给 RemoteView，有两个实现类 AppWidgetAction 和 NotificationAction，分别对应桌面插件和提醒栏
TargetAction：首先 Target 是 Picasso 中定义的一个接口，表示对图片加载的监听；TargetAction 在拿到图片后会调用 Target 接口的方法

接着介绍 handler 文件夹下的类，这个文件夹中类的功能就是：处理去不同渠道加载图片的请求。

图片.png

其中 RequestHandler 是基类，我们先来看看它。

public abstract class RequestHandler {
  /**
   * Whether or not this {@link RequestHandler} can handle a request with the given {@link Request}.
   */
  public abstract boolean canHandleRequest(Request data);

  /**
   * Loads an image for the given {@link Request}.
   *
   * @param request the data from which the image should be resolved.
   * @param networkPolicy the {@link NetworkPolicy} for this request.
   */
  @Nullable public abstract Result load(Request request, int networkPolicy) throws IOException;

RequestHandler 代码也比较简单，除了几个计算图片尺寸的方法外，最关键的就是上述的两个抽象方法：

boolean canHandleRequest(Request data) 表示当前获取类能否处理这个请求，一般子类会根据请求的 URI 来判断
Result load(Request request, int networkPolicy) 表示根据网络策略加载某个请求，返回加载结果

加载结果 Result 也比较简单：

  public static final class Result {
    private final Picasso.LoadedFrom loadedFrom;    //从哪儿加载的（网络、内存、磁盘）
    private final Bitmap bitmap;
    private final Source source;    //okio 中定义的数据流类
    private final int exifOrientation;    //图片的旋转方向

    public Result(@NonNull Bitmap bitmap, @NonNull Picasso.LoadedFrom loadedFrom) {
      this(checkNotNull(bitmap, "bitmap == null"), null, loadedFrom, 0);
    }

    public Result(@NonNull Source source, @NonNull Picasso.LoadedFrom loadedFrom) {
      this(null, checkNotNull(source, "source == null"), loadedFrom, 0);
    }

    Result(
        @Nullable Bitmap bitmap,
        @Nullable Source source,
        @NonNull Picasso.LoadedFrom loadedFrom,
        int exifOrientation) {
      if ((bitmap != null) == (source != null)) {
        throw new AssertionError();
      }
      this.bitmap = bitmap;
      this.source = source;
      this.loadedFrom = checkNotNull(loadedFrom, "loadedFrom == null");
      this.exifOrientation = exifOrientation;
    }
  }

RequestHandler 的子类实现都比较简单，这里我们就选常见的处理网络和文件请求的获取类来看看。

从名字就可以看出的从网络获取图片处理类 NetworkRequestHandler:

public class NetworkRequestHandler extends RequestHandler {
  private static final String SCHEME_HTTP = "http";
  private static final String SCHEME_HTTPS = "https";

  private final Downloader downloader;
  private final Stats stats;

    public NetworkRequestHandler(Downloader downloader, Stats stats) {
    this.downloader = downloader;
    this.stats = stats;
  }
   //根据请求 uri 的 scheme 判断是否为 http/https 请求
  @Override public boolean canHandleRequest(Request data) {
    String scheme = data.uri.getScheme();
    return (SCHEME_HTTP.equals(scheme) || SCHEME_HTTPS.equals(scheme));
  }

    //去网络加载一个图片
  @Override public Result load(Request request, int networkPolicy) throws IOException {
    okhttp3.Request downloaderRequest = createRequest(request, networkPolicy);
    Response response = downloader.load(downloaderRequest);
    ResponseBody body = response.body();

    if (!response.isSuccessful()) {
      body.close();
      throw new ResponseException(response.code(), request.networkPolicy);
    }

    // Cache response is only null when the response comes fully from the network. Both completely
    // cached and conditionally cached responses will have a non-null cache response.
    Picasso.LoadedFrom loadedFrom = response.cacheResponse() == null ? NETWORK : DISK;

    // Sometimes response content length is zero when requests are being replayed. Haven't found
    // root cause to this but retrying the request seems safe to do so.
    if (loadedFrom == DISK && body.contentLength() == 0) {
      body.close();
      throw new ContentLengthException("Received response with 0 content-length header.");
    }
    return new Result(body.source(), loadedFrom);
  }
}

从上面的代码我们可以看到，Picasso 使用 okhttp3 来完成下载的功能，其中的下载器 downloader 就是通过构造一个 okhttp.Call 来完成同步下载文件：

@NonNull @Override public Response load(@NonNull Request request) throws IOException {
  return client.newCall(request).execute();
}

从文件获取图片的请求处理类 FileRequestHandler：

public class FileRequestHandler extends ContentStreamRequestHandler {

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

  @Override public boolean canHandleRequest(Request data) {
    return SCHEME_FILE.equals(data.uri.getScheme());
  }

  @Override public Result load(Request request, int networkPolicy) throws IOException {
    Source source = Okio.source(getInputStream(request));
    return new Result(null, source, DISK, getFileExifRotation(request.uri));
  }

InputStream getInputStream(Request request) throws FileNotFoundException {
  ContentResolver contentResolver = context.getContentResolver();
  return contentResolver.openInputStream(request.uri);
}


  static int getFileExifRotation(Uri uri) throws IOException {
    ExifInterface exifInterface = new ExifInterface(uri.getPath());
    return exifInterface.getAttributeInt(TAG_ORIENTATION, ORIENTATION_NORMAL);
  }
}

也很简单是吧，根据 URI 获取输入流通过 ContentResolver.openInputStream( Uri uri) 可以实现，这个可以记一下以后可能会用到，拿到 IO 流后，接下来的的操作直接通过 Okio 实现了。

通过这几个图片请求处理类我们可以看到 Picasso 的设计多么精巧，每个类即精简又功能独立，我们在开发时最好可以参考这样的代码，先定义接口和基类，然后再考虑不同的实现。

分析完这些“大家族”后，剩下的就是一些单独的类了。

调度器 Dispatcher

调度器的角色在许多框架里可以看到，实际上在稍微复杂一点的业务逻辑，都需要这么一个调度器类，它负责业务逻辑在不同线程的切换、执行、取消。

我们来看看 Picasso 中的调度器，首先看它的成员变量：

public class Dispatcher {

  private static final String DISPATCHER_THREAD_NAME = "Dispatcher";
  private static final int BATCH_DELAY = 200; // ms

  final DispatcherThread dispatcherThread;    //HandlerThread，用于为子线程 Handler 准备 Looper
  final Context context;
  final ExecutorService service;    //线程池
  final Downloader downloader;    //下载器
  final Map hunterMap;    //Action's key 和 图片猎人 的关联关系
  final Map failedActions;  //失败的操作 map
  final Map pausedActions;  //暂停的操作 map
  final Set