前言

MultiType 這個專案，至今 v3.1.0 穩定多時，考慮得非常多，但也做得非常剋制。原則一直是 直觀、靈活、可靠、簡單純粹（其中直觀和靈活是非常看重的）。

在開發我的 TimeMachine 時，我有一個複雜的聊天頁面，於是我設計了我的型別池系統，它是完全解耦的，我能夠輕鬆將它抽離出來分享，並給它取名為 MultiType.

從前，比如我們寫一個類似微博列表頁面，這樣的列表是十分複雜的：有純文字的、帶轉發原文的、帶圖片的、帶視訊的、帶文章的等等，甚至穿插一條可以橫向滑動的好友推薦條目。不同的 item 型別眾多，而且隨著業務發展，還會更多。如果我們使用傳統的開發方式，經常要做一些繁瑣的工作，程式碼可能都堆積在一個 Adapter 中：我們需要覆寫 RecyclerView.Adapter 的 getItemViewType 方法，羅列一些 type 整型常量，並且 ViewHolder 轉型、繫結資料也比較麻煩。一旦產品需求有變，或者產品設計說需要增加一種新的 item 型別，我們需要去程式碼堆裡找到原來的邏輯去修改，或找到正確的位置去增加程式碼。這些過程都比較繁瑣，侵入較強，需要小心翼翼，以免改錯影響到其他地方。

現在好了，我們有了 MultiType，簡單來說，MultiType 就是一個多型別列表檢視的中間分發框架，它能幫助你快速並且清晰地開發一些複雜的列表頁面，資料驅動檢視。 它本是為聊天頁面開發的，聊天頁面的訊息型別也是有大量不同種類，且新增頻繁，而 MultiType 能夠輕鬆勝任。

MultiType 以靈活直觀為第一宗旨進行設計，它內建了 型別 - View 的複用池系統，支援 RecyclerView，隨時可擴充新的型別進入列表當中，使用簡單，令程式碼清晰、模組化、靈活可變。

因此，我寫了這篇文章，目的有幾個：一是以作者的角度對 MultiType 進行入門和進階詳解。二是傳遞我開發過程中的思想、設計理念，這些偏細膩的內容，即使不使用 MultiType，想必也能帶來很多啟發。最後就是把自我覺得不錯的東西分享給大家，試想如果你製造的東西很多人在用，即使沒有帶來任何收益，也是一件很自豪的事情。

目錄

• MultiType 的特性
• 總覽
• MultiType 基礎用法
• 設計思想
• 高階用法
  • 使用 MultiTypeTemplates 外掛自動生成程式碼
  • 一個型別對應多個 ItemViewBinder
  • 使用 全域性型別池
  • 與 ItemViewBinder 通訊
  • 使用斷言，比傳統 Adapter 更加易於除錯
  • 支援 Google AutoValue
  • MultiType 與下拉重新整理、載入更多、HeaderView、FooterView、Diff
  • 實現 RecyclerView 巢狀橫向 RecyclerView
  • 實現線性佈局和網格佈局混排列表
  • 資料扁平化處理
• 更多示例
  • 仿造微博的資料結構和二級 ViewBinder
  • drakeet/about-page
  • 線性和網格佈局混排
  • drakeet/TimeMachine
  • 類似 Bilibili iOS 端首頁
• Q & A
  • Q: 覺得 MultiType 不夠精簡，應該怎麼做？
  • Q: 在 ItemViewBinder 中如何拿到 Context 物件？
  • Q: 如何在 ItemViewBinder 中獲取到 item position？
• 感謝
• 引用文獻

MultiType 的特性

• 輕盈，整個類庫只有 14 個類檔案，aar 或 jar 包大小隻有 13 KB
• 周到，支援 data type <--> item view binder 之間 一對一 和 一對多 的關係繫結
• 靈活，幾乎所有的部件(類)都可被替換、可繼承定製，面向介面 / 抽象程式設計
• 純粹，只負責本分工作，專注多型別的列表檢視 型別分發，絕不會去影響 views 的內容或行為
• 高效，沒有效能損失，記憶體友好，最大限度發揮 RecyclerView 的複用性
• 可讀，程式碼清晰乾淨、設計精巧，極力避免複雜化，可讀性很好，為擴充和自行解決問題提供了基礎

總覽

MultiType 能輕鬆實現如下頁面，它們將在示例篇章具體提供:

MultiType 的原始碼關係：

MultiType 基礎用法

可能有的新手看到以上特性介紹說什麼 "一對多"、抽象程式設計等等，都不太懂，我想說完全不要緊，不懂可以回過頭來再看，我們先從基礎用法入手，其實 MultiType 使用起來特別簡單。使用 MultiType 一般情況下只要 maven 引入 + 三個小步驟。之後還會介紹使用外掛生成程式碼方式，步驟將更加簡化：

