PullToRefresh下拉刷新，上拉分页，返回顶部

一、概述：

PullToRefresh是封装好的上拉分页和下拉刷新库，它支持：
ListView，ExpandableListView，GridView，WebView，ScrollView，HorizontalScrollView，ViewPager

二、准备工作：

2.0、Library下载地址：

https://github.com/chrisbanes/Android-PullToRefresh

2.1、导入配置步骤：

1、下载zip压缩包之后，解压，得到几个文件，如下图：

2、在Andriod Studio中New Module，导入libary，记得修改名字，做到见名知意，我命名为MyPullToRefreshLibrary。
3、File->Project Structure->app->Dependencies->右上角+ ->Module Dependency->MyPullToRefreshLibrary->ok
4、如果导入成功的话效果如下图：文件夹上有三本小书

2.2、PullToRefresh基本用法：

1、在布局文件中添加PullToRefresh控件，此处以PullToRefreshListView为例；
2、在Activity中，设置监听器OnRefreshListener(2)以响应用户上拉和下拉操作；
3、在监听器的onRefresh()（或者onPullDownToRefresh()和onPullUpToRefresh()）方法中执行数据刷新操作，可以通过AsyncTask来实现；
4、在AsyncTask中获取到数据后，记得调用onRefreshComplete()方法通知PullToRefresh控件数据已获取完毕，可以结束刷新操作。

三、代码详解：

以下例子摘自我的一个项目，用到PullToRefreshListView并不是MainActivity，而是一个Fragment，在Fragment中返回顶部时候又遇到种种困惑以及解决方案，下面会一一讲述：

Fragment中的代码：

import android.content.Context;
import android.os.AsyncTask;
import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.text.TextUtils;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.ListView;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.handmark.pulltorefresh.library.PullToRefreshBase;
import com.handmark.pulltorefresh.library.PullToRefreshListView;

import org.xutils.common.Callback;
import org.xutils.http.RequestParams;
import org.xutils.x;

import java.util.List;

import king.timeline.com.timeline.Bean.NEWSBean;
import king.timeline.com.timeline.R;
import king.timeline.com.timeline.adapter.NEWSAdapter;
import king.timeline.com.timeline.baseUtils.BaseFragment;

/** * A simple {@link Fragment} subclass. */
public class NEWSPagerFragment extends BaseFragment implements View.OnClickListener {
    private String newsPath = "http://api.m.mtime.cn/News/NewsList.api?pageIndex=";
    private int page = 1;
    private PullToRefreshListView pRListView;
    private NEWSAdapter adapter;
    private Button btToTop;//用于返回顶部
    private ListView listView;

    public NEWSPagerFragment(Context context) {
        super(context);
    }

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        // Inflate the layout for this fragment
        View view = inflater.inflate(R.layout.fragment_newspager, container, false);
        init(view);
        getJson(1);//默认下载第一页
        return view;
    }

    @Override
    public void onClick(View v) {
// listView.setSelection(0);//没有特效，直接返回顶部
// listView.setSelectionAfterHeaderView();
        listView.smoothScrollToPosition(0);//平滑的返回顶部
    }


    /** * xutils网络请求get方式下载json字符串 */
    private void getJson(int page) {
        RequestParams requestParams = new RequestParams(newsPath + page);
        x.http().get(requestParams, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                if (!TextUtils.isEmpty(result)) {
                    //解析json字符串
                    adapter.addList(jsonToList(result));
                }
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {

            }

            @Override
            public void onCancelled(CancelledException cex) {

            }

            @Override
            public void onFinished() {

            }
        });
    }

    private void init(View view) {

        //点击按钮返回顶部
        btToTop = (Button) view.findViewById(R.id.bt_to_top);
        btToTop.setOnClickListener(this);

        pRListView = (PullToRefreshListView) view.findViewById(R.id.news_listView);
        //设置刷新的模式(3中常见模式，1种是只能上拉，2是只能加载更多3是既能上拉又能刷新)
        pRListView.setMode(PullToRefreshBase.Mode.BOTH);
        adapter = new NEWSAdapter(getActivity());
        pRListView.setAdapter(adapter);
        //通过PullToRefresh获取其内部封装的listView对象方便设置返回顶部和返回特效
        listView = pRListView.getRefreshableView();
        //给PullToRefreshListView设置监听
        pRListView.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {

            @Override
            public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
                //TODO 设置下拉时候的逻辑
                new FinishRefresh().execute();
            }

            @Override
            public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
                //TODO 设置上拉时候触发的方法,加载下一页
                page++;
                getJson(page);
                new FinishRefresh().execute();
            }
        });
    }

    /** * 用fastJson解析字符串 * * @param s * @return */
    private List<NEWSBean> jsonToList(String s) {
        List<NEWSBean> mList;
        JSONObject object = JSON.parseObject(s);
        JSONArray array = object.getJSONArray("newsList");
        mList = JSONArray.parseArray(array.toString(), NEWSBean.class);
        //Log.e("===", "mList.size()" + mList.size());
        return mList;
    }

    /** * 开启异步任务，用于加载刷新 */
    private class FinishRefresh extends AsyncTask<Void, Void, Void> {
        @Override
        protected Void doInBackground(Void... params) {
            try {
                Thread.sleep(2000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            return null;
        }

        @Override
        protected void onPostExecute(Void result) {
            pRListView.onRefreshComplete();
        }
    }
}

布局文件中的代码：

<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="king.timeline.com.timeline.fragment.NEWSPagerFragment"
    >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        android:id="@+id/news_listView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        />

    <Button
        android:textColor="@color/md_grey_100"
        android:id="@+id/bt_to_top"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:layout_alignParentRight="true"
        android:background="#666666"
        android:drawableLeft="@drawable/top"
        android:paddingRight="10dp"
        android:text="返回顶部"
        />
</RelativeLayout>

四，代码说明：

1，设置拉动模式有三种：

pRListView.setMode(PullToRefreshBase.Mode.BOTH);//有上下拉
Mode.BOTH：同时支持上拉下拉
Mode.PULL_FROM_START：只支持下拉Pulling Down
Mode.PULL_FROM_END：只支持上拉Pulling Up

2，注册监听：

两个接口：OnRefreshListener和OnRefreshListener2，

• 如果Mode设置成Mode.BOTH，需要设置刷新Listener为OnRefreshListener2，并实现onPullDownToRefresh()、onPullUpToRefresh()两个方法。
• 如果Mode设置成Mode.PULL_FROM_START或Mode.PULL_FROM_END，需要设置刷新Listener为OnRefreshListener，同时实现onRefresh()方法。当然也可以设置为OnRefreshListener2，但是Mode.PULL_FROM_START的时候只调用onPullDownToRefresh()方法，Mode.PULL_FROM的时候只调用onPullUpToRefresh()方法.

3，返回置顶：

1. Button控件在fragment中无法使用onClick方式设置监听，否则会抛出异常，提示找不到onClick指定的方法，具体原因百度了好久，不知所云。那就乖乖使用setOnClickListener呗。
2. PullToRefresh返回顶部，需要PullToRefreshListView.getRefreshableView()获取其内部封装的listView对象；然后通过ListView.setSelection(0)，或者设置返回特效listView.smoothScrollToPosition(0)
3. 开启异步任务AsyncTask一方面用于多线程加载数据，另外一方面，在上拉下拉中必须调用这个异步任务，不然下拉圆圈一直转转转，不会停止，我尝试着在下拉逻辑中直接插入一行PullToRefreshListView.onRefreshComplete()来取代new FinishRefresh().execute()，结果还是不凑效，还是一直转不停，所以只有开启异步任务的方式停止刷新了。

效果图：