某宅的Android學習筆記（5）——可通用的介面卡

阿新 • • 發佈：2019-01-17

本文內容參考自慕課網。

ListView、GridView 是我們在 Android 中很常用的控制元件，通常來說，對於每一個控制元件都要寫對應的 ViewHolder 和 Adapter。但是當專案中的 ListView 很多時，寫 ViewHolder 就成了一件很枯燥的事。那麼有沒有辦法，寫一個通用的 ViewHolder 與 Adapter，將可複用的程式碼放在裡面，對於具體的控制元件，稍作修改就能適用呢？

傳統的 Adapter 寫法

首先是佈局：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.commonviewholder.MainActivity">

    <ListView
        android:id="@+id/listview"
        android:layout_width="match_parent"
        android:layout_height="match_parent"></ListView>
</RelativeLayout>

主佈局裡簡單地放了一個 ListView。
item 佈局也很簡單，因為是做示例，並沒用太複雜的佈局：

<?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">

    <TextView
        android:id="@+id/item_listview_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:padding="10dp"
        android:text="THIS IS TITLE"
        android:textColor="#444"
        android:textSize="30sp" />

    <TextView
        android:id="@+id/item_listview_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="This is content"
        android:textSize="25sp" />

    <TextView
        android:id="@+id/item_listview_time"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="right"
        android:padding="10dp"
        android:text="2016-9-17"
        android:textColor="#898989"
        android:textSize="16sp" />
</LinearLayout>

接著要新增 Bean 類，來獲取 item 裡的各控制元件：

package com.example.commonviewholder.bean;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class Bean {

    String itemTitle;
    String itemContent;
    String itemTime;

    public Bean(String itemTitle, String itemContent, String itemTime) {
        this.itemTitle = itemTitle;
        this.itemContent = itemContent;
        this.itemTime = itemTime;
    }

    public String getItemTitle() {
        return itemTitle;
    }

    public String getItemContent() {
        return itemContent;
    }

    public String getItemTime() {
        return itemTime;
    }
}

自定義 Adapter，這裡用繼承自 BaseAdapter 為例：

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

import com.example.commonviewholder.R;
import com.example.commonviewholder.bean.Bean;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class Adapter extends BaseAdapter {

    private LayoutInflater mInflater;
    private List<Bean> mDatas;

    public Adapter(Context context, List<Bean> datas) {
        mInflater = LayoutInflater.from(context);
        mDatas = datas;
    }

    @Override
    public int getCount() {
        return mDatas.size();
    }

    @Override
    public Object getItem(int i) {
        return mDatas.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder viewHolder;
        if (view == null) {
            view = mInflater.inflate(R.layout.item_listview, viewGroup, false);
            viewHolder = new ViewHolder();
            viewHolder.mTitle = (TextView) view.findViewById(R.id.item_listview_title);
            viewHolder.mContent = (TextView) view.findViewById(R.id.item_listview_content);
            viewHolder.mTime = (TextView) view.findViewById(R.id.item_listview_time);
            view.setTag(viewHolder);
        } else {
            viewHolder = (ViewHolder) view.getTag();
        }
        Bean bean = mDatas.get(i);
        viewHolder.mTitle.setText(bean.getItemTitle());
        viewHolder.mContent.setText(bean.getItemContent());
        viewHolder.mTime.setText(bean.getItemTime());
        return view;
    }

    private class ViewHolder {
        TextView mTitle;
        TextView mContent;
        TextView mTime;
    }
}

最後在 MainActivity 中定義資料集，獲取並繫結 Adapter：

package com.example.commonviewholder;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ListView;

import com.example.commonviewholder.adapter.Adapter;
import com.example.commonviewholder.bean.Bean;

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

public class MainActivity extends AppCompatActivity {

    private ListView mListView;
    private List<Bean> mDatas;
    private Bean mBean;
    private Adapter mAdapter;

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

        initData();
        initView();
    }

    /**
     * 初始化 View
     */
    private void initView() {
        mListView = (ListView) findViewById(R.id.listview);
        mListView.setAdapter(mAdapter);
    }

    /**
     * 初始化資料
     */
    private void initData() {
        mDatas = new ArrayList<>();
        //假裝自己有很多資料
        mBean = new Bean("TITLE1", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE2", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE3", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE4", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE5", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE6", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE7", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE8", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE9", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        mBean = new Bean("TITLE10", "CONTENT", "2016-9-18");
        mDatas.add(mBean);
        //獲得自定義 Adapter 的例項
        mAdapter = new Adapter(this, mDatas);
    }
}

這樣一個簡單的 ListView 示例就完成了。

通用 ViewHolder 的編寫

