dd

【FastDev4Android框架开发】BaseAdapterHelper详解源码分析,让你摆脱狂写一堆Adapter烦恼(二十五)

jerry Android 2015年11月26日 收藏

().前言:   

         Base-Adater-Helper是对我们传统的BaseAdapterViewHolder的模式的一个抽象封装,主要的功能可以让我们简化的书写AbsListView,例如ListView,GridView的自定义Adapter的代码,上一篇我们已经对该项目的基本使用做了介绍实例,今天我们来对该项目的实现详解源码分析一下,同时我们可以对此框架进行扩展开发。

        FastDev4Android框架项目地址:https://github.com/jiangqqlmj/FastDev4Android

        基本使用方式如下:


   我们看一下它的实例使用方法:


mAdapter = newQuickAdapter<ModuleBean>(this, R.layout.lv_item_base_layout,moduleBeans){
                @Override
                protected voidconvert(BaseAdapterHelper helper, ModuleBean item) {
                    //列表底下显示进度
                   mAdapter.showIndeterminateProgress(true);
                   helper.setText(R.id.text_lv_item_title, item.getModulename())
                           .setText(R.id.text_lv_item_description, item.getDescription())
                           .setImageUrl(R.id.img_lv_item, item.getImgurl());
                }
            };
           lv_base_adapter.setAdapter(mAdapter);


        我们使用的时候只需要创建一个QuickApdater()对象,重写其中convert(),然后在convert中使用helper的各种方法来对控件和数据进行绑定。只要完成以上步骤,我们就完成了繁杂的Adapter的编写。其中的BaseAdapterHelper其实是一个ViewHolder。

().总体分析

         整个项目其实比较简单也就是四个主要的类:

  • BaseAdapterHelper
  • BaseQuickAdapter
  • EnhancedQuickAdapter
  • QuickAdapter

通过阅读整个项目源代码之后发现,当前实现也是基于ViewHolder模式的,等会我

们分析就知道了。其中view类型相关的采用泛型存储,最重要的数据绑定工作,采用抽象函数convert()实现,全部交给用户来实现自定义的绑定。

           从上面的基本使用中发现,我们在使用该base-adapter-helper过程中,只需要创建newQuickAdapter()传入布局,数据,控件和数据模型绑定即可。但是我们查看QuickAdapter类的代码发现:


packagecom.chinaztt.fda.adapter.base;
importandroid.content.Context;
importandroid.view.View;
importandroid.view.ViewGroup;
 
importjava.util.List;
 
import staticcom.chinaztt.fda.adapter.base.BaseAdapterHelper.get;
 
 
/**
 * Abstraction class of a BaseAdapter in whichyou only need
 * to provide the convert()implementation.<br/>
 * Using the provided BaseAdapterHelper, yourcode is minimalist.
 * @param <T> The type of the items inthe list.
 */
public abstractclass QuickAdapter<T> extends BaseQuickAdapter<T,BaseAdapterHelper> {
 
    /**
     * Create a QuickAdapter.
     * @param context     The context.
     * @param layoutResId The layout resourceid of each item.
     */
    public QuickAdapter(Context context, intlayoutResId) {
        super(context, layoutResId);
    }
 
    /**
     * Same asQuickAdapter#QuickAdapter(Context,int) but with
     * some initialization data.
     * @param context     The context.
     * @param layoutResId The layout resourceid of each item.
     * @param data        A new list is created out of this oneto avoid mutable list
     */
    public QuickAdapter(Context context, intlayoutResId, List<T> data) {
        super(context, layoutResId, data);
    }
 
    /**
     * 进行获取类ViewHolder的  BaseAdapterHelper
     * @param position    The position of the item within theadapter's data set of the item whose view we want.
     * @param convertView The old view toreuse, if possible. Note: You should check that this view
     *                    is non-null and of anappropriate type before using. If it is not possible to convert
     *                    this view to display thecorrect data, this method can create a new view.
     *                    Heterogeneous lists canspecify their number of view types, so that this View is
     *                    always of the right type(see {@link #getViewTypeCount()} and
     *                    {@link#getItemViewType(int)}).
     * @param parent      The parent that this view will eventuallybe attached to
     * @return
     */
    protected BaseAdapterHelpergetAdapterHelper(int position, View convertView, ViewGroup parent) {
        return get(context, convertView,parent, layoutResId, position);
    }
 
}


          其实它并没有做什么其他更多的时候,就只有两个构造方法,和一个获取BaseAdapterHelper对象的方法。所以要研究该框架,我们只需要研究它的父类BaseQuickAdapterBaseAdapterHelper类即可。最后简单的看一下EnhancedQuickAdapter类。

          2.1.BaseQuickAdapter:该类继承了BaseAdapter类,同时实现了BaseAdapter中通用的几个抽象方法(也就是我们平时自定义Adapter需要实现的几个方法),完成了Adapter要做的绝大多数操作以及对于Data操作的方法(不过个人赶脚用处不是特别大哈~个人见解)。该类还有两个泛型数据,其中T代表数据,H针对BaseAdapterHelper


