request_interceptor_zh.md

RequestInterceptor

翻译：English

Sketch 通过 RequestInterceptor 来拦截 ImageRequest 的执行过程，你可以借此改变执行过程的输入和输出

首先实现 RequestInterceptor 接口定义你的 RequestInterceptor，如下：

class MyRequestInterceptor : RequestInterceptor {

    // 如果当前 RequestInterceptor 会修改返回的结果并且仅用于部分请求，那么请给一个不重复的 key 用于构建缓存 key，否则给 null 即可
    override val key: String? = null

    // 用于排序，值越大在列表中越靠后。取值范围是 0 ~ 100。通常是零。只有 EngineRequestInterceptor 可以是 100
    override val sortWeight: Int = 0

    override suspend fun intercept(chain: Chain): Result<ImageData> {
        // 所有请求禁止使用内存缓存
        val newRequest = chain.request.newRequest {
            memoryCachePolicy(CachePolicy.DISABLED)
        }
        return chain.proceed(newRequest)
    }
}

1. MyRequestInterceptor 演示了一个禁止所有请求使用内存缓存的案例
2. 如果你想修改返回结果，就拦截 proceed 方法返回的结果，返回一个新的 ImageData 即可
3. 如果想不再执行请求只需不执行 proceed 方法即可

然后注册你的 RequestInterceptor，如下：

/* 为所有 ImageRequest 注册 */
class MyApplication : Application(), SketchFactory {

    override fun createSketch(): Sketch {
        return Sketch.Builder(this).apply {
            components {
                addRequestInterceptor(MyRequestInterceptor())
            }
        }.build()
    }
}

/* 为单个 ImageRequest 注册 */
imageView.displayImage("https://www.sample.com/image.jpg") {
    components {
        addRequestInterceptor(MyRequestInterceptor())
    }
}