Android PullToRefresh 分析之二、UI结构

前言：接着上一篇《Android PullToRefresh 分析之一、初识PullToRefresh》，这一篇主要分析UI结构，尽可能每一篇只说一点，然后将该点讲解清楚。

一、 问题思考

我们首先把上一篇的一个图拿过来，来分析这三段，如果让我们封装一个刷新加载框架应该怎样写，首先提出几个问题：

• 刷新加载的方向是怎样的，通常的是竖向，万一奇葩的需求提出横向呢？
• "内容区域"应该显示什么？怎么设置才好扩展？
• 怎么判断到顶部了，要触发刷新动作？
• 怎么判断到底部了，要触发加载操作？

OK，来分析下这四个问题：

• 对于问题一，非常简单，我们可以提供设置方向的配置；
• 对于问题二，似乎比较棘手，其实也比较好扩展，我们提供一个容器，想放什么布局都可以；
• 对于问题三、四不同的控件都有判断到顶部和尾部的方法。

这样，只有在基类中将配置的方法抽象出来让不同的实现去处理就好了。

二、UI源码分析

通过上面问题的思考，就给下面的源码分析做好了铺垫，不要骂我唐僧(太啰嗦了)，大牛请无视，只是为了让刚入门的朋友也能理清思路。还是以简单的 PullToRefreshScrollView来分析。

    来看下PullToRefreshScrollView都有哪些方法：

比较简单，只是覆盖了父类的四个方法，通过名称可以看出。

• getPullToRefreshScrollDirection() 为获取刷新加载的方向，是横向还是竖向；
• createRefreshableView() 为生成刷新加载View，这里生成的是 ScrollView；
• isReadyForPullStart() 为判断是否促发了刷新操作；
• isReadyForPullEnd() 为判断是否触发了加载操作；

是不是很眼熟，不错这就是我们提出的四个问题，也就是扩展一个控件只需要实现这四个方法就可以了。但是这几个方法是如何被调用的呢？我们来到它爸爸的类 PullToRefreshBase 瞅瞅。

    

    通过类的继承关系就可以看到继承自LinearLayout，再来看下构造函数：

// ===========================================================
// Constructors
// ===========================================================

public PullToRefreshBase(Context context) {
	super(context);
	init(context, null);
}

public PullToRefreshBase(Context context, AttributeSet attrs) {
	super(context, attrs);
	init(context, attrs);
}

public PullToRefreshBase(Context context, Mode mode) {
	super(context);
	mMode = mode;
	init(context, null);
}

public PullToRefreshBase(Context context, Mode mode, AnimationStyle animStyle) {
	super(context);
	mMode = mode;
	mLoadingAnimationStyle = animStyle;
	init(context, null);
}

可以发现，这几个构造函数都不约而同的调用了一个方法，PullToRefreshBase#init(context, attrs)；今天的主角就是它了，那它都进行了哪些初始操作呢：

@SuppressWarnings("deprecation")
private void init(Context context, AttributeSet attrs) {
    // ①、获取刷新加载的方向
    switch (getPullToRefreshScrollDirection()) {
        case HORIZONTAL:
            setOrientation(LinearLayout.HORIZONTAL);
            break;
        case VERTICAL:
        default:
            setOrientation(LinearLayout.VERTICAL);
            break;
    }
    ......
    // ②、获取配置的刷新加载模式
    if (a.hasValue(R.styleable.PullToRefresh_ptrMode)) {
        mMode = Mode.mapIntToValue(a.getInteger(R.styleable.PullToRefresh_ptrMode, 0));
    }
    ......

    // ③、初始化刷新加载View
    mRefreshableView = createRefreshableView(context, attrs);
    // ④、将刷新加载View添加到布局
    addRefreshableView(context, mRefreshableView);

    // ⑤、初始"刷新头部"和"加载外部"布局
    mHeaderLayout = createLoadingLayout(context, Mode.PULL_FROM_START, a);
    mFooterLayout = createLoadingLayout(context, Mode.PULL_FROM_END, a);

    ......

    // ⑥、根据刷新加载模式更新控件
    updateUIForMode();
}