packagecom.chinaztt.fda.adapter.base;
importandroid.content.Context;
importandroid.view.Gravity;
importandroid.view.View;
importandroid.view.ViewGroup;
importandroid.widget.BaseAdapter;
importandroid.widget.FrameLayout;
importandroid.widget.ProgressBar;
 
importjava.util.ArrayList;
importjava.util.List;
 
/**
 * Abstraction class of a BaseAdapter in whichyou only need
 * to provide the convert()implementation.<br/>
 * Using the provided BaseAdapterHelper, yourcode is minimalist.
 * @param <T> The type of the items inthe list.
 */
public abstractclass BaseQuickAdapter<T, H extends BaseAdapterHelper> extendsBaseAdapter {
 
    protected static final String TAG =BaseQuickAdapter.class.getSimpleName();
    //上下文引用
    protected final Context context;
    //需要显示的布局id
    protected final int layoutResId;
    //需要显示的数据
    protected final List<T> data;
    //是否显示进度
    protected booleandisplayIndeterminateProgress = false;
    /**
     * Create a QuickAdapter.
     * @param context     The context.
     * @param layoutResId The layout resourceid of each item.
     */
    public BaseQuickAdapter(Context context,int layoutResId) {
        this(context, layoutResId, null);
    }
 
    /**
     * Same asQuickAdapter#QuickAdapter(Context,int) but with
     * some initialization data.
     * @param context     The context.
     * @param layoutResId The layout resourceid of each item.
     * @param data        A new list is created out of this oneto avoid mutable list
     */
    public BaseQuickAdapter(Context context,int layoutResId, List<T> data) {
        this.data = data == null ? newArrayList<T>() : new ArrayList<T>(data);
        this.context = context;
        this.layoutResId = layoutResId;
    }
 
    /**
     * 判断是否需要显示进度,如果显示 数量+1
     * @return
     */
    @Override
    public int getCount() {
        int extra =displayIndeterminateProgress ? 1 : 0;
        return data.size() + extra;
    }
 
    /**
     * 判断索引是否大于等于数据长度,如果等于,最后一个item应该为进度,那么返回的数据对象为null即可
     * @param position
     * @return
     */
    @Override
    public T getItem(int position) {
        if (position >= data.size()) returnnull;
        return data.get(position);
    }
 
    @Override
    public long getItemId(int position) {
        return position;
    }
 
    /**
     * view类型返回2,这边还需要显示进度bar
     * @return
     */
    @Override
    public int getViewTypeCount() {
        return 2;
    }
 
    /**
     * 进行判断索引是不是已经大于等于数据的长度
     * 如果超过或者等于数据的长度 返回1
     * @param position
     * @return
     */
    @Override
    public int getItemViewType(int position) {
        return position >= data.size() ? 1 :0;
    }
 
    @Override
    public View getView(int position, ViewconvertView, ViewGroup parent) {
        if (getItemViewType(position) == 0) {
            //获取适配器helper --相当于获取ViewHolder-BaseAdapterHelper
            final H helper =getAdapterHelper(position, convertView, parent);
            //获取item model 数据
            T item = getItem(position);
            //给子类QuickAdapter来进行实现,不过QuickAdapter也是抽象类,给具体创建的类进行实现
            convert(helper, item);
            helper.setAssociatedObject(item);
            return helper.getView();
        }
        //显示进度
        returncreateIndeterminateProgressView(convertView, parent);
    }
 
    /**
     * 创建进度条 显示在view的结尾
     * @param convertView
     * @param parent
     * @return
     */
    private ViewcreateIndeterminateProgressView(View convertView, ViewGroup parent) {
        if (convertView == null) {
            FrameLayout container = newFrameLayout(context);
           container.setForegroundGravity(Gravity.CENTER);
            ProgressBar progress = newProgressBar(context);
            container.addView(progress);
            convertView = container;
        }
        return convertView;
    }
    @Override
    public boolean isEnabled(int position) {
        return position < data.size();
    }
 
   //====================================================
    //下面的方法基本封装了操作集合相关的
    //主要为新增add,设置set,移除remove以及替换,是否存在判断
   //=====================================================
    public void add(T elem) {
        data.add(elem);
        notifyDataSetChanged();
    }
 
    public void addAll(List<T> elem) {
        data.addAll(elem);
        notifyDataSetChanged();
    }
 
    public void set(T oldElem, T newElem) {
        set(data.indexOf(oldElem), newElem);
    }
 
    public void set(int index, T elem) {
        data.set(index, elem);
        notifyDataSetChanged();
    }
 
    public void remove(T elem) {
        data.remove(elem);
        notifyDataSetChanged();
    }
 
    public void remove(int index) {
        data.remove(index);
        notifyDataSetChanged();
    }
 
    public void replaceAll(List<T> elem){
        data.clear();
        data.addAll(elem);
        notifyDataSetChanged();
    }
 
    public boolean contains(T elem) {
        return data.contains(elem);
    }
 
    /**
     * 清空数组
     */
    /** Clear data list */
    public void clear() {
        data.clear();
        notifyDataSetChanged();
    }
 
    public voidshowIndeterminateProgress(boolean display) {
        if (display ==displayIndeterminateProgress) return;
        displayIndeterminateProgress = display;
        notifyDataSetChanged();
    }
 
    /**
     * 实现该方法,让用户自己绑定控件和数据
     * Implement this method and use the helperto adapt the view to the given item.
     * @param helper A fully initializedhelper.
     * @param item   The item that needs to be displayed.
     */
    protected abstract void convert(H helper, Titem);
 
    /**
     * You can override this method to use acustom BaseAdapterHelper in order to fit your needs
     * @param position    The position of the item within theadapter's data set of the item whose view we want.
     * @param convertView The old view toreuse, if possible. Note: You should check that this view
     *                    is non-null and of anappropriate type before using. If it is not possible to convert
     *                    this view to display thecorrect data, this method can create a new view.
     *                    Heterogeneous lists canspecify their number of view types, so that this View is
     *                    always of the right type(see {@link #getViewTypeCount()} and
     *                    {@link#getItemViewType(int)}).
     * @param parent      The parent that this view will eventuallybe attached to
     * @return An instance of BaseAdapterHelper
     */
    protected abstract H getAdapterHelper(intposition, View convertView, ViewGroup parent);
 
}


       重点我们来看下这个类的相关实现:

         2.1.1.成员变量context为获取控件所需要的上下文,layoutResId为布局文件的id。其中data的类型是List<T>的,由于这边传入的实体信息可能是不同类型的集合,所以这边采用了泛型来进行定义了。

         2.1.2.getViewTypeCount(),getItemViewType()这边我们可以看源代码第一个函数返回2,第二个函数会进行判断返回position。因为base-adapter-helper已经实现的progressbar进度的显示控制条。

        2.1.3.然后是一些实现adapter都要实现的方法例如:getCount,getView,getItem,getItemId之类的方法,还有一些关于数据操作的方法。

        2.1.4.重点看一下getView方法:


