黑马程序员技术交流社区

标题: Android base-adapter-helper 源码分析与扩展 [打印本页]

作者: linxy06    时间: 2015-11-29 11:44
标题: Android base-adapter-helper 源码分析与扩展
1. 功能介绍

1.1. base-adapter-helper

base-adapter-helper 是对我们传统的BaseAdapter的ViewHolder的模式的一个抽象。主要功能就是简化我们在书写AbsListView,例如ListView,GridView的Adapter的代码。

1.2 基本使用

mListView.setAdapter(mAdapter = new QuickAdapter<Bean>(
            MainActivity.this, R.layout.item_list, mDatas)
    {

        @Overrideprotected void convert(BaseAdapterHelper helper, Bean item)
        {
            helper.setText(R.id.tv_title, item.getTitle());
            helper.setText(R.id.tv_describe, item.getDesc());
            helper.setText(R.id.tv_phone, item.getPhone());
            helper.setText(R.id.tv_time, item.getTime());
            // // helper.getView(R.id.tv_title).setOnClickListener(l)
        }
    });
1
2
3
4
5
6
7
8
9
10
11
12
13
14
1.3 特点

提供QucikAdapter,极大简化我们的代码。
BaseAdapterHelper中封装了大量用于为View操作的辅助方法,例如从网络加载图片:
helper.setImageUrl(R.id.iv_photo, item.getPhotoUrl());
2. 总体设计

2.1 总体设计图

2.1.1 ViewHolder Pattern



2.1.2 总体设计图


由于base-adapter-helper本质上仍然是ViewHolder Pattern,上面贴出base-adapter-helper的总体设计图和ViewHolder Pattern的设计图,通过两图的比较,可以看出base-adapter-helper对传统的BaseAdapter进行了初步的实现(QuickAdapter),并且仅公布出convert()方法,在convert()中可以拿到BaseAdapterHelper,BaseAdapterHelper就相当于ViewHolder,但其内部提供了大量的辅助方法,用于设置View上的数据,甚至是事件等。

3. 详细设计

3.1 类关系图


这是 base-adapter-helper 框架的主要类关系图

在BaseQucikAdapter中实现了BaseAdapter中通用的抽象方法
BaseQuickAdapter中两个泛型,一个T是针对数据,一个H是针对BaseAdapterHelper
QucikAdapter继承自BaseQuickAdapter,并且传入BaseAdapterHelper作为H泛型
EnhancedQuickAdapter 主要为convert方法,添加一个itemChanged参数,用于区分 dataset changed / dataset invalidated
BaseAdapterHelper中封装了常用View的赋值,以及事件监听的方法,方便操作。并且赋值方法都有采用链式编程,更加方便书写。
扩展BaseAdapterHelper可以继承BaseAdapterHelper,编写Adapter时继承BaseQuickAdapter,传入自定义的类作为H泛型。
3.2 核心类源码分析

3.2.1 BaseQucikAdapter.java

该类继承自BaseAdapter,完成BaseAdapter中部分通用抽象方法的编写,类似ArrayAdapter.
该类声明了两个泛型,一个是我们的Bean(T),一个是BaseAdapterHelper(H)主要用于扩展BaseAdapterHelper时使用。

(1).构造方法

public BaseQuickAdapter(Context context, int layoutResId) {
        this(context, layoutResId, null);
    }
    public BaseQuickAdapter(Context context, int layoutResId, List<T> data) {
        this.data = data == null ? new ArrayList<T>() : new ArrayList<T>(data);
        this.context = context;
        this.layoutResId = layoutResId;
    }
1
2
3
4
5
6
7
8
9
因为我们的Bean可能是多变的,所以传入的数据为List。

(2).BaseAdapter中需要实现的方法

@Overridepublic int getCount() {
        int extra = displayIndeterminateProgress ? 1 : 0;
        return data.size() + extra;
    }

    @Overridepublic T getItem(int position) {
        if (position >= data.size()) return null;
        return data.get(position);
    }

    @Overridepublic long getItemId(int position) {
        return position;
    }

    @Overridepublic int getViewTypeCount() {
        return 2;
    }

    @Overridepublic int getItemViewType(int position) {
        return position >= data.size() ? 1 : 0;
    }

    @Overridepublic boolean isEnabled(int position) {
        return position < data.size();
    }

    @Overridepublic View getView(int position, View convertView, ViewGroup parent) {
        if (getItemViewType(position) == 0) {
            final H helper = getAdapterHelper(position, convertView, parent);
            T item = getItem(position);
            helper.setAssociatedObject(item);
            convert(helper, item);
            return helper.getView();
        }

        return createIndeterminateProgressView(convertView, parent);
    }

    protected abstract void convert(H helper, T item);

    protected abstract H getAdapterHelper(int position, View convertView, ViewGroup parent);

    private View createIndeterminateProgressView(View convertView, ViewGroup parent) {
        if (convertView == null) {
            FrameLayout container = new FrameLayout(context);
            container.setForegroundGravity(Gravity.CENTER);
            ProgressBar progress = new ProgressBar(context);
            container.addView(progress);
            convertView = container;
        }
        return convertView;
    }

    public void showIndeterminateProgress(boolean display) {
        if (display == displayIndeterminateProgress) return;
        displayIndeterminateProgress = display;
        notifyDataSetChanged();
    }
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();
    }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
方法基本分为两类,一类是BaseAdapter中需要实现的方法;另一类用于操作我们的data。




欢迎光临 黑马程序员技术交流社区 (http://bbs.itheima.com/) 黑马程序员IT技术论坛 X3.2