引入

在你的 build.gradle:

dependencies {
    compile 'me.drakeet.multitype:multitype:3.1.0'
}複製程式碼

注：MultiType 內部引用了 recyclerview-v7:25.3.1，如果你不想使用這個版本，可以使用 exclude 將它排除掉，再自行引入你選擇的版本。示例如下：

dependencies {
    compile('me.drakeet.multitype:multitype:3.1.0', {
       exclude group: 'com.android.support'
    })
    compile 'com.android.support:recyclerview-v7:你選擇的版本'
}複製程式碼

Note: MultiType does not support RecyclerView below version 23.0.0.

使用

Step 1. 建立一個 class，它將是你的資料型別或 Java bean / model. 對這個類的內容沒有任何限制。示例如下：

public class Category {

    @NonNull public final String text;

    public Category(@NonNull String text) {
        this.text = text;
    }
}複製程式碼

Step 2. 建立一個 class 繼承 ItemViewBinder.

ItemViewBinder 是個抽象類，其中 onCreateViewHolder 方法用於生產你的 item view holder, onBindViewHolder 用於繫結資料到 Views. 一般一個 ItemViewBinder 類在記憶體中只會有一個例項物件，MultiType 內部將複用這個 binder 物件來生產所有相關的 item views 和繫結資料。示例：

public class CategoryViewBinder extends ItemViewBinder<Category, CategoryViewBinder.ViewHolder> {

    @NonNull @Override
    protected ViewHolder onCreateViewHolder(@NonNull LayoutInflater inflater, @NonNull ViewGroup parent) {
        View root = inflater.inflate(R.layout.item_category, parent, false);
        return new ViewHolder(root);
    }

    @Override
    protected void onBindViewHolder(@NonNull ViewHolder holder, @NonNull Category category) {
        holder.category.setText(category.text);
    }

    static class ViewHolder extends RecyclerView.ViewHolder {

        @NonNull private final TextView category;

        ViewHolder(@NonNull View itemView) {
            super(itemView);
            this.category = (TextView) itemView.findViewById(R.id.category);
        }
    }
}複製程式碼

Step 3. 在 Activity 中加入 RecyclerView 和 List 並註冊你的型別，示例：

public class MainActivity extends AppCompatActivity {

    private MultiTypeAdapter adapter;

    /* Items 等同於 ArrayList<Object> */
    private Items items;

    @Override 
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.list);
        /* 注意：我們已經在 XML 佈局中通過 app:layoutManager="LinearLayoutManager"
         * 給這個 RecyclerView 指定了 LayoutManager，因此此處無需再設定 */

        adapter = new MultiTypeAdapter();

        /* 註冊型別和 View 的對應關係 */
        adapter.register(Category.class, new CategoryViewBinder());
        adapter.register(Song.class, new SongViewBinder());
        recyclerView.setAdapter(adapter);

        /* 模擬載入資料，也可以稍後再載入，然後使用
         * adapter.notifyDataSetChanged() 重新整理列表 */
        items = new Items();
        for (int i = 0; i < 20; i++) {
            items.add(new Category("Songs"));
            items.add(new Song("drakeet", R.drawable.avatar_dakeet));
            items.add(new Song("許岑", R.drawable.avatar_cen));
        }
        adapter.setItems(items);
        adapter.notifyDataSetChanged();
    }
}複製程式碼

大功告成！這就是 MultiType 的基礎用法了。其中 onCreateViewHolder 和 onBindViewHolder 方法名沿襲了使用 RecyclerView 的習慣，令人一目瞭然，減少了新人的學習成本。

設計思想

MultiType 設計伊始，我給它定了幾個原則：

• 要簡單，便於他人閱讀程式碼

  因此我極力避免將它複雜化，避免加入許多不相干的內容。我想寫人人可讀的程式碼，使用簡單精巧的方式，去實現複雜的需求。過多不相干、沒必要的程式碼，將會使專案變得令人暈頭轉向，難以閱讀，遇到需要定製、解決問題的時候，無從下手。

• 要靈活，便於擴充和適應各種需求

  很多人會得意地告訴我，他們把 MultiType 原始碼精簡成三四個類，甚至一個類，以為程式碼越少就是越好，這我不能贊同。MultiType 考慮得更遠，這是一個提供給大眾使用的類庫，過度的精簡只會使得大幅失去靈活性。它或許不是使用起來最簡單的，但很可能是使用起來最靈活的，均衡性最好的。 在我看來，"直觀"、"靈活"優先順序大於"簡單"。因此，MultiType 以介面或抽象進行連線，這意味著它的角色、元件都可以被替換，或者被擴充和繼承。如果你覺得它使用起來還不夠簡單，完全可以通過繼承封裝出更具體符合你使用需求的方法。它已經暴露了足夠豐富、周到的介面以供擴充，我們不應該直接去修改原始碼，這會導致一旦後續發現你的精簡版滿足不了你的需求時，已經沒有回頭路了。

