Android RecyclerView多類型布局卡片解決方案

更新時(shí)間：2019年03月19日 14:49:00 作者：luokanghui

這篇文章主要介紹了Android RecyclerView多類型布局卡片解決方案，小編覺得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧

背景

隨著公司業(yè)務(wù)越來越復(fù)雜，在同一個(gè)列表中需要展示各種類型的數(shù)據(jù)。

總體結(jié)構(gòu)

ItemViewAdapter：每種類型的卡片分別都是不同的ItemViewAdapter
ItemViewAdapterFactory：使用ItemViewAdapterFactory根據(jù)不同數(shù)據(jù)對應(yīng)不同的ItemViewAdapter
MultiRecyclerViewAdapter： MultiRecyclerViewAdapter就是RecylerView.Adapter,并是個(gè)ItemViewAdapterFactory。
具體只要繼承MultiRecyclerViewAdapter即可，實(shí)現(xiàn)ItemViewAdapterFactory中g(shù)etViewType、onCreateItemViewAdapter兩個(gè)方法
ContextMap：整個(gè)Adapter共用一個(gè)ContextMap數(shù)據(jù)上下文，用于外部（例Fragment等）與ItemAdapter交互、ItemAdapter之間交互等一系列數(shù)據(jù)傳遞，可以解決參數(shù)層層傳遞的問題
RecyclerViewHolder：通用RecyclerView.ViewHolder，封裝根據(jù)id獲取view方法getView(viewId)、獲取數(shù)據(jù)上下文方法getContextMap()

使用方法

每種類型卡片Item都實(shí)現(xiàn)ItemViewAdapter

package com.lkh.multiadapter;

import android.support.annotation.LayoutRes;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import java.util.List;

/**
 * 列表單項(xiàng)布局與數(shù)據(jù)綁定
 * Created by luokanghui on 2017/5/24.
 */
public abstract class ItemViewAdapter<E>{

  /**
   * 返回列表單項(xiàng)View，如果View由資源layout加載而來，直接重寫{@link #onGetLayoutId()}即可
   * @param parent 父view，一般為RecyclerView
   * @return 列表單項(xiàng)View
   */
  public View onCreateView(ViewGroup parent){
    return LayoutInflater.from(parent.getContext()).inflate(onGetLayoutId()
        , parent, false);
  }

  /**
   * 當(dāng)RecyclerViewHolder創(chuàng)建成功后調(diào)用，只會調(diào)用一次
   * @param viewHolder 單項(xiàng)view集合
   */
  public void onCreate(RecyclerViewHolder viewHolder){

  }

  /**
   * 返回單項(xiàng)布局的資源id，如果重寫了{(lán)@link #onCreateView(ViewGroup)}，則此方法可能失效
   * @return 單項(xiàng)布局layout id
   */
  @LayoutRes
  protected abstract int onGetLayoutId();

  /**
   * 把數(shù)據(jù)與view進(jìn)行綁定，滑動時(shí)都會調(diào)用
   * @param viewHolder 單項(xiàng)view集合
   * @param data 具體數(shù)據(jù)
   * @param position 在列表中的位置
   */
  public abstract void bindData(RecyclerViewHolder viewHolder, E data, int position);

  /**
   * 局部更新時(shí)調(diào)用
   * @param viewHolder 單項(xiàng)view集合
   * @param data 具體數(shù)據(jù)
   * @param position 在列表中的位置
   * @param payloads 局部更新標(biāo)志，不會為空（isEmpty()==false)
   */
  public void bindData(RecyclerViewHolder viewHolder, E data, int position, List<Object> payloads){

  }
}

卡片1：

package com.lkh.multiadapter.sample;

import android.widget.TextView;

import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.R;
import com.lkh.multiadapter.RecyclerViewHolder;

/**
 * 卡片1實(shí)現(xiàn)
 * Created by luokanghui on 2019/3/18
 */
