×

【译】自定义RequestHandler

96
小鄧子
2016.06.20 02:34* 字数 831

通过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的。

深入浅出-Picasso
Web note ad 1