【转载】逃离adapter的地狱－针对多个View type的组合实现方案

英文原文：JOE'S GREAT ADAPTER HELL ESCAPE

转载地址：http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0810/3282.html

让我来告诉你一个关于乔某人的故事，一个在MyLittleZoo Inc工作的安卓开发者。关于他是如何从为具有多个view type的Adapter创建不同对象中解脱出来，最终成功实现可复用Adapter的。

曾经有一个叫做乔某某的人，它是一个安卓开发者，为一家名叫MyLittleZoo Inc的初创公司工作。这是一家在网上销售宠物相关东西的公司。乔的工作是创建和维护一个与在线商店功能相同的安卓原生app。因此90%的开发工作都只是用RecyclerView显示一个列表。第一个版本1.0只需要显示一个配料列表，为此乔实现了一个AccessoiresAdapter，但是特别推荐的配料用item_accessory_offer.xml 显示，而普通配料则用item_accessory.xml显示。因此这个Adapter有两种View type。在adapter中，view type可以让你为不容的item渲染不同的xml布局。在内部view type其实只是一个唯一的id，一个整型。因此乔的AccessoiresAdapter大致是这样实现的：

public class AccessoiresAdapter extends RecyclerView.Adapter {

  final int VIEW_TYPE_ACCESSORY = 0;
  final int VIEW_TYPE_ACCESSORY_SPECIAL_OFFER = 1;

  List<Accessory> items;

  @Override public int getItemViewType(int position) {
     Accessory accessory = items.get(postion);
     if (accessory.hasSpecialOffer()){
       return VIEW_TYPE_ACCESSORY_SPECIAL_OFFER;
     } else {
       return VIEW_TYPE_ACCESSORY;
     }
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if (VIEW_TYPE_ACCESSORY_SPECIAL_OFFER == viewType){
      return new SpecialOfferAccessoryViewHolder(inflater.inflate(R.layout.item_accessory_offer, parent));
    } else {
      return new AccessoryViewHolder (inflater.inflate(R.layout.item_accessory)):
    }
  }

  ...

}

MyLittelZoo安卓app1.0发布在了play store上。一切看上去都还好，一直相安无事。

后来，MyLittelZoo变大了，app也是如此。乔需要实现一个新的启动Activity，这里需要显示不同item：NewsTeaser需要和配料显示在一起，所以他建立了HomeAdapter，因为HomeAdapter需要同时显示配料，所以他决定通过继承AccessoriesAdapter来重用之前的代码：

public class HomeAdapter extends AccessoriesAdapter {

  final int VIEW_TYP_NEWS_TEASER = 2;

  @Override public int getItemViewType(int position) {
     if (items.get(position) instanceof NewsTeaser){
       return VIEW_TYP_NEWS_TEASER;
     } else {
       // accessories and special offers
       return super.getItemViewType(position);
     }
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if (VIEW_TYP_NEWS_TEASER == viewType){
      return new NewsTeaserItem( inflater.inflate(R.layout.item_news_teaser, parent));
    } else {
      // accessories and special offers
      return super.onCreateViewHolder(parent, viewType);
    }
  }

  ...
}

同时还有一个新的只显示关于宠物食物的小建议的Activity需要实现，因此乔实现了PetFoodTipAdapter：

public class PetFoodTipAdapter extends RecyclerView.Adapter {

  final int VIEW_TYP_FOOD_TIP = 0;

  @Override public int getItemViewType(int position) {
     return VIEW_TYP_FOOD_TIP;
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    return new PetFoodViewHolder(inflater.inflate(R.layout.item_pet_food, parent))
  }

  ...

}

因为他能按时交付，他的项目经理非常高兴。MyLittelZoo 2.0 成功发布在 Play Store上。

几周之后，产品经理跑来跟乔说，生意的发展不及预期。为了赚钱，gongsi决定和一家大广告公司签订一份协议。这家广告公司可以在MyLittleZoo的安卓app上展示横幅，换句话说：乔的公司把自己的灵魂出卖给了魔鬼。乔的工作是使用别人提供的广告sdk，把广告横幅包含在app中。时间紧迫，公司需要钱（从广告上收益）。app的更新必须尽快发布。因为广告横幅需要和RecyclerView中的其他的item显示在一起，乔决定创建一个名叫calledAdvertismentAdapter的基类adapter。