• 要直觀，使用起來能令專案程式碼更清晰可讀，一目瞭然

  MultiType 提供的 ItemViewBinder 沿襲了 RecyclerView Adapter 的介面命名，使用起來更加舒適，符合習慣。另外，MultiType 很多地方放棄使用反射而是讓使用者顯式指明一些關係，如：MultiTypeAdapter#register 方法，需要傳遞一個資料模型 class 和 ItemViewBinder 物件，雖然有很多方法可以把它精簡成單一引數方法，但我們認為顯式宣告資料模型類與對應關係，更加直觀。

高階用法

介紹了基礎用法和設計思想後，我們可以來介紹一下 MultiType 的高階用法。這是一些典型需求和案例，它們是基礎用法的延伸，也是設計思想的體現。也許一開始並不會使用到，但如若瞭解，能夠拓寬使用 MultiType 的思路，也能過了解到我們考慮問題的角度。

使用 MultiTypeTemplates 外掛自動生成程式碼

在基礎用法中，我們了通過 3 個步驟完成 MultiType 的初次接入使用，實際上這個過程可以更加簡化，MultiType 提供了 Android Studio 外掛來自動生成程式碼：

MultiTypeTemplates，原始碼也是開源的，github.com/drakeet/Mul…。這個外掛不僅提供了一鍵生成 item 類檔案和 ItemViewBinder，而且是一個很好的利用程式碼模版自動生成程式碼的示例。其中使用到了官方提供的程式碼模版 API，也用到了我自己發明的更靈活修改模版內容的方法，有興趣做這方面外掛的可以看看。

話說回來，安裝和使用 MultiTypeTemplates 非常簡單：

Step 1. 開啟 Android Studio 的設定 -> Plugin -> Browse repositories，搜尋 MultiTypeTemplates 即可獲得下載安裝：

Step 2. 安裝完成後，重啟 Android Studio. 右鍵點選你的 package，選擇 New -> MultiType Item，然後輸入你的 item 名字，它就會自動生成 item 模型類 和 ItemViewBinder 檔案和程式碼。

比如你輸入的是 "Category"，它就會自動生成 Category.java 和 CategoryViewBinder.java.

特別方便，相信你會很喜歡它。未來這個外掛也將會支援自動生成佈局檔案，這是目前欠缺的，但不要緊，其實 AS 在這方面已經很方便了，對佈局 R.layout.item_category 使用 alt + enter 快捷鍵即可自動生成佈局檔案。

一個型別對應多個 ItemViewBinder

MultiType 支援一個型別對應多個 ItemViewBinder，首創了具有良好 API 且高效能的一對多 Link 模型。使用方式也很簡單直觀，如下：

adapter.register(Data.class).to(
    new DataType1ViewBinder(),
    new DataType2ViewBinder()
).withClassLinker(new ClassLinker<Data>() {
    @NonNull @Override
    public Class<? extends ItemViewBinder<Data, ?>> index(@NonNull Data data) {
        if (data.type == Data.TYPE_2) {
            return DataType2ViewBinder.class;
        } else {
            return DataType1ViewBinder.class;
        }
    }
});複製程式碼

或者：

adapter.register(Data.class).to(
    new DataType1ViewBinder(),
    new DataType2ViewBinder()
).withLinker(new Linker<Data>() {
    @Override
    public int index(@NonNull Data data) {
        return data.type == Data.TYPE_2 ? 1 : 0;
    }
});複製程式碼

如果你使用 Lambda 表示式，以上程式碼可以更簡潔：

解釋：

如上示例程式碼，對於一對多，我們需要使用 MultiType#register(class) 方法，它會返回一個 OneToManyFlow 讓你緊接著繫結多個 ItemViewBinder 例項，最後再呼叫 OneToManyEndpoint#withLinker 或 OneToManyEndpoint#withClassLinker 操作符方法類設定 linker. 所謂 linker，是負責動態連線這個 "一" 對應 "多" 中哪一個 binder 的角色。

這個方案具有很好的效能表現，而且可謂十分直觀。另外，我使用了 @CheckResult 註解來讓編譯器督促開發者一定要完整呼叫方法鏈才不至於出錯。

更詳細的"一對多"示例可以參考我的 sample 原始碼：github.com/drakeet/Mul…

使用 全域性型別池

MultiType 在 3.0 版本之前一直是支援全域性型別池的，你可以往一個全域性型別池中 register 型別和 view binder，然後讓你的各個 MultiTypeAdapter 都能使用它。