既然是通用的 ViewHolder，首先肯定是要將這個類抽出來。

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.util.SparseArray;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class ViewHolder {

    private SparseArray<View> mViews;
    private View mConvertView;
    private int mPosition;

    private ViewHolder(Context context, ViewGroup parent, int layoutId, int position) {
        mViews = new SparseArray<>();
        mConvertView = LayoutInflater.from(context).inflate(layoutId, parent, false);
        mConvertView.setTag(this);
        mPosition = position;
    }

    /**
     * 獲取 ViewHolder 的例項
     * 如果 convertView 存在，直接從 convertView 獲取
     * 否則 new 一個
     *
     * @param context
     * @param convertView
     * @param parent
     * @param layoutId    佈局id
     * @param position
     * @return
     */
    public static ViewHolder get(Context context, View convertView, ViewGroup parent, int layoutId, int position) {
        if (convertView == null) {
            return new ViewHolder(context, parent, layoutId, position);
        } else {
            ViewHolder viewHolder = (ViewHolder) convertView.getTag();
            viewHolder.mPosition = position;//防止 item 誤複用
            return (ViewHolder) convertView.getTag();
        }
    }

    /**
     * 通過 ViewId 獲取控制元件例項
     *
     * @param viewId
     * @param <T>
     * @return
     */
    public <T extends View> T getView(int viewId) {
        View view = mViews.get(viewId);
        if (view == null) {
            view = mConvertView.findViewById(viewId);
            mViews.put(viewId, view);
        }
        return (T) view;
    }

    public View getConvertView() {
        return mConvertView;
    }
}

接著 Adapter 就可以簡化為：

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.TextView;

import com.example.commonviewholder.R;
import com.example.commonviewholder.bean.Bean;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class Adapter extends BaseAdapter {

    private LayoutInflater mInflater;
    private List<Bean> mDatas;
    private Context mContext;

    public Adapter(Context context, List<Bean> datas) {
        mInflater = LayoutInflater.from(context);
        mDatas = datas;
        mContext = context;
    }

    @Override
    public int getCount() {
        return mDatas.size();
    }

    @Override
    public Object getItem(int i) {
        return mDatas.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder viewHolder = ViewHolder.get(mContext, view, viewGroup, R.layout.item_listview, i);
        Bean bean = mDatas.get(i);

        TextView itemTitle = viewHolder.getView(R.id.item_listview_title);
        TextView itemContent = viewHolder.getView(R.id.item_listview_content);
        TextView itemTime = viewHolder.getView(R.id.item_listview_time);

        itemTitle.setText(bean.getItemTitle());
        itemContent.setText(bean.getItemContent());
        itemTime.setText(bean.getItemTime());

        return viewHolder.getConvertView();
    }
}

省略了之前繁瑣的獲取 convertView 與 ViewHolder 的方法，並且如果 ListView 越多，佈局越複雜，這種寫法的簡便性就會越明顯。

通用的 Adapter

