开源组件PullToRefresh

开源组件PullToRefresh

---

介绍：

PullToRefresh：顾名思义，是一个支持下拉刷新的组件。它是一个老外编写的，功能强大，支持ListView，GridView等等，在github上比较火。

github地址：https://github.com/chrisbanes/Android-PullToRefresh

最近在看自定义View的实现，特地找了几个开源项目研究一下：）

第三方库引入：(IDE: Android Studio)

最简单的当然是直接依赖远程仓库，也不用专门下载过来，特别方便。照理说在项目的 readme.md 里都会写明依赖的地址，这个项目呢居然没有，差评！！！
好啦，反正度娘一下就找到了-. -

//只用在app:build.gradle里加上一行:
dependencies {
    ...
    compile 'com.loopeer.android.thirdparty.pulltorefresh:Android-PullToRefresh:2.1.1'
}

编译一下gradle，你会看到 External Libraries 里已经有了这个 PullToRefresh 的 jar 包

---

当然也可以把整个项目下载下来，你会发现有3个文件夹 extras，library 和 sample。嗯，我们要的只是其中的库 library，把它 copy 到我们的项目中，然后添加好依赖就好了。这里不展开讲，具体过程请看：

传送门：http://blog.csdn.net/ahence/article/details/46545985

使用:（下拉刷新）

就以 ListView 为例好了。
首先，在 activity_main 里面加好控件：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

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

</RelativeLayout>

然后，在 MainActivity 里实例化它，并重写作者提供的 onRefresh() 方法即可.
这里用 AsyncTask 执行一个耗时的任务 sleep(2秒)。

package com.example.i_jinliangshan.pulltorefreshdemo;

import android.app.Activity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.os.SystemClock;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.ArrayAdapter;
import android.widget.ListView;

import com.handmark.pulltorefresh.library.PullToRefreshBase;
import com.handmark.pulltorefresh.library.PullToRefreshListView;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends Activity {
    private List<String> textList;
    private PullToRefreshListView plv;
    private ArrayAdapter<String> adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        setData();
        init();
    }

    private void setData() {
        textList = new ArrayList<String>();
        for(int i=0; i<15; i++)
            textList.add(i+"");
    }

    private void init() {
        plv = (PullToRefreshListView)findViewById(R.id.plv);
        adapter= new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, textList);
        plv.setAdapter(adapter);

        plv.setOnRefreshListener(new PullToRefreshBase.OnRefreshListener<ListView>() {
            @Override
            public void onRefresh(PullToRefreshBase<ListView> pullToRefreshBase) {
                new MyTask().execute();
            }
        });
        // 手指动作主要由 onTouchEvent() 来响应
        // 下拉: onTouchEvent().ACTION_MOVE-> pullEvent().setState()
        // 松开：onTouchEvent().ACTION_UP
        //      -> setState().MANUAL_REFRESHING
        //      -> onRefreshing().smoothScrollTo()
        //      -> 回调我们的接口 onRefresh()
    }


    private class MyTask extends AsyncTask<Void, Void, Void>{
        @Override
        protected Void doInBackground(Void... voids) {
            try{
                Thread.sleep(2000);     // 模拟耗时任务 2s
            }catch(InterruptedException e){
                e.printStackTrace();
            }
            textList.add(0, "下拉刷新出的数据");
            textList.add(0, "下拉刷新出的数据");
            return null;
        }

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

            super.onPostExecute(aVoid);
        }
    }
}

参考博客：

---

关于使用：

这篇博客非常详细，手动收藏
http://blog.csdn.net/u011068702/article/details/48688281

关于源码：

如果你要研究源码的话，可以先看看这个。
这篇博文介绍了简化版的下拉刷新的实现，与PullToRefresh的思路如出一辙。
它没有那么多的基类和层层委托，代码精简小巧，容易看懂。
http://blog.csdn.net/allen315410/article/details/39965327

想直接开撸源码的话，推荐另一篇博文：
文章思路清晰，开篇大大的UML类图简直亮瞎我的狗眼。
ps:会画类图的猿，技术都不会差哦！
http://blog.csdn.net/birdsaction/article/details/44831737