但在 MultiType 3.0 之後，我們廢棄並刪除了內建的全域性型別池。原因在於全域性型別池容易對全域性產生不可見影響，比如你註冊了一堆全域性型別關係並在多處引用它，某一天你的夥伴不小心修改了全域性型別池的某個內容，將導致所有使用的地方皆受到變化，是我們不希望發生的。一個好的模組，應該是高內聚、自包含的，如果過多下放權力到外圍，很容易遭受破壞或影響。

另外，全域性型別池一般都是 static 形式的，如果我們給這個 static 容器傳遞了 Activity 或 Context 物件，而沒有在退出時釋放，就容易造出記憶體洩漏，這對新手來說很容易觸犯。

因此我們刪除了內建的全域性型別池，當你建立一個 MultiTypeAdapter 物件時，預設情況下，它內部會自動建立一個區域性型別池以供你接下來註冊型別。當然了，如果你實在需要它，完全可以自己建立一個 static 的 MultiTypePool，然後通過 MultiTypeAdapter#registerAll(pool) 將這個型別池傳入，以此達到多個地方共同使用。

與 ItemViewBinder 通訊

ItemViewBinder 物件可以接受外部型別、回撥函式，只要在使用之前，傳遞進去即可，例如：

OnClickListener listener = new OnClickListener() {
    @Override
    public void onClick(View v) {
        // ...
    }
}
adapter.register(Post.class, new PostViewBinder(xxx, listener));複製程式碼

但話說回來，對於點選事件，能不依賴 binder 外部內容的話，最好就在 binder 內部完成。binder 內部能夠拿到 Views 和 資料，大部分情況下，完全有能力不依賴外部 獨立完成邏輯。這樣能使程式碼更加模組化，實現解耦和內聚。例如下面便是一個完全自包含的例子：

public class SquareViewBinder extends ItemViewBinder<Square, SquareViewBinder.ViewHolder> {

    @NonNull @Override
    protected ViewHolder onCreateViewHolder(@NonNull LayoutInflater inflater, @NonNull ViewGroup parent) {
        View root = inflater.inflate(R.layout.item_square, parent, false);
        return new ViewHolder(root);
    }

    @Override
    protected void onBindViewHolder(@NonNull ViewHolder holder, @NonNull Square square) {
        holder.square = square;
        holder.squareView.setText(valueOf(square.number));
        holder.squareView.setSelected(square.isSelected);
    }

    public class ViewHolder extends RecyclerView.ViewHolder {

        private TextView squareView;
        private Square square;

        ViewHolder(final View itemView) {
            super(itemView);
            squareView = (TextView) itemView.findViewById(R.id.square);
            itemView.setOnClickListener(new View.OnClickListener() {
                @Override 
                public void onClick(View v) {
                    itemView.setSelected(square.isSelected = !square.isSelected);
                }
            });
        }
    }
}複製程式碼

使用斷言，比傳統 Adapter 更加易於除錯

眾所周知，如果一個傳統的 RecyclerView Adapter 內部有異常導致崩潰，它的異常棧是不會指向到你的 Activity，這給我們開發除錯過程中帶來了麻煩。如果我們的 Adapter 是複用的，就不知道是哪一個頁面崩潰。而對於 MultiTypeAdapter，我們顯然要用於多個地方，而且可能出現開發者忘記註冊型別等等問題。為了便於除錯，開發期快速失敗，MultiType 提供了很方便的斷言 API: MultiTypeAsserts，使用方式如下：

import static me.drakeet.multitype.MultiTypeAsserts.assertAllRegistered;
import static me.drakeet.multitype.MultiTypeAsserts.assertHasTheSameAdapter;

public class SimpleActivity extends MenuBaseActivity {

    private Items items;
    private MultiTypeAdapter adapter;

    @Override 
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.list);

        items = new Items();
        adapter = new MultiTypeAdapter(items);
        adapter.register(TextItem.class, new TextItemViewBinder());

        for (int i = 0; i < 20; i++) {
            items.add(new TextItem(valueOf(i)));
        }

        /* 斷言所有使用的型別都已註冊 */
        assertAllRegistered(adapter, items);
        recyclerView.setAdapter(adapter);
        /* 斷言 recyclerView 使用的是正確的 adapter */
        assertHasTheSameAdapter(recyclerView, adapter);
    }
}複製程式碼

assertAllRegistered 和 assertHasTheSameAdapter 都是可選擇性使用，assertAllRegistered 需要在載入或更新資料之後， assertHasTheSameAdapter 必須在 recyclerView.setAdapter(adapter) 之後。