public ViewgetView(int position, View convertView, ViewGroup parent) {
        if (getItemViewType(position) == 0) {
            //获取适配器helper --相当于获取ViewHolder-BaseAdapterHelper
            final H helper =getAdapterHelper(position, convertView, parent);
            //获取item model 数据
            T item = getItem(position);
            //给子类QuickAdapter来进行实现,不过QuickAdapter也是抽象类,给具体创建的类进行实现
            convert(helper, item);
            helper.setAssociatedObject(item);
            return helper.getView();
        }
        //显示进度
        returncreateIndeterminateProgressView(convertView, parent);
    }


    重点地方已经注释了,在这个方法中,会首先进行判断getItemViewType(position)的值,如果返回值不等于0的时候,那就是说显示底部的进度,其他的情况会正常加载view。此时通过抽象方法getAdapterHelper()来进行获取一个BaseAdapterHelper

该抽象方法的实现类是QuickAdapter:


 /**
     * 进行获取类ViewHolder的  BaseAdapterHelper
     * @param position    The position of the item within theadapter's data set of the item whose view we want.
     * @param convertView The old view toreuse, if possible. Note: You should check that this view
     *                    is non-null and of anappropriate type before using. If it is not possible to convert
     *                    this view to display thecorrect data, this method can create a new view.
     *                    Heterogeneous lists canspecify their number of view types, so that this View is
     *                    always of the right type(see {@link #getViewTypeCount()} and
     *                    {@link#getItemViewType(int)}).
     * @param parent      The parent that this view will eventuallybe attached to
     * @return
     */
    protected BaseAdapterHelpergetAdapterHelper(int position, View convertView, ViewGroup parent) {
        return get(context, convertView,parent, layoutResId, position);
    }


        其中又去调用BaseAdapterHelper的如下方法:


