PullToRefresh下拉刷新的简单使用

　Android中很多时候都会用到上下拉刷新，这是一个很常用的功能，Android的v4包中也为我们提供了一种原生的下拉刷新控件--SwipeRefreshLayout，可以用它实现一个简洁的刷新效果，但今天我们的主角并不是它，而是一个很火的第三方的上下拉刷新控件--PullToRefresh。PullToRefresh包括PullToRefreshScrollView、PullToRefreshListView、PullToRefreshGridView等等很多为我们提供的控件，我们可以在xml文件中直接引入作为控件使用。

　　与一些其他的第三方库不同，PullToRefresh的使用需要我们引用一个module作为依赖：

之后进入我们的project的配置中心，快捷键是ctrl+alt+shift+s，然后选中你想要添加上下拉刷新的module，点击右上角的加号，选择Module dependency PullToRefresh下拉刷新的简单使用：

然后一路点击"OK"，等待一会就可以将这个类库附加到我们项目中了，我们就可以使用上下拉刷新了。

　　我们引入的第三方库的目录结构是这样的：

PullToRefresh下拉刷新的简单使用

　　在xml文件中使用该控件的时候，注意要使用包名.类名的形式来引用你想要使用的控件，像这样：

1 com.handmark.pulltorefresh.library.PullToRefreshListView

　　包名可以在我们引入的库的module的AndroidManifest中查看，在目录中的java文件夹下的类就是我们要使用的类。这里我们以PullToRefreshListView为例，其他的控件的使用方法类似。非常恶心的是控件里面的属性没有代码提示...没有代码提示...没有代码提示！害的我对照了好几遍，以为自己倒错了module，结果是因为没有代码提示。

　　我们先来看几个比较重要的方法：

 1 　　　　//获取带有刷新的对应控件
 2         pullToRefreshListView.getRefreshableView();
 3         /**
 4          * 设置刷新的模式：常用的有三种
 5          * PullToRefreshBase.Mode.BOTH  //上下拉刷新都可以
 6          * PullToRefreshBase.Mode.PULL_FROM_START  //只允许下拉刷新
 7          * PullToRefreshBase.Mode.PULL_FROM_END   //只允许上拉刷新
 8          *
 9          */
10         pullToRefreshListView.setMode(PullToRefreshBase.Mode.PULL_FROM_END);
11         //设置是否允许刷新的时候可以滑动
12         pullToRefreshListView.setScrollingWhileRefreshingEnabled(true);

　　当我们通过getRefreshableView()获得对应的带有刷新的控件(如使用PullToRefreshListView的时候，调用此方法会返回一个ListView实例)的时候会得到一个对应的控件，比如说ListView，则listItem的点击事件或者是数据适配我们就可以对这个获取到的ListView进行。

　　还有一个比较重要的方法就是为控件设置刷新时的监听：

1 pullToRefreshListView.setOnRefreshListener()

　　他有两个参数可以传，一个是

1 PullToRefreshBase.OnRefreshListener<T>

　　接口对应的匿名内部类形式。一个是

1 PullToRefreshBase.OnRefreshListener2<T>

　　接口对应的匿名内部类形式。其中一般上下拉刷新同时可用的时候我们选择第二个形式：

 1 pullToRefreshListView.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {
 2             //完成下拉刷新操作
 3             @Override
 4             public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
 5 
 6             }
 7 
 8             //完成上拉刷新操作
 9             @Override
10             public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
11 
12             }
13         });

　　当然，PullToRefresh还有一个重要方法就是

1 pullToRefreshListView.onRefreshComplete();

　　此方法用来通知刷新完成了，取消刷新动画，如果不加这一句，会一直显示一个刷新动画。这里我们模拟一些数据，并且在下拉刷新的时候使用线程让程序睡2s，然后再随机加载一条新数据并通知Adapter更新UI，完成代码如下：

 1 package ggcomic.rabbit.lx.pulltorefresh;
 2 
 3 import android.os.Handler;
 4 import android.support.v7.app.AppCompatActivity;
 5 import android.os.Bundle;
 6 import android.widget.ArrayAdapter;
 7 import android.widget.ListView;
 8 
 9 import com.handmark.pulltorefresh.library.LoadingLayoutProxy;
10 import com.handmark.pulltorefresh.library.PullToRefreshBase;
11 import com.handmark.pulltorefresh.library.PullToRefreshListView;
12 
13 import java.util.ArrayList;
14 import java.util.List;
15 
16 public class MainActivity extends AppCompatActivity {
17 
18     private PullToRefreshListView pullToRefreshListView;
19     private ListView lv;
20     private List<String> datas;
21     private ArrayAdapter<String> adapter;
22     private Handler handler=new Handler();
23     private LoadingLayoutProxy llProxy;//设置刷新时的文本等的对象
24 
25     @Override
26 
27     protected void onCreate(Bundle savedInstanceState) {
28         super.onCreate(savedInstanceState);
29         setContentView(R.layout.activity_main);
30 
31         pullToRefreshListView = (PullToRefreshListView) findViewById(R.id.pull);
32 
33         datas=new ArrayList<>();
34         for(int i=1;i<=50;i++){
35             datas.add("item---------"+i);
36         }
37 
38         //获取带有刷新的对应控件
39         lv = pullToRefreshListView.getRefreshableView();
40         adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, datas);
41         lv.setAdapter(adapter);
42         /**
43          * 设置刷新的模式：常用的有三种
44          * PullToRefreshBase.Mode.BOTH  //上下拉刷新都可以
45          * PullToRefreshBase.Mode.PULL_FROM_START  //只允许下拉刷新
46          * PullToRefreshBase.Mode.PULL_FROM_END   //只允许上拉刷新
47          *
48          */
49         pullToRefreshListView.setMode(PullToRefreshBase.Mode.BOTH);
50         //设置是否允许刷新的时候可以滑动
51         pullToRefreshListView.setScrollingWhileRefreshingEnabled(true);
52 
53         pullToRefreshListView.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {
54             //完成下拉刷新操作
55             @Override
56             public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
57                 new Thread(new Runnable() {
58                     @Override
59                     public void run() {
60                         try {
61                             //休眠2s
62                             Thread.sleep(2000);
63                         } catch (InterruptedException e) {
64                             e.printStackTrace();
65                         }
66 
67                         //向集合中添加一个随机数
68                         datas.add(0,"item-------"+(int)(Math.random()*100+1));
69                         handler.post(new Runnable() {
70                             @Override
71                             public void run() {
72                                 adapter.notifyDataSetChanged();
73                                 //控件刷新最新的数据
74                                 pullToRefreshListView.onRefreshComplete();
75                             }
76                         });
77                     }
78                 }).start();
79             }
80 
81             //完成上拉刷新操作
82             @Override
83             public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
84 
85             }
86         });
87 
88     }
89 }

效果图是这样的：

PullToRefresh下拉刷新的简单使用

可以看到，刷新完成之后随机为我们添加了一个条目item--39。这样刷新就完成了，实际的项目中我们只需要在刷新的监听事件中完成我们的网络请求即可。