public class SampleOneItemViewAdapter extends ItemViewAdapter<DataOne> {
  @Override
  protected int onGetLayoutId() {
    //布局layout資源id
    return R.layout.item_one;
  }

  @Override
  public void bindData(RecyclerViewHolder viewHolder, DataOne data, int position) {
    //根據(jù)id獲取view
    TextView tvContent = viewHolder.getView(R.id.tv_content);
    //數(shù)據(jù)綁定
    tvContent.setText(data.getContent());
  }
}

package com.lkh.multiadapter.sample;

/**
 * 卡片1數(shù)據(jù)
 * Created by luokanghui on 2019/3/18
 */
public class DataOne {
  private String content;

  public String getContent() {
    return content;
  }

  public void setContent(String content) {
    this.content = content;
  }
}

item_one.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:background="#eeeeee"
  android:orientation="vertical">

  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="卡片1"
    android:textColor="#000000" />

  <TextView
    android:id="@+id/tv_content"
    android:layout_width="wrap_content"
    android:layout_height="50dp"
    android:gravity="center"
    android:textColor="#000000" />

</LinearLayout>

卡片2

package com.lkh.multiadapter.sample;

import android.widget.TextView;

import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.R;
import com.lkh.multiadapter.RecyclerViewHolder;

/**
 * 卡片2實(shí)現(xiàn)
 * Created by luokanghui on 2019/3/18
 */
public class SampleTwoItemViewAdapter extends ItemViewAdapter<DataTwo> {
  @Override
  protected int onGetLayoutId() {
    //布局layout資源id
    return R.layout.item_two;
  }

  @Override
  public void bindData(RecyclerViewHolder viewHolder, DataTwo data, int position) {
    //根據(jù)id獲取view
    TextView tvNum = viewHolder.getView(R.id.tv_num);
    //數(shù)據(jù)綁定
    tvNum.setText("num="+data.getNum());
  }
}

package com.lkh.multiadapter.sample;

/**
 * 卡片2數(shù)據(jù)
 * Created by luokanghui on 2019/3/18
 */
public class DataTwo {
  private int num;

  public int getNum() {
    return num;
  }

  public void setNum(int num) {
    this.num = num;
  }
}

item_two.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:background="#999999"
  android:orientation="vertical">

  <TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="卡片2"
    android:textColor="#0000ff" />

  <TextView
    android:id="@+id/tv_num"
    android:layout_width="wrap_content"
    android:layout_height="100dp"
    android:gravity="center"
    android:textColor="#0000ff" />

</LinearLayout>

總Adapter，繼承MultiRecyclerViewAdapter

package com.lkh.multiadapter.sample;

import com.lkh.multiadapter.ItemViewAdapter;
import com.lkh.multiadapter.MultiRecyclerViewAdapter;

/**
 * 多布局adapter，根據(jù)不同data及position，使用不同ItemViewAdapter卡片
 * Created by luokanghui on 2019/3/18
 */
public class SampleMultiAdapter extends MultiRecyclerViewAdapter<Object> {
  private static final int TYPE_EMPTY = 0;//空item
  private static final int TYPE_ONE = 1;//卡片1
  private static final int TYPE_TWO = 2;//卡片2

  @Override
  public int getViewType(Object data, int position) {
    if (data instanceof DataOne){//卡片1
      return TYPE_ONE;
    }

    if (data instanceof DataTwo){//卡片2
      return TYPE_TWO;
    }

    return TYPE_EMPTY;//空item
  }

  @Override
  public ItemViewAdapter onCreateItemViewAdapter(int viewType) {
    switch (viewType){
      case TYPE_ONE://卡片1
        return new SampleOneItemViewAdapter();
      case TYPE_TWO://卡片2
        return new SampleTwoItemViewAdapter();
      default://空item
        return new EmptyItemViewAdapter();
    }
  }
}

RecyclerView中使用

package com.lkh.multiadapter;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;

