【译】自定义RequestHandler

• 原文链接： Custom Request Handlers
• 原文作者： Future Studio
• 译文出自： 小鄧子的简书
• 译者： 小鄧子
• 状态： 完成

通过Picasso.Builder自定义RequestHandler

不得不再次声明，我们不对如何创建Picasso实例做详细讲解，但是，我们希望你能理解如下代码片段：

// create Picasso.Builder object
Picasso.Builder picassoBuilder = new Picasso.Builder(context);

// add our custom eat foody request handler (see below for full class)
picassoBuilder.addRequestHandler(new EatFoodyRequestHandler());

// Picasso.Builder creates the Picasso object to do the actual requests
Picasso picasso = picassoBuilder.build();  

唯一你会感到陌生的是，在这篇指导范例中，我们设置了EatFoody作为RequestHandler，添加方式非常的简单，直接：

picassoBuilder.addRequestHandler(new EatFoodyRequestHandler());  

现在，我们的Picasso实例已经知道了这个RequestHandler，并将之后的所有请求传递给它。所有的准备工作都已经完成了，让我们一起来深入理解RequestHandler类。

RequestHandler的详细实现

RequestHandler接口有两个方法函数：

1. boolean canHandleRequest(Request data)
2. Result load(Request request, int networkPolicy)

第一个方法用来告诉Picasso能否处理当前请求。如果可以处理，那么这个请求将会传递给load()方法。

一个完整的RequestHandler实现，看起来就像这样：

public class EatFoodyRequestHandler extends RequestHandler {  
    private static final String EAT_FOODY_RECIPE_SCHEME = "eatfoody";

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

    @Override
    public Result load(Request request, int networkPolicy) throws IOException {
       // do whatever is necessary here to load the image
       // important: you can only return a Result object
       // the constructor takes either a Bitmap or InputStream object, nothing else!

       // get the key for the requested image
       // if the schema is "eatfoody://cupcake", it'd return "cupcake"
       String imageKey = request.uri.getHost();

       Bitmap bitmap;
       if (imageKey.contentEquals("cupcake")) {
           bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.cupcake);
       }
       else if (imageKey.contentEquals("full_cake")) {
           bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.full_cake);
       }
       else {
           // fallback image
           bitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher);
       }

       // return the result with the bitmap and the source info
       return new Result(bitmap, Picasso.LoadedFrom.DISK);
    }
}

正如你所见，这个代码片段用来解析Eat Foody项目中，所包含的特定schema的Uri。

在canHandleRequest方法中，会检查即将到来的的Uri请求是否以“eatfoody”作为schema（如，eatfoody://cupcake）。如果不匹配，Picasso将会检查其他的RequestHandler能否满足条件，最后，如果所有的RequestHandler都不能处理这个请求，则交回给标准下载器，如果可能的话。

如果请求真的以eatfoody作为schema，那么我们所实现的load()将会被调用，并返回一个可靠的Result对象（理论上应该持有一个Bitmap对象）。我们所实现的RequestHandler应该至少可以做网络请求，或者从手机的磁盘中加载图像。简单起见，我们仅仅匹配了两个最常见的Uri路径，然后通过应用的资源文件加载图像。如果都不匹配，那就返回应用的Icon。

最后，我们应该创建Result对象，并返回处理后的Bitmap。它是Bitmap的包装类，用来持有资源等属性。在这个用例中，我们从磁盘中加载图像。

请求示例

干货已经足够了，让我们来看一些示例。和以往一样，如果使用Picasso加载标准http请求，那么将无法用到刚刚定义的RequestHandler（因为http的scheme无法与eatfoody匹配）。Picasso将会正常的加载图像。

// example #1: regular HTTP Uri schema, which will not use our custom request handler
picasso  
    .load(UsageExampleListViewAdapter.eatFoodyImages[0])
    .into(imageView1);

不过，你可以使用这个Picasso实例来请求eatfoody地址。Picasso会检测我们的RequestHandler是否能处理这个任务，亦或是让我们从磁盘中加载适当的图像。

总结

Picasso让处理自定义Uri scheme变的尽可能简单。它的实现非常简单，也很容易掌握。这篇博客为你示范了如何通过自定义RequestHandler来处理任务。当然，我们所演示的有可能只使用RequestHandler技巧中的冰山一角。

欢迎在下方留言，告诉我们你是如何使用RequestHandler的。