/** This method ispackage private and should only be used by QuickAdapter. */
    /**
     * 进行获取类ViewHolder的BaseAdapterHelper对象
     * @param context      上下文引用
     * @param convertView   item view
     * @param parent        父控件view
     * @param layoutId       布局ID
     * @param position      索引
     * @return
     */
    static BaseAdapterHelper get(Contextcontext, View convertView, ViewGroup parent, int layoutId, int position) {
        if (convertView == null) {
            return newBaseAdapterHelper(context, parent, layoutId, position);
        }
        // Retrieve the existing helper andupdate its position
        BaseAdapterHelper existingHelper =(BaseAdapterHelper) convertView.getTag();
        existingHelper.position = position;
        return existingHelper;
    }


         该类中的实现方法就是首先判断convertView是否为null,如果为null,进行创建。否则直接从getTag()进行获取,然后返回当前BaseAdapterHelper,到这边相比大家有没有明白BaseAdapterHelper和我们以前接触的ViewHolder相似了呢?对的,这边的BaseAdapterHelper其实就是充当的ViewHolder角色。

           上面我们分析了getAdapterHelper的生成方式,下面我们看一下itemdata的获取,这个比较简单直接如下即可:

           //获取item model数据    


T item = getItem(position);

            该类最后我们来看一个最关键的代码

//给子类QuickAdapter来进行实现,不过QuickAdapter也是抽象类,给具体创建的类进行实现           


 convert(helper, item);

           convert()为抽象方法,convert的参数为BaseAdapterHelper和实体对象item,让我们用户可以自定义自由绑定数据到控件中。绑定成功之后直接通过调用helper.getView()返回即可。

           

          2.2.BaseAdapterHelper

           上面get()方法的时候已经说过BaseAdapterHelper相当于ViewHolder,同时该类还提供一大堆的方法来让我们进行设置view的数据,属性,以及一些事件方法。 我们首先开看构造方法:         

protectedBaseAdapterHelper(Context context, ViewGroup parent, int layoutId, intposition) {
        this.context = context;
        this.position = position;
        this.views = newSparseArray<View>();
        convertView =LayoutInflater.from(context) //根据布局id来加载view
                .inflate(layoutId, parent,false);
       convertView.setTag(this);//相当于存放ViewHolder
    }

           该构造方法创建一个稀疏数组来存放view对象(用来绑定数据的)。然后根据布局id来进行获取convertView,同时把当前对象加入到convertView得tag中,然后后面我们可以通过convertView.getTag()来进行获取,这样保持BaseAdapterHelper对于convertView的相互持有引用。


          除了以上的构造方法以外,还有另外一个进入BaseAdapterHelper的入口:


/**
     * This method is the only entry point toget a BaseAdapterHelper.
     * @param context     The current context.
     * @param convertView The convertView argpassed to the getView() method.
     * @param parent      The parent arg passed to the getView()method.
     * @return A BaseAdapterHelper instance.
     */
    public static BaseAdapterHelper get(Contextcontext, View convertView, ViewGroup parent, int layoutId) {
        return get(context, convertView,parent, layoutId, -1);
    }
 
    /** This method is package private andshould only be used by QuickAdapter. */
    /**
     * 进行获取类ViewHolder的BaseAdapterHelper对象
     * @param context      上下文引用
     * @param convertView   item view
     * @param parent        父控件view
     * @param layoutId       布局ID
     * @param position      索引
     * @return
     */
    static BaseAdapterHelper get(Contextcontext, View convertView, ViewGroup parent, int layoutId, int position) {
        if (convertView == null) {
            return newBaseAdapterHelper(context, parent, layoutId, position);
        }
        // Retrieve the existing helper andupdate its position
        BaseAdapterHelper existingHelper =(BaseAdapterHelper) convertView.getTag();
        existingHelper.position = position;
        return existingHelper;
    }