public class AdvertismentAdapter extends RecyclerView.Adapter {

  final int VIEW_TYP_ADVERTISEMENT = 0;

  @Override public int getItemViewType(int position) {
     return VIEW_TYP_ADVERTISEMENT;
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    return new AdvertismentViewHolder(inflater.inflate(R.layout.item_advertisment, parent))
  }

  ...

}

从此，其他的所有adapter都继承自AdvertisementAdapter：

AccessoiresAdapter 继承 AdvertisementAdapter
HomeAdapter 继承 AccessoiresAdapter 继承 AdvertisementAdapter
PetFoodTipAdapter 继承 AdvertisementAdapter

到处充满广告的3.0 版本发布在了Play Store上。产品经理再次对乔的工作感到满意。

半年之后，产品经理再次敲响了乔的门，告诉他事情有了变化。MyLittleZoo 安卓app的用户不喜欢3.0版本中那些亮瞎人狗眼的广告横幅，app在play store上受到了大量的差评。访问量大减，公司不再盈利了。但是MyLittleZoo不能简单的从app中撤掉广告，因为他们和“魔鬼”签订了一个相当长的合同，魔鬼这里指的当然是广告公司。

然后MyLittleZoo市场部有个聪明的家伙，他想到了重启一个app项目，只在一个RecyclerView中显示NewsTeaser和PetFoodTip。没有广告，没有推荐。按计划是为了赢回用户的信任。再一次，产品经理告诉乔app需要在两天之内发布，因为在接下来的周末又一个很大的宠物节，app需要在届时呈现才行。乔认为这是可行的。他已经有了NewsTeaser和PetFoodTip的xml布局，adapter也已经是实现了的。因此乔只需把它们搬到一个library中，在原始的MyLittleZoo app和新的无广告版的advertisement app中共享。

乔准备开始把东西搬到这个library，这时他意识到了此时面对的混乱境地：你还记得adapter的继承关系吗？

每个adapter都继承自AdvertisementAdapter。但是新的app不需要显示广告。此外，显示横幅的广告sdk实在是太bug了，导致了太多的内存泄漏，经常崩溃。即使没有显示广告，sdk也还是在背后干很多事情。因此在新的app中包含广告sdk时不能接受的。

对于同时显示NewsTeaser（HomeAdapter的一部分）和PetFoodTip（PetFoodTipAdapter的一部分），没有可以重用的adapter。乔该怎么办呢？他可以创建一个新的NewsTipAdapter继承自HomeAdapter，然后把PetFoodTip作为一个心的view type添加进去。但是那就意味着对于同一个view type有两个adapter需要维护。

欢迎来到adapter的地狱，乔！

可怜的娃儿，乔非常沮丧。沮丧过后是担忧。他该如何修复这个问题呢？他该如何修复才能避免一个月之后因为实现新功能（一个心的view type）而再次修复呢？

因此乔开始把自己的需求写在了白板上。但是没有想出什么办法。他很悲伤，他想到了自己的孩提时代，那个时候生活是多么轻松。那时候需要担心的唯一事情就是在耍完乐高以后清理自己的房间。乐高？等等！乔有了个聪明的主意：他真正需要的是像堆积乐高房子一样的构建自己的adapter：做好一个地基，然后把真正需要的乐高部件粘在一起。如果你的房子需要窗户，去取一个窗户部件；如果需要屋顶，取一个屋顶部件；如果需要后花园，取一朵花的部件。

靠，接着他就有了大致的图景：

组合优于继承

在和其他程序员讨论的时候，他不止一次同意“组合优于继承”的观点。在这之前，这对于他来说不过是一句口号而已，而现在他才真正根据这个准则构建出一点东西来。好了，一个空的adapter是地基。ViewType则是可重用的组件（乐高部件）。

因此乔开始定义可复用的乐高部件比如NewsTeaserAdapterDelegate和andPetFoodTipAdapterDelegate：

public class NewsTeaserAdapterDelegate {

  private int viewType;

