開源組件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