【译】自定义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接口有两个方法函数：
boolean canHandleRequest(Request data)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的。