import com.lkh.multiadapter.sample.DataOne;
import com.lkh.multiadapter.sample.DataTwo;
import com.lkh.multiadapter.sample.SampleMultiAdapter;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    recyclerView.setLayoutManager(new LinearLayoutManager(this));

    SampleMultiAdapter adapter = new SampleMultiAdapter();

    //設(shè)置數(shù)據(jù)
    adapter.setData(generateData());

    //設(shè)置adapter
    recyclerView.setAdapter(adapter);

  }

  //造測試數(shù)據(jù)
  private List<Object> generateData(){
    List<Object> list = new ArrayList<>();
    for (int i=0; i<20; i++){
      DataOne dataOne = new DataOne();
      dataOne.setContent("這是卡片1數(shù)據(jù)："+i);
      list.add(dataOne);

      DataTwo dataTwo = new DataTwo();
      dataTwo.setNum(i);
      list.add(dataTwo);
    }
    return list;
  }
}

activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:orientation="vertical">

  <android.support.v7.widget.RecyclerView
    android:id="@+id/recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

</LinearLayout>

運(yùn)行效果如下：

總的來說，實(shí)現(xiàn)一個(gè)多類型布局列表只需要寫多個(gè)不同卡片ItemViewAdapter、繼承MultiRecyclerViewAdapter用來控制不同數(shù)據(jù)使用不同ItemViewAdapter，新增一個(gè)卡片只需要新增一個(gè)ItemViewAdapter，在MultiRecyclerViewAdapter新加一項(xiàng)即可，不會影響其它卡片使用，而且ItemViewAdapter完全獨(dú)立，可以很好的復(fù)用。

核心代碼

package com.lkh.multiadapter;

import android.support.v7.widget.RecyclerView;
import android.view.ViewGroup;

import java.util.List;

/**
 * 多種布局adapter
 * Created by luokanghui on 2017/5/24.
 */

public abstract class MultiRecyclerViewAdapter<E> extends RecyclerView.Adapter<RecyclerViewHolder> implements ItemViewAdapterFactory<E> {
  public static final int NO_TYPE = -1;

  private List<E> dataList;

  protected final MapData mMapData = new MapData();

  public MultiRecyclerViewAdapter setData(List<E> list) {
    this.dataList = list;
    return this;
  }

  @Override
  public RecyclerViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    ItemViewAdapter itemViewModule = onCreateItemViewAdapter(viewType);
    RecyclerViewHolder recyclerViewHolder = new RecyclerViewHolder(itemViewModule.onCreateView(parent), itemViewModule, this, getContextMap());
    itemViewModule.onCreate(recyclerViewHolder);
    return recyclerViewHolder;
  }

  @Override
  public void onBindViewHolder(RecyclerViewHolder holder, int position) {
    if (checkItems(position)) {
      return;
    }
    holder.itemViewAdapter.bindData(holder, dataList.get(position), position);
  }

  @Override
  public void onBindViewHolder(RecyclerViewHolder holder, int position, List<Object> payloads) {
    if (checkItems(position)) {
      return;
    }
    if (payloads.isEmpty()) {
      super.onBindViewHolder(holder, position, payloads);
    } else {
      holder.itemViewAdapter.bindData(holder, dataList.get(position), position, payloads);
    }
  }

  @Override
  public int getItemViewType(int position) {
    if (checkItems(position)) {
      return NO_TYPE;
    }
    return getViewType(dataList.get(position), position);
  }

  @Override
  public int getItemCount() {
    return dataList == null ? 0 : dataList.size();
  }

  /**
   * true表示沒通過
   */
  private boolean checkItems(int position) {
    return dataList == null || position < 0 || position >= dataList.size();
  }

  @Override
  public MapData getContextMap() {
    return mMapData;
  }
}

package com.lkh.multiadapter;
/**
 * 多布局ItemViewAdapter創(chuàng)建者
 * Created by luokanghui on 2017/5/24.
 */
public interface ItemViewAdapterFactory<E> {