這樣做以後，MultiTypeAdapter 相關的異常都會報到你的 Activity，並且會詳細註明出錯的原因，而如果符合斷言，斷言程式碼不會有任何副作用或影響你的程式碼邏輯，這時你可以把它當作廢話。關於這個類的原始碼是很簡單的，有興趣可以直接看看原始碼：drakeet/multitype/MultiTypeAsserts.java

支援 Google AutoValue

AutoValue 是 Google 提供的一個在 Java 實體類中自動生成程式碼的類庫，使你更專注於處理專案的其他邏輯，它可使程式碼更少，更乾淨，以及更少的 bug.

當我們使用傳統方式建立一個 Java 模型類的時候，經常需要寫一堆 toString()、hashCode()、getter、setter 等等方法，而且對於 Android 開發，大多情況下還需要實現 Parcelable 介面。這樣的結果是，我本來想要一個只有幾個屬性的小模型類，但出於各種原因，這個模型類方法數變得十分繁複，閱讀起來很不清爽，並且難免會寫錯內容。AutoValue 的出現解決了這個問題，我們只需定義一些抽象類交給 AutoValue，AutoValue 會自動生成該抽象類的具體實現子類，並攜帶各種樣板程式碼。

更詳細的介紹內容和使用教程，我會在文章末尾會給出 AutoValue 的相關連結，不熟悉 AutoValue 可以藉此機會看一下，在這裡就不做過多介紹了。新手暫時看不懂也不必糾結，瞭解之後都是十分容易的。

MultiType 支援了 Google AutoValue，支援自動對映某個已經註冊的型別的子類到同一 ItemViewBinder，規則是：如果子類有註冊，就用註冊的對映關係；如果子類沒註冊，則該子類物件使用註冊過的父類對映關係。

FlatTypeAdapter(已廢棄)

MultiType 3.0 之前提供了一個 FlatTypeAdapter 類，3.0 之後，這個類已經被刪除了，你可以完全不必關心它。如果你使用過它，現在它已經被一對多方案替代了，請轉成使用一對多功能實現。

MultiType 與下拉重新整理、載入更多、HeaderView、FooterView、Diff

MultiType 設計從始至終，都極力避免往復雜化方向發展，一開始我的設計宗旨就是它應該是一個非常純粹的、專一的專案，而非各種亂七八糟的功能都要囊括進來的多合一大型庫，因此它很剋制，期間有許多人給我發過一些無關特性的 Pull Request，表示感謝，但全被拒絕了。

對於很多人關心的 下拉重新整理、載入更多、HeaderView、FooterView、Diff 這些功能特性，其實都不應該是 MultiType 的範疇，MultiType 的分內之事是做型別、事件與 View 的分發、連線工作，其餘無關的需求，都是可以在 MultiType 外部完成，或者通過繼承 進行自行封裝和擴充，而作為一個基礎、公共類庫，我想它是不應該包含這些內容。

但很多新手可能並不習慣程式碼分工、模組化，因此在此我有必要對這幾個點簡單示範下如何在 MultiType 之外去實現：

• 下拉重新整理：

  對於下拉重新整理，Android 官方提供了 support.v4 SwipeRefreshLayout，在 Activity 層面，可以拿到 SwipeRefreshLayout 呼叫 setOnRefreshListener 設定監聽器即可.

  或者參考我的 rebase-android 專案編寫的 SwipeRefreshDelegate.java.

• 載入更多：

  RecyclerView 提供了 addOnScrollListener 滾動位置變化監聽，要實現載入更多，只要監聽並檢測列表是否滾動到底部即可，有多種方式，鑑於 LayoutManager 本應該只做佈局相關的事務，因此我們推薦直接在 OnScrollListener 層面進行判斷。提供一個簡單版 OnScrollListener 繼承類：

  public abstract class OnLoadMoreListener extends RecyclerView.OnScrollListener {
  
      private LinearLayoutManager layoutManager;
      private int itemCount, lastPosition, lastItemCount;
  
      public abstract void onLoadMore();
  
      @Override
      public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
          if (recyclerView.getLayoutManager() instanceof LinearLayoutManager) {
              layoutManager = (LinearLayoutManager) recyclerView.getLayoutManager();
  
              itemCount = layoutManager.getItemCount();
              lastPosition = layoutManager.findLastCompletelyVisibleItemPosition();
          } else {
              Log.e("OnLoadMoreListener", "The OnLoadMoreListener only support LinearLayoutManager");
              return;
          }
  
          if (lastItemCount != itemCount && lastPosition == itemCount - 1) {
              lastItemCount = itemCount;
              this.onLoadMore();
          }
      }
  }複製程式碼

  或者參考我的 rebase-android 專案編寫的 LoadMoreDelegate.java.