既然 ViewHolder 的重複程式碼可以加以封裝，那麼能不能對 Adapter 做同樣的事呢？答案當然是肯定的！新建一個 CommonAdapter:

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public abstract class CommonAdapter<T> extends BaseAdapter {

    protected List<T> mDatas;
    protected Context mContext;
    protected LayoutInflater inflater;

    public CommonAdapter(Context context, List<T> datas){
        mContext = context;
        mDatas = datas;
        inflater = LayoutInflater.from(mContext);
    }

    @Override
    public int getCount() {
        return mDatas.size();
    }

    @Override
    public Object getItem(int i) {
        return mDatas.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    public abstract View getView(int i, View view, ViewGroup viewGroup);
}

這樣我們的 Adapter 就可以繼承自 CommonAdapter，將重複的程式碼全部清除掉：

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;

import com.example.commonviewholder.R;
import com.example.commonviewholder.bean.Bean;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class Adapter extends CommonAdapter<Bean> {

    public Adapter(Context context, List<Bean> datas) {
        super(context, datas);
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder viewHolder = ViewHolder.get(mContext, view, viewGroup, R.layout.item_listview, i);
        Bean bean = mDatas.get(i);

        TextView itemTitle = viewHolder.getView(R.id.item_listview_title);
        TextView itemContent = viewHolder.getView(R.id.item_listview_content);
        TextView itemTime = viewHolder.getView(R.id.item_listview_time);

        itemTitle.setText(bean.getItemTitle());
        itemContent.setText(bean.getItemContent());
        itemTime.setText(bean.getItemTime());

        return viewHolder.getConvertView();
    }
}

上面的程式碼足夠簡單了嗎？不，因為在 getView() 裡我們還是要重複寫幾句程式碼。因此可以對 CommonAdapter 進一步簡化，不用抽象 getView() 方法，而是將重複的程式碼放在 getView() 裡，抽象一個接受必要引數的方法來提供給子類獲取控制元件例項：

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;

import com.example.commonviewholder.R;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public abstract class CommonAdapter<T> extends BaseAdapter {

    protected List<T> mDatas;
    protected Context mContext;
    protected LayoutInflater inflater;
    private int layoutId;

    public CommonAdapter(Context context, List<T> datas, int layoutId) {
        mContext = context;
        mDatas = datas;
        inflater = LayoutInflater.from(mContext);
        this.layoutId = layoutId;
    }

    @Override
    public int getCount() {
        return mDatas.size();
    }

    @Override
    public T getItem(int i) {
        return mDatas.get(i);
    }

    @Override
    public long getItemId(int i) {
        return i;
    }

    @Override
    public View getView(int i, View view, ViewGroup viewGroup) {
        ViewHolder viewHolder = ViewHolder.get(mContext, view, viewGroup, layoutId, i);
        convert(viewHolder, getItem(i));
        return viewHolder.getConvertView();
    }

    public abstract void convert(ViewHolder viewHolder, T t);
}

因為修改了 getView() 裡獲取 ViewHolder 的語句，因此佈局 id 改由構造方法獲取。

package com.example.commonviewholder.adapter;

import android.content.Context;
import android.widget.TextView;

import com.example.commonviewholder.R;
import com.example.commonviewholder.bean.Bean;

import java.util.List;

/**
 * Created by 某宅 on 2016/9/17.
 */
public class Adapter extends CommonAdapter<Bean> {

    public Adapter(Context context, List<Bean> datas) {
        super(context, datas, R.layout.item_listview);
    }

    @Override
    public void convert(ViewHolder viewHolder, Bean bean) {
        TextView itemTitle = viewHolder.getView(R.id.item_listview_title);
        TextView itemContent = viewHolder.getView(R.id.item_listview_content);
        TextView itemTime = viewHolder.getView(R.id.item_listview_time);
        itemTitle.setText(bean.getItemTitle());
        itemContent.setText(bean.getItemContent());
        itemTime.setText(bean.getItemTime());
    }
}

進一步的優化

考慮到我們常用的控制元件有 TextView、ImageView 等等，我們可以提前將這些控制元件的通用方法抽取出來。這裡以 TextView 為例，我們常用的無非是為其設定輸出語句，因此可以在 ViewHolder 類裡提前寫好相應的方法：

/**
     * 子控制元件的通用方法
     *
     * @param viewId
     * @param text
     * @return
     */
    public ViewHolder setText(int viewId, String text) {
        TextView tv = getView(viewId);
        tv.setText(text);
        return this;
    }

這樣 Adapter 裡的方法可以得到進一步的簡化：

@Override
    public void convert(ViewHolder viewHolder, Bean bean) {
        viewHolder.setText(R.id.item_listview_title, bean.getItemTitle())
                .setText(R.id.item_listview_content, bean.getItemContent())
                .setText(R.id.item_listview_time, bean.getItemTime());
    }

某宅的Android學習筆記（5）——可通用的介面卡

傳統的 Adapter 寫法

通用 ViewHolder 的編寫

通用的 Adapter

進一步的優化

某宅的Android學習筆記（5）——可通用的介面卡

STM32學習筆記（5）：通用定時器PWM輸出

某宅的Android學習筆記（二）——圖片三級快取

Swift學習筆記（5）：集合類型

bootstrap 學習筆記（5）---- 圖片和響應式工具

學習筆記（5）---數學運算

QT學習筆記（5）菜單欄、工具欄、窗口、對話框

Hibernate學習筆記（5）---Query接口

SpringBoot學習筆記（5）：處理前端JSON返回的日期的格式

ojective-C學習筆記（5）關於面向對象編程

yii學習筆記（5），視圖操作

Docker學習筆記-（5）容器數據管理，鏈接容器，構建私有庫

STM32學習筆記（5）——通用定時器PWM輸出

Rust語言學習筆記（5）

TCP/IP學習筆記（5）------IP選路

C語言學習筆記（5）—— 語句（1）

C語言學習筆記（5）—— 語句（2）

cesium 學習筆記（5）2018.11.08

linux學習筆記（5）：檔案許可權

RocketMQ學習筆記（5）----RocketMQ監控平臺rocketmq-console-ng的搭建

某宅的Android學習筆記（5）——可通用的介面卡

傳統的 Adapter 寫法

通用 ViewHolder 的編寫

通用的 Adapter

進一步的優化

相關推薦