  public NewsTeaserAdapterDelegate(int viewType){
    this.viewType = viewType;
  }

  public int getViewType(){
    return viewType;
  }

  public boolean isForViewType(List items, int position) {
    return  items.get(position) instanceof NewsTeaser;
  }

  public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent) {
    return new NewsTeaserViewHolder(inflater.inflate(R.layout.item_news_teaser, parent, false));
  }

  public void onBindViewHolder(List items, int position, RecyclerView.ViewHolder holder) {
      NewsTeaser teaser = (NewsTeaser) items.get(position);
      NewsTeaserViewHolder vh = (NewsTeaserViewHolder) vh;

      vh.title.setText(teaser.getTitle());
      vh.text.setText(teaser.getText());
  }
}

public class PetFoodTipAdapterDelegate {

  private int viewType;

  public PetFoodTipAdapterDelegate(int viewType){
    this.viewType = viewType;
  }

  public int getViewType(){
    return viewType;
  }

  public boolean isForViewType(List items, int position) {
    return  items.get(position) instanceof PetFoodTip;
  }

  public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent) {
    return new PetFoodTipViewHolder(inflater.inflate(R.layout.item_pet_food, parent, false));
  }

  public void onBindViewHolder(List items, int position, RecyclerView.ViewHolder holder) {
      PetFoodTip tip = (PetFoodTip) items.get(position);
      PetFoodTipViewHolder vh = (NewsTeaserViewHolder) vh;

      vh.image.setImageRes(tip.getImage());
      vh.text.setText(tip.getText());
  }
}

然后是地基，一个空的adapter，然后把乐高部件放在上面，创建NewsTipAdapter，在新app中使用：

public class NewsTipAdapter extends RecyclerView.Adapter{

  final int VIEW_TYP_NEWS_TEASER = 0;
  final int VIEW_TYP_FOOD_TIP = 1;

  NewsTeaserAdapterDelegate newsTeaserDelegate;
  PetFoodTipAdapterDelegate foodTipDelegate;

  List items;

  public NewsTipAdapter(){
    newsTeaserDelegate = new NewsTeaserAdapterDelegate(VIEW_TYP_NEWS_TEASER);
    foodTipDelegate = new PetFoodTipAdapterDelegate(VIEW_TYP_FOOD_TIP);
  }

  @Override public int getItemViewType(int position) {
     if (newsTeaserDelegate.isForViewType(items, position)){
       return newsTeaserDelegate.getViewType();
     }
     else if (foodTipDelegate.isForViewType(items, position)){
       return foodTipDelegate.getViewType();
     }

     throw new IllegalArgumentException("No delegate found");
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {

    if (newsTeaserDelegate.getViewType() == viewType){
      return newsTeaserDelegate.onCreateViewHolder(parent);
    }
    else if (foodTipDelegate.getViewType() == viewType){
      return foodTipDelegate.onCreateViewHolder(parent);
    }

    throw new IllegalArgumentException("No delegate found");
  }

  @Override public void onBindViewHolder(VH holder, int position){
    int viewType = holder.getViewType();
    if (newsTeaserDelegate.getViewType() == viewType){
      newsTeaserDelegate.onBindViewHolder(items, position, holder);
    }
    else if (foodTipDelegate.getViewType == viewType){
      foodTipDelegate.onBindViewHolder(items, position, holder);
    }
  }
}

我猜你应该看明白了。与使用继承不同，乔定为每个view type义了一个delegate。每个delegate负责创建和绑定ViewHolder。就如你看到的，上面的代码片段有许多散乱的代码。乔发现了一个插件式的解决办法：

/**
 * @param <T> the type of adapters data source i.e. List<Accessory>
 */
public interface AdapterDelegate<T> {

  /**
   * Get the view type integer. Must be unique within every Adapter
   *
   * @return the integer representing the view type
   */
  public int getItemViewType();

  /**
   * Called to determine whether this AdapterDelegate is the responsible for the given data
   * element.
   *
   * @param items The data source of the Adapter
   * @param position The position in the datasource
   * @return true, if this item is responsible,  otherwise false
   */
  public boolean isForViewType(@NonNull T items, int position);