• 獲取資料後做 Diff 更新：

  MultiType 支援 onBindViewHolder with payloads，詳情見 ItemViewBinder 類文件。對於 Diff，可以在 Activity 中進行 Diff，或者繼承 MultiTypeAdapter 提供接收資料方法，在方法中進行 Diff. MultiType 不提供內建 Diff 方案，不然需要依賴 v4 包，並且這也不應該屬於它的範疇。

  示例程式碼：github.com/drakeet/Mul…

• HeaderView、FooterView

  MultiType 其實本身就支援 HeaderView、FooterView，只要建立一個 Header.class - HeaderViewBinder 和 Footer.class - FooterViewBinder 即可，然後把 new Header() 新增到 items 第一個位置，把 new Footer() 新增到 items 最後一個位置。需要注意的是，如果使用了 Footer View，在底部插入資料的時候，需要新增到 最後位置 - 1，即倒二個位置，或者把 Footer remove 掉，再新增資料，最後再插入一個新的 Footer.

實現 RecyclerView 巢狀橫向 RecyclerView

MultiType 天生就適合實現類似 Google Play 或 iOS App Store 那樣複雜的首頁列表，這種頁面通常會在垂直列表中巢狀橫向列表，其實橫向列表我們完全可以把它視為一種 Item 型別，這個 item 持有一個列表資料和當前橫向列表滑動到的位置，類似這樣：

public class PostList {

    public final List<Post> posts;
    public int currentPosition;

    public PostList(@NonNull List<Post> posts) { this.posts = posts; }
}複製程式碼

對應的 HorizontalItemViewBinder 類似這樣：

public class HorizontalItemViewBinder extends ItemViewBinder<PostList, HorizontalItemViewBinder.ViewHolder> {

    @NonNull @Override
    protected ViewHolder onCreateViewHolder(@NonNull LayoutInflater inflater, @NonNull ViewGroup parent) {
        /* item_horizontal_list 就是一個只有 RecyclerView 的佈局 */
        View view = inflater.inflate(R.layout.item_horizontal_list, parent, false);
        return new ViewHolder(view);
    }

    @Override
    protected void onBindViewHolder(@NonNull ViewHolder holder, @NonNull PostList postList) {
        holder.setPosts(postList.posts);
    }

    static class ViewHolder extends RecyclerView.ViewHolder {

        private RecyclerView recyclerView;
        private PostsAdapter adapter;

        private ViewHolder(@NonNull View itemView) {
            super(itemView);
            recyclerView = (RecyclerView) itemView.findViewById(R.id.post_list);
            LinearLayoutManager layoutManager = new LinearLayoutManager(itemView.getContext());
            layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
            recyclerView.setLayoutManager(layoutManager);
            /* adapter 只負責灌輸、適配資料，佈局交給 LayoutManager，可複用 */
            adapter = new PostsAdapter();    // 或者直接使用 MultiTypeAdapter 更加方便
            recyclerView.setAdapter(adapter);
            /* 在此設定橫向滑動監聽器，用於記錄和恢復當前滑動到的位置，略 */
            ...
        }

        private void setPosts(List<Post> posts) {
            adapter.setPosts(posts);
            adapter.notifyDataSetChanged();
        }
    }
}複製程式碼

實現線性佈局和網格佈局混排列表

這個課題其實也不屬於 MultiType 的範疇，MultiType 的職責是做資料型別分發，而不是佈局，但鑑於很多複雜頁面都會需要線性佈局和網格佈局混排，我就簡單講一講，關鍵在於 RecyclerView 的 LayoutManager. 雖然是線性和網格混合，但實現起來其實只要一個網格佈局 GridLayoutManager，如果你檢視 GridLayoutManager 的官方原始碼，你會發現它其實繼承自 LinearLayoutManager. 以下是示例和解釋：

public class MultiGridActivity extends MenuBaseActivity {

    private final static int SPAN_COUNT = 5;
    private MultiTypeAdapter adapter;
    private Items items;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_multi_grid);
        items = new Items();
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.list);

        final GridLayoutManager layoutManager = new GridLayoutManager(this, SPAN_COUNT);

        /* 關鍵內容：通過 setSpanSizeLookup 來告訴佈局，你的 item 佔幾個橫向單位，
         * 如果你橫向有 5 個單位，而你返回當前 item 佔用 5 個單位，那麼它就會看起來單獨佔用一行 */
        layoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
            @Override
            public int getSpanSize(int position) {
                return (items.get(position) instanceof Category) ? SPAN_COUNT : 1;
            }
        });
        recyclerView.setLayoutManager(layoutManager);

        adapter = new MultiTypeAdapter(items);
        adapter.applyGlobalMultiTypePool();
        adapter.register(Square.class, new SquareViewBinder());

        assertAllRegistered(adapter, items);
        recyclerView.setAdapter(adapter);
        loadData();
    }

    private void loadData() {
        // ...
    }
}複製程式碼

