Android項目實踐——自定義RecyclerViewAdapter模板代碼

版權聲明：本文爲博主原創文章，未經博主允許不得轉載。
系列教程：Android開發之從零開始系列

大家要是看到有錯誤的地方或者有啥好的建議，歡迎留言評論

前言：項目開發中難免會敲很多重複的代碼，尤其是像 Adapter（適配器）這種使用頻率高且格式基本一致的類，這篇博客將以 RecyclerViewAdapter爲例教大家如何自定義自己的模板代碼實現一鍵生成

---

一般RecyclerViewAdapter中會包含初始化方法，ViewHolder，設置列表項點擊或長按的接口等等，下面是RecyclerViewAdapter的一個例子

package com.test.bauztest.BaseRecyclerViewAdapter;//你的包名

//各種類的導入
import android.content.Context;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import java.util.List;
import java.util.Map;

//類的File Header
/**
 * Created by anlia on 2017/10/30.
 */
public class MyRecyclerViewAdapter extends RecyclerView.Adapter<MyRecyclerViewAdapter.ViewHolder> {

    private Context context;
    private List<Map<String,String>> list;//聲明一個傳參類型爲Map<String,String>的list
    private OnItemClickListener mOnItemClickListener;

    class ViewHolder extends RecyclerView.ViewHolder{
        // TODO: 聲明組件

        public ViewHolder(View view) {
            super(view);
            // TODO: 註冊組件,view.findViewById(R.id.xxx)
        }

    }

    public MyRecyclerViewAdapter(Context context,List<Map<String,String>> list) {
        this.context = context;
        this.list = list;
    }

    public interface OnItemClickListener {
        void onItemClick(View view, int position);
        void onItemLongClick(View view , int position);
    }

    public void setOnItemClickListener(OnItemClickListener mOnItemClickListener){
        this.mOnItemClickListener = mOnItemClickListener;
    }

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        // TODO: 爲對應itemViewId賦值,例：R.layout.xxx
        int itemViewId = 0;
        ViewHolder holder = new ViewHolder(LayoutInflater.from(context).inflate(itemViewId, parent, false));
        return holder;
    }

    @Override
    public void onBindViewHolder(final ViewHolder holder, int position) {
        // TODO: 綁定組件的事件


        // 如果設置了回調，則設置點擊事件
        if (mOnItemClickListener != null)
        {
            holder.itemView.setOnClickListener(new View.OnClickListener()
            {
                @Override
                public void onClick(View v)
                {
                    int pos = holder.getLayoutPosition();
                    mOnItemClickListener.onItemClick(holder.itemView, pos);
                }
            });

            holder.itemView.setOnLongClickListener(new View.OnLongClickListener()
            {
                @Override
                public boolean onLongClick(View v)
                {
                    int pos = holder.getLayoutPosition();
                    mOnItemClickListener.onItemLongClick(holder.itemView, pos);
                    return false;
                }
            });
        }
    }

    @Override
    public int getItemCount() {
        return list.size();
    }
}

基本每個Adapter都包含上面這些內容，經常複製粘貼然後再去改類名是非常影響開發效率的一件事，我們可以利用Android Studio中設置模板代碼的功能來減輕我們的負擔，進入模板代碼設置有兩種方法
* 點擊File → Settings → Editor → File and Code Templates，然後點擊新增，編寫我們的模板代碼即可，如圖

• 還有另外一種方法更加快捷，點擊File → New → Edit File Templates

因爲模板代碼要有通用性，所以包名、類名以及List的傳參我們都不能寫死，上面的Adapter例子需要略微修改，注意模板代碼中修改的地方

//自動生成包名
#if (${PACKAGE_NAME} && ${PACKAGE_NAME} != "")package ${PACKAGE_NAME};#end

import android.content.Context;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import java.util.List;

//用默認的File Header即可
#parse("File Header.java")
public class ${NAME}<E> extends RecyclerView.Adapter<${NAME}.ViewHolder> {//包名也需要自動生成，同時注意List傳參爲泛型

    private Context context;
    private List<E> list;//數據集合
    private OnItemClickListener mOnItemClickListener;

    class ViewHolder extends RecyclerView.ViewHolder{
        // TODO: 聲明組件

        public ViewHolder(View view) {
            super(view);
            // TODO: 註冊組件,view.findViewById(R.id.xxx)
        }

    }

    public ${NAME}(Context context,List<E> list) {
        this.context = context;
        this.list = list;
    }

    public interface OnItemClickListener {
        void onItemClick(View view, int position);
        void onItemLongClick(View view , int position);
    }

    public void setOnItemClickListener(OnItemClickListener mOnItemClickListener){
        this.mOnItemClickListener = mOnItemClickListener;
    }

    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        // TODO: 爲對應itemViewId賦值,例：R.layout.xxx
        int itemViewId = 0;
        ViewHolder holder = new ViewHolder(LayoutInflater.from(context).inflate(itemViewId, parent, false));
        return holder;
    }

    @Override
    public void onBindViewHolder(final ViewHolder holder, int position) {
        // TODO: 綁定組件的事件


        // 如果設置了回調，則設置點擊事件
        if (mOnItemClickListener != null)
        {
            holder.itemView.setOnClickListener(new View.OnClickListener()
            {
                @Override
                public void onClick(View v)
                {
                    int pos = holder.getLayoutPosition();
                    mOnItemClickListener.onItemClick(holder.itemView, pos);
                }
            });

            holder.itemView.setOnLongClickListener(new View.OnLongClickListener()
            {
                @Override
                public boolean onLongClick(View v)
                {
                    int pos = holder.getLayoutPosition();
                    mOnItemClickListener.onItemLongClick(holder.itemView, pos);
                    return false;
                }
            });
        }
    }

    @Override
    public int getItemCount() {
        return list.size();
    }
}

模板代碼設置好後，我們只需要簡單幾步即可自動生成RecyclerViewAdapter代碼

至此本篇教程到此結束，如果大家看了感覺還不錯麻煩點個贊，你們的支持是我最大的動力~

---