上面会进行判断convertView是否存在,不存在进行调用构造方法创建,存在直接从convertView.getTag()来获取BaseAdapterHelper对象。

          下面我们来另外的比较重要的两个方法,主要是获取view控件,然后同时加入到稀疏数组中:


public <T extends View> T getView(intviewId) {
        return retrieveView(viewId);
    }


  

 /**
     * 进行从模板view中获取相应的控件 然后放入到view控件集合中
     */
    protected <T extends View> TretrieveView(int viewId) {
        //从集合中获取当前viewId的view,如果集合中不存在,那么从view重findById()
        //获取出来存放到集合中 并且返回
        View view = views.get(viewId);
        if (view == null) {
            view =convertView.findViewById(viewId);
            views.put(viewId, view);
        }
        return (T) view;
    }


        上面方法我们可以看出,每次调用retrieveView方法的时候,都会根据viewId去views集合中查询一下,如果不存在,那么会通过findViewById(viewId)来进行获取,同时把该view加入到集合中,这样下次查询就不需要重复调用findViewById()了。

        其他一些工具方法,例如设置字体,文本,图片,颜色,事件啊等等….


        一大堆的方法这边就不贴代码了,具体每个方法的含义已经在项目源代码中注释了,大家有兴趣可以去下载项目然后去阅读一下:

     FastDev4Android框架项目地址:https://github.com/jiangqqlmj/FastDev4Android

      2.3.EnhancedQuickAdapter:该类是继承自QuickAdapter,其他多出下面的两个方法:


/**
     * 进行绑定控件和数据  数据发生变化
     * @param helper A fully initializedhelper.
     * @param item   The item that needs to be displayed.
     */
    @Override
    protected final voidconvert(BaseAdapterHelper helper, T item) {
        boolean itemChanged =helper.associatedObject == null || !helper.associatedObject.equals(item);
        helper.associatedObject = item;
        convert(helper, item, itemChanged);
    }
 
    /**
     * 让用户来自定义
     * @param helper      The helper to use to adapt the view.
     * @param item        The item you should adapt the view to.
     * @param itemChanged Whether or not thehelper was bound to another object before.
     */
    protected abstract voidconvert(BaseAdapterHelper helper, T item, boolean itemChanged);


          仔细看convert()方法,多了第三方参数itemChanged,对于data集合发生改变的时候刷新View。

().改进点:   

          我们在进行控件,数据模型进行绑定的时候都是采用set方法才完成。但是我们的需求是千变万化的,就拿图片加载来说,框架内部默认是采用Picasso来加载图片的。但是如果我们的项目想要采用Volley,UIL或者Fresco呢?那么我们不得不需要在里边进行扩展相应的方法来实现了。虽然这种方案可以解决问题,但是如果还有其他方案,那么一直在扩展就会变得很庞大了。幸运的时候convert()方法回调回来的BaseAdapterHelper对象helper,该类中有getView()retrieveView()方法,同时getView()还是public,对外开放的,我们在convert()实现方法中直接通过getView()即可获取view,然后如何显示图片就看我们自己的了。除此之外里边很多设置字体,文本等等很少辅助类,如果需要设置更多的东西,我们需要不断的扩展。

().结束语:

         经过昨天和今天的讲解介绍,相应大家对于base-adapter-helper的基本使用和源码原理分析有一个比较清晰的了解,以后在项目中也可以多多使用这个,一定会提高写代码的效率。其他这个框架学习分析下来,非常核心的东西也还是比较好理解,重点要看思考,分析吧。继续加油。

         到此Base-Adapter-Helper的基本介绍和基本使用已经讲完了,具体实例和框架注释过的全部代码已经上传到FastDev4Android项目中了。

         同时欢迎大家去Github站点进行clone或者下载浏览:

https://github.com/jiangqqlmj/FastDev4Android 同时欢迎大家starfork整个开源快速开发框架项目~


dd