資料扁平化處理

在一個垂直 RecyclerView 中，item 們都是同級的，沒有任何巢狀關係，但我們的資料結構往往存在巢狀關係，比如 Post 內部包含了 Comments 資料，或換句話說 Post 巢狀了 Comment，就像微信朋友圈一樣，"動態" 伴隨著 "評論"。那麼如何把 非扁平化 的資料排布在 扁平 的列表中呢？必然需要一個資料扁平化處理的過程，就像 ListView 的資料需要一個 Adapter 來適配，Adapter 就像一個油漏斗，把油引入瓶子中。我們在面對巢狀資料結構的時候，可以採用如下的扁平化處理，關於扁平化這個詞，不必太糾結，簡單說，就是把巢狀資料都拉出來，攤平，讓 Comment 和 Post 同級，最後把它們都 add 進同一個 Items 容器，交給 MultiTypeAdapter. 示例：

假設：你的 Post 是這樣的：

public class Post {

    public String content;
    public List<Comment> comments; 
}複製程式碼

假設：你的 Comment 是這樣的：

public class Comment {

    public String content;
}複製程式碼

假設：你服務端返回的 JSON 資料是這樣的：

[
    {
        "content":"I have released the MultiType v2.2.2", 
        "comments":[
            {"content":"great"},
            {"content":"I love your post!"}
        ]
    }
]複製程式碼

那麼你的 JSON 轉成 Java Bean 之後，你拿到手應該是個 List<Post> posts 物件，現在我們寫一個扁平化處理的方法：

private List<Object> flattenData(List<Post> posts) {
    final List<Object> items = new ArrayList<>();
    for (Post post : posts) {
        /* 將 post 加進 items，Binder 內部拿到它的時候，
         * 我們無視它的 comments 內容即可 */
        items.add(post);
        /* 緊接著將 comments 拿出來插入進 items，
         * 評論就能正好處於該條 post 下面 */
        items.addAll(post.comments);
    }
    return items;
}複製程式碼

最後我們所有的 posts 在加入全域性 MultiType Items 之前，都需要經過扁平化處理：

items.addAll(flattenData(posts));
adapter.notifyDataSetChanged();複製程式碼

整個過程其實並不困難，相信大家都已經理解了。

更多示例

MultiType 的開源專案提供了許多的 samples (示例) 程式，這些示例秉承了一貫的程式碼清晰、乾淨的風格，十分易於閱讀：

• 仿造微博的資料結構和二級 ItemViewBinder

  這是一個類似微博資料結構的示例，資料兩層結構，Item 也是兩層結構：一層框架（包含頭像使用者名稱等），一層 content view(微博內容)，內容巢狀於框架中。微博的每一條微博 item 都包含了這樣兩層巢狀關係，這樣做的好處是，你不必每個 item 都去重複製造一遍外層框架。

  或者換一個比喻，就像聊天訊息，一條聊天訊息也是兩層的，一層頭像、使用者名稱、聊天氣泡框，一層你的文字、圖片等。另外，每一種訊息都有左邊和右邊的樣式，分別對應別人發來的訊息和你發出的訊息。如果左邊算一種，右邊又算一種，就是比較不好的設計了，會導致佈局內容重複、冗餘，修改操作都要做兩遍。最好的方案是讓他們視被為同一種型別，然後在 item 框層次進行左右邊判斷和框架相關資料繫結。

  我提供的這個二級 ItemViewBinder 示例便是這樣的兩層結構。它能夠讓你每次新增加一個型別，只要實現內容即可，框不應該重複實現。

  如果再不明白，或許你可以看看我的這個示例中 微博 Item 框的佈局：

  

  從我這個 frame 佈局可以看出來，它內部有一個 FrameLayout 作為 container 將用於容納不同的微博內容，而這一層框架則是共同的。

  這個例子算高階中的高階，但實際上也是很簡單，展示了 MultiType 優秀的可擴充能力。完整執行結果展示如下：

  

  注：以上我們並沒有提到服務端 JSON 資料轉為我們定義的 Weibo 物件過程，實際上對於完整鏈路，這個過程是需要做資料轉換，我們需要在 WeiboContent 層加一個 type 或 describe 欄位用於描述微博內容型別，然後再將微博內容的 JSON 文字轉為具體微博內容物件交給 Weibo. 這個內容建議直接閱讀這個 sample 的 WeiboContentDeserializer 原始碼，我利用了一種很簡單又巧妙的方式，在 JSON 解析底層便進行抽象資料具體化，使得客戶端和服務端都能夠輕鬆適應這種微博和微博內容巢狀關係。

• drakeet/about-page

  一個 Material Design 的關於頁面，核心基於 MultiType，包含了多種 items，美觀，容易使用。

  

