让我来告诉你一个关于乔某人的故事,一个在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大致是这样实现的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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来重用之前的代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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显示在一起,乔决定创建一个名叫AdvertismentAdapter的基类adapter。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
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和PetFoodTipAdapterDelegate:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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());
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
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中使用:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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。就如你看到的,上面的代码片段有许多散乱的代码。乔发现了一个插件式的解决办法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
/**
* @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);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
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中的代码大致如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
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找到。

英文原文:JOE’S GREAT ADAPTER HELL ESCAPE

本文转载自:http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0810/3282.html