省略掉我们暂时不关心的代码，接下来主要分析标注的五段：

    ①、首先就是抽象的getPullToRefreshScrollDirection()来获取刷新加载的方向，该方法在子类中去实现，也是对应我们在思考中提出的问题一；

    ②、获取配置的刷新加载模式，有其中Mode为一个内部的枚举，有DISABLED、PULL_FROM_START、PULL_FROM_END、BOTH、MANUAL_REFRESH_ONLY即不允许刷新加载、从头部刷新、从尾部加载、刷新加载都支持、只允许手动刷新加载，对应的在布局中的配置为

③、createRefreshableView()生成刷新加载View，该方法也是抽象的由子类去实现；

④、在生成刷新加载View后调用了addRefreshableView()，通过名称为加载到View结构上，

private void addRefreshableView(Context context, T refreshableView) {
    mRefreshableViewWrapper = new FrameLayout(context);
    mRefreshableViewWrapper.addView(refreshableView, ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT);

    addViewInternal(mRefreshableViewWrapper, new LinearLayout.LayoutParams(LayoutParams.MATCH_PARENT,
            LayoutParams.MATCH_PARENT));
}

把刷新加载View添加到FrameLayout上，然后将该FrameLayout 加载到自身LinearLayout上，可见这个名叫mRefreshableViewWrapper 的FrameLayout就是刷新加载View的父View。前面已经提到过，就是对应的我们在思考中提出的问题二；

    ⑤、初始"刷新头部"和"加载外部"布局，在初始化头部和尾部的时候都是调用的 createLoadingLayout()方法，只是传入的参数不同；

protected LoadingLayout createLoadingLayout(Context context, Mode mode, TypedArray attrs) {
    LoadingLayout layout = mLoadingAnimationStyle.createLoadingLayout(context, mode,
            getPullToRefreshScrollDirection(), attrs);
    layout.setVisibility(View.INVISIBLE);
    return layout;
}

发现是调用的 LoadingAnimationStyle类的createLoadingLayout()方法，接着跟进去：

LoadingLayout createLoadingLayout(Context context, Mode mode, Orientation scrollDirection, TypedArray attrs) {
    switch (this) {
        case ROTATE:
        default:
            return new RotateLoadingLayout(context, mode, scrollDirection, attrs);
        case FLIP:
            return new FlipLoadingLayout(context, mode, scrollDirection, attrs);
    }
}

是根据刷新加载样式不同来生成布局，可以看到默认提供了两种样式，一个是这样的 ，另一个是这样的。
    ⑥、 最后调用了 updateUIForMode()，即根据刷新加载的模式来更新UI：

protected void updateUIForMode() {
    // We need to use the correct LayoutParam values, based on scroll
    // direction
    final LinearLayout.LayoutParams lp = getLoadingLayoutLayoutParams();

    ......

    if (mMode.showHeaderLoadingLayout()) {
        addViewInternal(mHeaderLayout, 0, lp);
    }

    ......

    if (mMode.showFooterLoadingLayout()) {
        addViewInternal(mFooterLayout, lp);
    }

    // Hide Loading Views
    refreshLoadingViewsSize();

    ......
}

在这里把头部和尾部 加载到自身LinearLayout上，并隐藏头部和尾部。

    至此，怎么生成"刷新头部"、"加载尾部"及"内容区域"并将它们都加载到自身的LinearLayout上就清楚了。

三、结语

    在该篇中，我们只是搞清楚了一个问题，就是"刷新头部"、"内容部分"、"加载尾部"是如何初始化及加载到布局上，下篇《Android PullToRefresh 分析之三、手势响应》中将主要分析是如何响应手指滑动事件的。