• 線性和網格佈局混排

  使用 MultiType 和 GridLayoutManager 實現網格和線性混合佈局，實現一個選集頁面。

  

• drakeet/TimeMachine

  TimeMachine 使用了 MultiType 來建立一個複雜的聊天頁面，頁面和需求雖然複雜，但使用 MultiType 顯得輕鬆簡單。

  

• 類似 Bilibili iOS 端首頁

  使用 MultiType 實現類似 Bilibili iOS 端首頁複雜的多型別列表檢視，包括巢狀橫向 RecyclerView.

  

Q & A

• Q: 覺得 MultiType 不夠精簡，應該怎麼做？

  A: 在前面 "設計思想" 中我們談到：MultiType 或許不是使用起來最簡單的，但很可能是使用起來最靈活的。其中的緣由是它高度可定製、可擴充，而不是把一些路封死。作為一個基礎類庫，簡單和靈活需要一個均衡點，過度精簡便要以失去靈活性為代價。如果覺得 MultiType 不夠精簡，想將它修改得更加容易使用，我推薦的方式是去繼承 MultiTypeAdapter 或 ItemViewBinder，甚至你可以重新實現一個 TypePool 再設定給 MultiTypeAdapter. 我們不應該直接到底層去修改、破壞它們。總之，利用開放介面或繼承的做法不管對於 MultiType 還是其它開源庫，都應該是定製的首選。

• Q: 在 ItemViewBinder 中如何拿到 Context 物件？

  A: 有人問我說，他在 ItemViewBinder 裡使用 Glide 來載入圖片需要獲取到 Activity Context 物件，要怎麼才能拿到 Context 物件？這是一個特別簡單的問題，但我想既然有人問，應該比較典型，我就詳細解答下：首先，在 Android 開發中，任何 View 物件都能通過 view.getContext() 拿到 Context 物件，如果你需要通過 View 拿到 Activity 物件，並且你使用了 AppCompatActivity，那麼建議你這麼做：

  public class Activities {
  
      public static Activity getActivity(View view) {
          Context context = view.getContext();
          while (context instanceof ContextWrapper) {
              if (context instanceof Activity) {
                  return (Activity) context;
              }
              context = ((ContextWrapper) context).getBaseContext();
          }
          return null;
      }
  }
  
  Glide.with(getActivity(view)) ...複製程式碼

  原因及相關 issue：github.com/drakeet/Mul…

  總而言之，拿到 Context 物件非常簡單，只要你能拿到一個 View 物件，呼叫 view.getContext() 即可。另外，也可以參考 與 binder 通訊 章節，我們可以很方便地給 binder 傳遞任何物件進去，包括 Context 物件。

• Q：如何在 ItemViewBinder 中獲取到 item position？

  A: 從 v2.3.5 版本開始，只需要在你的 ItemViewBinder 子類裡呼叫 getPosition(holder) 方法即可。另外，ItemViewBinder 還提供了 getAdapter() 或許也是很多人想要的，比如呼叫 adapter 進行 notify 重新整理檢視等。

感謝

在 MultiType 開發維護過程中，很多朋友給了我很多反饋，我也非常樂意於與大家交流，有問必答，因為這是一個難得不錯的專案，它比較接近我心中對於一個完美專案的要求：設計精巧，程式碼乾淨漂亮。

我向來是不太在意專案的 star 數目的，但熱衷於把我的好東西分享給更多人使用，因此在我的 GitHub 首頁我不會把我一些高 star 專案擺出來，而是放一些我覺得程式碼相對比較好的專案。這是我的動力，我想寫一份完美的程式碼，就像王垠的 40 行一樣，達到自覺得天衣無縫、猶如天神衣袖般的優雅，嗯，要是哪天我做到了，我就停止開源，哈哈。

話說回來，這個專案，特別感謝大家的幫忙、反饋，感謝一些朋友的 PR、貢獻和推薦，是你們讓我覺得開源是一件除了完善自我之外 還充滿了意義的一件事情 -- 能夠與更多人協同，能夠面向更寬廣的世界，謝謝大家！以下是感謝名單：

70kg、zubinxiong、WanLiLi、程式碼家、CaMnter、android-xiaowei、burgessjp、lixi0912、simidaxu、咕咚、LuckyJayce、BelongsH、tmexcept、TellH、Ray Pan、Zack、Chris

引用文獻

• 《Android 記憶體洩漏案例和解析》drakeet.me/android-lea…
• 《Android 複雜的多型別列表檢視新寫法：MultiType》drakeet.me/multitype
• 《使用 Google AutoValue 自動生成程式碼》tedyin.me/2016/04/11/…
• 我的個人部落格 drakeet.me
• MultiType 原始碼 github.com/drakeet/Mul…