Android中pullToRefresh使用

pullToRefresh的导入

首先，点击new按钮 -> import Module

然后在 New Module界面选择已经在本地的含有源代码的pullToRefresh。

打开如下图所示的open Module Settings 按钮

点击app中的Dependencies 中右边框的"+"按钮，选择第三个 ，如下所示

选择Modules : pullToRefreshLibrary ,点击OK
然后在build.gradle(Module:app)或者你自己要写的那个android 程序的根文件夹的build.gradle中加入下面一句话

compile project(':pullToRefreshLibrary')

自此，pullToRefresh已经导入成功，可以新建一个pullToRefrenshListView验证一下。

pullToRefreshListView的基本使用

pullToRefreshListView和ListView的使用基本差的不多，只不过ListView的xml要换成com.handmark.pulltorefresh.library.PullToRefreshListView
例子如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:layout_height="match_parent"
        android:layout_width="match_parent"
        android:id="@+id/refresh_list_view"
        ptr:ptrDrawable="@drawable/default_ptr_flip"
        ptr:ptrAnimationStyle="flip"
        ptr:ptrHeaderBackground="#383838"
        ptr:ptrHeaderTextColor="#FFFFFF"  >

    </com.handmark.pulltorefresh.library.PullToRefreshListView>

</LinearLayout>

上面的例子中pullToRefreshListView中多了几个属性 分别以ptr开头，这是指定pullToRefreshListView在刷新的时候出现的特效，比如第一个是指定刷新时显示的图片，第二个是指定刷新的图片以何种方式显示出来，第三个是指定刷新时头部的背景，第四个是指定刷新时头部字体的颜色。

以上这些都可以在代码中设置。

ListView中每个item的xml还是不变的，adapter的使用和写法也是不变的，需要改变的只有设定刷新事件。

接下来在代码中设定pullToRefreshListView的一些基本属性和事件。

步骤一 绑定控件，设置属性

绑定控件代码如下：

private PullToRefreshListView listview;
listview = (PullToRefreshListView) findViewById(R.id.refresh_list_view);

设置刷新时显示的刷新状态

//对pullToListView绑定adapter
listview.setAdapter(adapter);
 /*设置pullToRefreshListView的刷新模式，BOTH代表支持上拉和下拉，PULL_FROM_END代表上拉,PULL_FROM_START代表下拉 */  
listview.setMode(PullToRefreshBase.Mode.BOTH);
initRefreshListView();

initRefreshListView方法设置刷新显示的状态

public void initRefreshListView() {
    ILoadingLayout Labels = listview.getLoadingLayoutProxy(true, true);
    Labels.setPullLabel("快点拉");
    Labels.setRefreshingLabel("正在拉");
    Labels.setReleaseLabel("放开刷新");
}

这里通过getLoadingLayoutProxy 方法来指定上拉和下拉时显示的状态的区别，第一个true 代表下来状态 ，第二个true 代表上拉的状态 。如果想区分上拉和下拉状态的不同，可以分别设置getLoadingLayoutProxy ,例子如下：

public void initRefreshListView(){    
    ILoadingLayout startLabels = pullToRefresh    
                .getLoadingLayoutProxy(true, false);    
    startLabels.setPullLabel("下拉刷新");    
    startLabels.setRefreshingLabel("正在拉");   
    startLabels.setReleaseLabel("放开刷新");    
    ILoadingLayout endLabels = pullToRefresh.getLoadingLayoutProxy(    
                false, true);    
    endLabels.setPullLabel("上拉刷新");    
    endLabels.setRefreshingLabel("正在载入...");  
    endLabels.setReleaseLabel("放开刷新...");

这样pullToRefreshListView刷新时状态就设定好了。

步骤二 pullToRefreshListView监听事件的设置

这里主要设置setOnRefreshListener 事件，根据刚才设置的不同的刷新模式，在里面写的匿名内部类也不一样。
规则如下：

如果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_END的时候只调用onPullUpToRefresh()方法.

这样在进入该Activity时候，手动上拉和下拉就会实现刷新和加载。
如果想刚进入Activity的时候就执行加载，则要调用如下方法

listview.setRefreshing();

接下来只需要在onPullDownToRefresh和onPullUpToRefresh 编写要获取listview新数据的方法。
我这里的例子如下：

listview.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener2<ListView>() {
     @Override
     public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {
            adapter.addToTop();
            new FinishRefresh().execute();
}

     @Override
     public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {
            adapter.addToBottom();
            new FinishRefresh().execute();
}
});

我这里在自定义的adapter中写了2个新方法 addToTop 和addToBottom 分别在头部加入数据和在尾部加入数据
方法如下：

 private void addToTop() {
    for (int i = 0; i < 2; i++) {
          Item item = new Item();
          item.setText("在头部加入第" + i + "数据");
          item.setImageid(R.mipmap.ic_launcher);
          listItems.add(i, item);
    }
}
private void addToBottom() {
    for (int i = 0; i < 2; i++) {
          Item item = new Item();
          item.setText("在尾部加入第" + i + "数据");
          item.setImageid(R.mipmap.ic_launcher);
          listItems.add(item);
     }
}

这里并没有考虑去重的问题，就是每次刷新结束后会显示出刷新的结果，当再次刷新后，又会执行和上次一样的结果，实际上，这是不符合逻辑的，当第二次在刷新的时候应该进行判断，如果数据一样就不把数据加入到list当中。

接下来 new FinishRefresh().execute(); 是这里我比较疑惑的一个固定写法，在这个com.handmark.pulltorefresh.library.PullToRefreshListView 框架下，执行onRefreshComplete();方法必须在异步下执行，不能和主进程一起执行，如果直接在下拉，上拉监听方法中写入onRefreshComplete(); 则在实际刷新中刷新状态的显示header是不会收回去的，换句话说 刷新一直不会完成。

所以要在继承AsyncTask的类下调用onRefreshComplete();

private class FinishRefresh extends AsyncTask<Void, Void, Void> {
        @Override
        protected Void doInBackground(Void... params) {
            try {
                Thread.sleep(1000);
            } catch (InterruptedException e) {

            }
            return null;
        }

        @Override
        protected void onPostExecute(Void aVoid) {
            listview.onRefreshComplete();
            adapter.notifyDataSetChanged();
        }
    }

至此，pullToRefreshListview就实现了简单的上拉，下拉使用

步骤三 pullToRefresListView 的其他监听方法

未完待续