  /**
   * 返回ItemViewAdapter的類型
   * 建議根據(jù)data的數(shù)據(jù)類型判斷不同的viewType
   * @param data 具體數(shù)據(jù)
   * @param position 在列表中的位置
   * @return 類型
   */
  int getViewType(E data, int position);

  /**
   * 根據(jù)不同的viewType返回不同的ItemViewAdapter
   * @param viewType 類型
   * @return ItemViewAdapter
   */
  ItemViewAdapter<? extends E> onCreateItemViewAdapter(int viewType);


  /**
   * 上下文數(shù)據(jù)
   * @return
   */
  MapData getContextMap();
}

package com.lkh.multiadapter;

import android.support.v7.widget.RecyclerView;
import android.util.SparseArray;
import android.view.View;


/**
 * ViewHolder基類
 */
public final class RecyclerViewHolder extends RecyclerView.ViewHolder {

  private final SparseArray<View> views;
  ItemViewAdapter itemViewAdapter;
  private final RecyclerView.Adapter adapter;
  private final MapData mMapData ;


  public RecyclerViewHolder(View itemView, ItemViewAdapter itemViewAdapter, RecyclerView.Adapter adapter, MapData mapData) {
    super(itemView);
    this.views = new SparseArray<>();
    this.itemViewAdapter = itemViewAdapter;
    this.adapter = adapter;
    this.mMapData = mapData;
  }

  /**
   * 根據(jù)id獲取view，如果緩存中存在，直接使用緩存中的，避免重復(fù)執(zhí)行findViewById
   */
  @SuppressWarnings("unchecked")
  public <T extends View> T getView(int viewId) {
    View view = views.get(viewId);
    if (view == null) {
      view = itemView.findViewById(viewId);
      views.put(viewId, view);
    }
    return (T) view;
  }

  public RecyclerView.Adapter getAdapter(){
    return adapter;
  }

  /**
   * 獲取數(shù)據(jù)上下文
   */
  public MapData getContextMap(){
    return mMapData;
  }
}

package com.lkh.multiadapter;

import android.support.annotation.LayoutRes;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

import java.util.List;

/**
 * 列表單項(xiàng)布局與數(shù)據(jù)綁定
 * Created by luokanghui on 2017/5/24.
 */

public abstract class ItemViewAdapter<E>{

  /**
   * 返回列表單項(xiàng)View，如果View由資源layout加載而來，直接重寫{@link #onGetLayoutId()}即可
   * @param parent 父view，一般為RecyclerView
   * @return 列表單項(xiàng)View
   */
  public View onCreateView(ViewGroup parent){
    return LayoutInflater.from(parent.getContext()).inflate(onGetLayoutId()
        , parent, false);
  }

  /**
   * 當(dāng)RecyclerViewHolder創(chuàng)建成功后調(diào)用，只會調(diào)用一次
   * @param viewHolder 單項(xiàng)view集合
   */
  public void onCreate(RecyclerViewHolder viewHolder){

  }

  /**
   * 返回單項(xiàng)布局的資源id，如果重寫了{(lán)@link #onCreateView(ViewGroup)}，則此方法可能失效
   * @return 單項(xiàng)布局layout id
   */
  @LayoutRes
  protected abstract int onGetLayoutId();

  /**
   * 把數(shù)據(jù)與view進(jìn)行綁定，滑動時(shí)都會調(diào)用
   * @param viewHolder 單項(xiàng)view集合
   * @param data 具體數(shù)據(jù)
   * @param position 在列表中的位置
   */
  public abstract void bindData(RecyclerViewHolder viewHolder, E data, int position);

  /**
   * 局部更新時(shí)調(diào)用
   * @param viewHolder 單項(xiàng)view集合
   * @param data 具體數(shù)據(jù)
   * @param position 在列表中的位置
   * @param payloads 局部更新標(biāo)志，不會為空（isEmpty()==false)
   */
  public void bindData(RecyclerViewHolder viewHolder, E data, int position, List<Object> payloads){

  }
}

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: