使用 CloseableReference 优雅的释放对象，来自 Fresco

前言

说到 Fresco，想必各位都耳熟能详，出自 Facebook 的大名鼎鼎的图片加载框架，虽然最近几年被 Glide 凭借轻量和易用性而超越，但我们仍无法否认 Fresco 的强大和优秀的性能，这里不再展开。

今天要介绍的是 Fresco 基于 Bitmap 复用逻辑上抽象出的，通用的、安全的可自动释放的引用，官方文档也有专门的页面介绍「可关闭的引用」，但是发现大家真正使用的并不多，因此觉得有必要再介绍一下。

使用

这里引用官方文档的使用介绍

1. 调用者拥有这个引用

我们创建一个引用，但我们传递给了一个调用者，调用者将持有这个引用。

CloseableReference foo() {
  Val val;
  return CloseableReference.of(val);
}

2. 持有者在离开作用域之前，需要关闭引用

创建了一个引用，但是没有传递给其他调用者，在结束时，需要关闭：

void gee() {
  CloseableReference ref = foo();
  try {
    haa(ref);
  } finally {
    ref.close();
  }
}

finally 中最适合做此类事情了。

3. 在赋值给变量前，先进行 clone

void haa(CloseableReference ref) {
  final CloseableReference refClone = ref.clone();
  try {
    // 交给下个作用域处理
    ohaa(refClone);
  } finally {
    // 当前函数域内可安全关闭，闭包内为已经clone过的引用。
    ref.close();
  }
}

使用可以说非常简单了

• 通过 CloseableReference.of 创建一个可关闭的引用
• 未关闭的引用通过 CloseableReference.get 获取引用的实例
• 通过 CloseableReference.close 关闭引用
• 通过 CloseableReference.clone 复制一个引用，交给下一个函数处理，当前域的引用即可安全关闭
• 当激活的引用为0时，即会销毁该实例

不知道大家有没有发现一个问题，上面并没有介绍实例是怎么销毁的，这里就需要配合源码一起看了。

CloseableReference.of 方法有两个重载，分别是

public static  CloseableReference of(T t)

public static  CloseableReference of(T t, ResourceReleaser resourceReleaser)

这样就比较清晰了，官方示例中使用的是一个 Closeable 的实例，在销毁的时候会调用 Closeable.close 方法，Closeable 是 JDK 中的接口，在源码中非常常见，比如我们最熟悉的 InputStream 就实现了该接口，大家一定还记得在使用完 InputStream 之后要调用 close 方法，避免内存泄露。

那如果我的实例没有实现 Closeable 接口呢，这种情况就需要用到 CloseableReference.of 的另一个重载函数了，那么 ResourceReleaser 又是什么呢

public interface ResourceReleaser {

  /**
   * Release the given value.
   *
   * 
After calling this method, the caller is no longer responsible for managing lifetime of the
   * value.
   *
   * 
This method is not permitted to throw an exception and is always required to succeed. It is
   * often called from contexts like catch blocks or finally blocks to cleanup resources. Throwing
   * an exception could result in swallowing the original exception.
   *
   * @param value
   */
  void release(T value);
}

其实就是一个对象释放器，这里配合 对象池 一起食用效果更佳。

源码分析

我们以最简单的使用方式分析一下主要流程。

引用构建

先从入口开始，即 CloseableReference.of，假设我们要关闭的是一个实现了 Closeable 接口的实例

public static  CloseableReference of(@PropagatesNullable T t) {
  return of(t, (ResourceReleaser) DEFAULT_CLOSEABLE_RELEASER);
}

如果是 Closeable 的子类，使用默认的 ResourceReleaser

private static final ResourceReleaser DEFAULT_CLOSEABLE_RELEASER = new ResourceReleaser() {
  @Override
  public void release(Closeable value) {
    try {
      Closeables.close(value, true);
    } catch (IOException ioe) {
    }
  }
};

处理非常简单，直接调用 close 方法。继续往下看

public static  CloseableReference of(@PropagatesNullable T t, ResourceReleaser resourceReleaser) {
  return of(t, resourceReleaser, DEFAULT_LEAK_HANDLER);
}

又调用了一个重载方法，传入了一个默认的 LeakHandler，LeakHandler 的作用主要是在 class 的 finalize() 方法中，判断引用是否关闭，如果未关闭则调用 LeakHandler.reportLeak 通知泄露。

@Override
protected void finalize() throws Throwable {
  if (mIsClosed) {
    return;
  }

  T ref = mSharedReference.get();
  mLeakHandler.reportLeak((SharedReference