  /**
   * Creates the  {@link RecyclerView.ViewHolder} for the given data source item
   *
   * @param parent The ViewGroup parent of the given datasource
   * @return The new instantiated {@link RecyclerView.ViewHolder}
   */
  @NonNull public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent);

  /**
   * Called to bind the {@link RecyclerView.ViewHolder} to the item of the datas source set
   *
   * @param items The data source
   * @param position The position in the datasource
   * @param holder The {@link RecyclerView.ViewHolder} to bind
   */
  public void onBindViewHolder(@NonNull T items, int position, @NonNull RecyclerView.ViewHolder holder);
}

public class AdapterDelegatesManager<T> {

  public AdapterDelegatesManager<T> addDelegate(@NonNull AdapterDelegate<T> delegate) {
    ...
  }

  public int getItemViewType(@NonNull T items, int position) {
    ...
  }

  public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    ...
  }

  public void onBindViewHolder(@NonNull T items, int position, @NonNull RecyclerView.ViewHolder viewHolder) {
    ...
  }
}

这个办法就是把AdapterDelegate注册到一个AdapterDelegatesManager。AdapterDelegatesManager内部有决定不同view type采取何种AdapterDelegate的逻辑与调用相应的delegate方法。应用到NewsTipAdapter中的代码大致如下：

public class NewsTipAdapter extends RecyclerView.Adapter{

  final int VIEW_TYP_NEWS_TEASER = 0;
  final int VIEW_TYP_FOOD_TIP = 1;

  List items;

  AdapterDelegatesManager delegates = new AdapterDelegatesManager();

  public NewsTipAdapter(){
    delegates.add(new NewsTeaserAdapterDelegate(VIEW_TYP_NEWS_TEASER));
    delegates.add(new PetFoodTipAdapterDelegate(VIEW_TYP_FOOD_TIP));
  }

  @Override public int getItemViewType(int position) {
     return delegates.getItemViewType(items, position);
  }

  @Override public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    return delegates.onCreateViewHolder(parent, viewType);
  }

  @Override public void onBindViewHolder(VH holder, int position){
      delegates.onBindViewHolder(items, position, holder);
  }
}

我猜你应该能想象MyLittleZoo app其它adapter的样子了。总共有AdvertisementAdapterDelegate, NewsTeaserAdapterDelegate, PetFoodTipAdapterDelegate 和AccessoryAdapterDelegate。从此adapter可以通过那些真正需要的view type（AdapterDelegate）来组合。另外一个好处是你将inflating布局，创建view holder，绑定view holder的过程从adapter中分离出来，成了单独的，模块化的，可复用的AdapterDelegate。你有注意到现在adapter看起来是多了小巧吗？你可分散注意力到扩展性和降低耦合上面来了。另一个附加效果就是更多的团队成员可以在adapter上协同工作，而不用担心复杂的融合问题，因为不是每个人都接触庞大的adapter文件，而是团队成员同时专注于不同的AdapterDelegate 文件。

乔非常高兴，产品经理也非常高兴，用户也非常高兴，大家都非常高兴。（老外就是哆嗦！）。乔决定把这些AdapterDelegate放在自己的library中，并且开源，真是皆大欢喜。

你可以在github上找到这些AdapterDelegate ，同时也可以在maven central找到。

ps：AdapterDelegate library还提供了一个基类ListDelegationAdapter，它已经把RecyclerView.Adapter 的方法和AdapterDelegatesManager的方法放在了一起，因此你可以进一步减少代码：

public class NewsTipAdapter extends ListDelegationAdapter {

  final int VIEW_TYP_NEWS_TEASER = 0;
  final int VIEW_TYP_FOOD_TIP = 1;

  public NewsTipAdapter(){
    // delegatesManager is a field defined in super class
    delegatesManager.add(new NewsTeaserAdapterDelegate(VIEW_TYP_NEWS_TEASER));
    delegatesManager.add(new PetFoodTipAdapterDelegate(VIEW_TYP_FOOD_TIP));
  }

}

更详细的内容情查看Github 上的library。

声明：乔和MyLittleZoo Inc都不是真实的。请注意本文涉及到的代码片段可能无法编译。它们是java版的伪代码，用于描述真实代码的大致样子。