提要：本文主要介紹了android提供的原生下拉重新整理控制元件SwipeRefreshLayout；在github上，由作者Chris Banes實現的第三方下拉重新整理(上拉重新整理)控制元件的原始碼淺析以及根據其原始碼自己實現的簡單下拉重新整理demo。

系統控制元件SwipeRefreshLayout淺析

下拉重新整理(上拉重新整理)是近兩三年android APP比較流行的實現頁面更新的控制元件，可以使用android.support.v4.widget包的原生控制元件SwipeRefreshLayout實現下拉重新整理功能，本demo實現了每次執行下拉重新整理後生成一個1-100之間的隨機整數，效果如下：

向下拉動

正在重新整理

重新整理完畢

xml佈局檔案

<android.support.v4.widget.SwipeRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/swipe_refresh"
    android:layout_width="match_parent"
    android:layout_height
 
="match_parent"
    tools:context="${relativePackage}.${activityClass}" >

    <ScrollView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:text="@string/hello_world" >

        <LinearLayout
            android:layout_width="match_parent"
 

            android:layout_height="wrap_content"
            android:orientation="horizontal" >

            <TextView
                android:id="@+id/text_view"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="下拉重新整理以生成一個隨機數："
                android:textSize="23sp" />

            <TextView
                android:id="@+id/text_view_generate"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:textColor="#69FF0000"
                android:textSize="25sp" />
        </LinearLayout>
    </ScrollView>

</android.support.v4.widget.SwipeRefreshLayout>

xml佈局程式碼如上所示，在引入SwipeRefreshLayout控制元件時，需要寫全限定類名；另外需要注意的是，該控制元件只能巢狀一個直接子控制元件，而且這個子控制元件必須是具有滑動功能的AdapterView(如ListView，Spinner，GridView等)。

activity業務邏輯

public class MainActivity extends Activity {
    private SwipeRefreshLayout mSwipeRefreshLayout;
    private TextView mTextView;

    private Handler mHandler;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mTextView = (TextView) findViewById(R.id.text_view_generate);
        mHandler = new Handler();
        mSwipeRefreshLayout = (SwipeRefreshLayout) findViewById(R.id.swipe_refresh);

        mSwipeRefreshLayout.setOnRefreshListener(new OnRefreshListener() {

            @Override
            public void onRefresh() {
                // TODO Auto-generated method stub
                // 產生一個重新整理效果的動畫
                mSwipeRefreshLayout.setRefreshing(true);
                mHandler.postDelayed(new Runnable() {

                    @Override
                    public void run() {
                        // TODO Auto-generated method stub
                        // 三秒後停止重新整理動畫
                        mSwipeRefreshLayout.setRefreshing(false);
                        // 產生1-100隨機整數
                        int i = (int) (Math.random() * 100 + 1);
                        mTextView.setText(String.valueOf(i));
                    }
                }, 3000);
            }
        });
    }
}

activity程式碼如上所示，首先宣告SwipeRefreshLayout控制元件並繫結setOnRefreshListener監聽器，引數是一個OnRefreshListener型別的介面物件，需要實現介面中未實現的方法onRefresh，在該方法中首先呼叫SwipeRefreshLayout的方法setRefreshing(true)方法，表示開啟動畫效果，接著在Handler的postDelay方法中傳入兩個引數，第一個引數是一個匿名Runnable介面物件，第二個引數是一個int型別整數，本demo中傳入3000，代表3秒，該方法表示動畫顯示的持續時長，然後在run方法中關閉動畫效果，並進行相應的UI操作。

系統自帶的原生下拉重新整理控制元件SwipeRefreshLayout的優點是比較簡潔，沒有過多花哨的動畫效果，android版chrome瀏覽器的下拉重新整理功能便使用的該控制元件(chrome是我最喜歡的android瀏覽器)，然而缺點也顯而易見，那就是擴充套件性不夠好，對於現今這個APP也看臉的時代，沒有炫酷的動畫已經很難滿足使用者的需要，另外，該控制元件不支援上拉重新整理，如果打算實現上拉重新整理和更多動畫效果，需要下面介紹的第三方控制元件。

第三方控制元件PullToRefresh介紹

PullToRefresh是一個開源控制元件，不僅支援下拉重新整理，還支援上拉重新整理，而且可以利用重新整理時的動畫效果為使用者提供有用資訊(如重新整理時間，手勢操作提示等)，很多商業級別的應用已經才用了這個控制元件，該控制元件有以下特點：

• 支援上拉重新整理、下拉重新整理或同時支援上拉重新整理和下拉重新整理；
• 支援所有裝置的動畫滑動；
• Android2.3版本以上支援整屏下拉(上拉)；
• 支援下列控制元件作為直接子控制元件
  -ListView
  -ExpandableListView
  -GridView
  -WebView
  -ScrollView
  -HorizontalScrollView
  -ViewPager
• 當滑到底部時可以彈出資訊提示；
• 支援Maven；
• 當某個頁面具有下拉重新整理(上拉重新整理)的功能時，給提示使用者；
• 許多自定義屬性；
• 支援ListFragment。

PullToRefresh效果

先看看該控制元件包含一個ListView的效果：

向下拉動，顯示”放開以重新整理”的提示和上次重新整理的時間，左邊顯式圓形箭頭圖示

鬆手後，顯示”正在載入…”，左側的圓形箭頭按鈕不斷轉動

重新整理完畢後，ListView在第一行增加一條內容”Added after refresh…”

當滑到底部時，Toast出”End of List!”

PullToRefresh的xml佈局

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

<!--     The PullToRefreshListView replaces a standard ListView widget. -->

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        android:id="@+id/pull_refresh_list"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:cacheColorHint="#00000000"
        android:divider="#19000000"
        android:dividerHeight="4dp"
        android:fadingEdge="none"
        android:fastScrollEnabled="false"
        android:footerDividersEnabled="false"
        android:headerDividersEnabled="false"
        android:smoothScrollbar="true" />

</LinearLayout>

xml佈局控制元件做了封裝，控制元件com.handmark.pulltorefresh.library.PullToRefreshListView裡面含有一個ListView。

PullToRefresh的activity

public final class PullToRefreshListActivity extends ListActivity {

    static final int MENU_MANUAL_REFRESH = 0;
    static final int MENU_DISABLE_SCROLL = 1;
    static final int MENU_SET_MODE = 2;
    static final int MENU_DEMO = 3;

    private LinkedList<String> mListItems;
    private PullToRefreshListView mPullRefreshListView;
    private ArrayAdapter<String> mAdapter;

    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_ptr_list);

        mPullRefreshListView = (PullToRefreshListView) findViewById(R.id.pull_refresh_list);

        // Set a listener to be invoked when the list should be refreshed.
        mPullRefreshListView.setOnRefreshListener(new OnRefreshListener<ListView>() {
            @Override
            public void onRefresh(PullToRefreshBase<ListView> refreshView) {
                String label = DateUtils.formatDateTime(getApplicationContext(), System.currentTimeMillis(),
                        DateUtils.FORMAT_SHOW_TIME | DateUtils.FORMAT_SHOW_DATE | DateUtils.FORMAT_ABBREV_ALL);

                // Update the LastUpdatedLabel
                refreshView.getLoadingLayoutProxy().setLastUpdatedLabel(label);

                // Do work to refresh the list here.
                new GetDataTask().execute();
            }
        });

        // Add an end-of-list listener
        mPullRefreshListView.setOnLastItemVisibleListener(new OnLastItemVisibleListener() {

            @Override
            public void onLastItemVisible() {
                Toast.makeText(PullToRefreshListActivity.this, "End of List!", Toast.LENGTH_SHORT).show();
            }
        });

        ListView actualListView = mPullRefreshListView.getRefreshableView();

        // Need to use the Actual ListView when registering for Context Menu
        registerForContextMenu(actualListView);

        mListItems = new LinkedList<String>();
        mListItems.addAll(Arrays.asList(mStrings));

        mAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, mListItems);


        mPullRefreshListView.setOnPullEventListener(soundListener);

        // You can also just use setListAdapter(mAdapter) or
        // mPullRefreshListView.setAdapter(mAdapter)
        actualListView.setAdapter(mAdapter);
    }

    private class GetDataTask extends AsyncTask<Void, Void, String[]> {

        @Override
        protected String[] doInBackground(Void... params) {
            // Simulates a background job.
            try {
                Thread.sleep(4000);
            } catch (InterruptedException e) {
            }
            return mStrings;
        }

        @Override
        protected void onPostExecute(String[] result) {
            mListItems.addFirst("Added after refresh...");
            mAdapter.notifyDataSetChanged();

            // Call onRefreshComplete when the list has been refreshed.
            mPullRefreshListView.onRefreshComplete();

            super.onPostExecute(result);
        }
    }



    private String[] mStrings = { "Abbaye de Belloc", "Abbaye du Mont des Cats", "Abertam", "Abondance", "Ackawi",
            "Acorn", "Adelost", "Affidelice au Chablis", "Afuega'l Pitu", "Airag", "Airedale", "Aisy Cendre",
            "Allgauer Emmentaler", "Abbaye de Belloc", "Abbaye du Mont des Cats", "Abertam", "Abondance", "Ackawi",
            "Acorn", "Adelost", "Affidelice au Chablis", "Afuega'l Pitu", "Airag", "Airedale", "Aisy Cendre",
            "Allgauer Emmentaler" };
}

首先為PullToRefresh控制元件繫結監聽器setOnRefreshListener，引數是匿名介面OnRefreshListener物件，注意，若希望同時實現上拉重新整理和下拉重新整理，需實現匿名介面OnRefreshListener2；在onRefresh方法中首先設定了顯示重新整理的時間，然後執行非同步任務AsyncTask，在onPostExecute方法中為ListView增加一行，並通知Adapter重新整理頁面，最後呼叫onRefreshComplete方法完成重新整理；繫結setOnLastItemVisibleListener監聽器用於監聽ListView滑到底部時的情況。

利用PullToRefresh實現自定義demo

利用PullToRefresh控制元件，實現了每次下拉重新整理(或上拉重新整理)後，生成一組雙色球號碼的demo。
效果如下所示：

向下拉動，顯示文字提示”放開以重新整理” 左側有Android機器人圖示轉動

鬆開手，顯示”正在載入…”，左側Android機器人圖示轉動

重新整理完成，生成一組雙色球隨機號碼

向上拉動，底部提示”放開以重新整理”，左側Android機器人圖示轉動

鬆開手，顯示”正在載入…”，左側Android機器人圖示轉動

重新整理完成，生成第二組雙色球隨機號碼

xml佈局

<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="${relativePackage}.${activityClass}" >

    <com.handmark.pulltorefresh.library.PullToRefreshListView
        xmlns:ptr="http://schemas.android.com/apk/res-auto"
        android:id="@+id/pull_refresh_list"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:cacheColorHint="#00000000"
        android:divider="#19000000"
        android:dividerHeight="4dp"
        android:fadingEdge="none"
        android:fastScrollEnabled="false"
        android:footerDividersEnabled="false"
        android:headerDividersEnabled="false"
        android:smoothScrollbar="true"
        ptr:ptrMode="both"
        ptr:ptrDrawable="@drawable/ic_launcher" />

</RelativeLayout>

注意要引用控制元件的全限定類名com.handmark.pulltorefresh.library.PullToRefreshListView。

activity業務邏輯

public class MainActivity extends Activity {
    private PullToRefreshListView mPullToRefresh;
    private ArrayAdapter<String> mArrayAdapter;
    private List<String> mList;
    private ListView mListView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mList = new ArrayList<String>();

        mArrayAdapter = new ArrayAdapter<String>(this,
                android.R.layout.simple_list_item_1, mList);

        mPullToRefresh = (PullToRefreshListView) findViewById(R.id.pull_refresh_list);
        mListView = mPullToRefresh.getRefreshableView();
        mListView.setAdapter(mArrayAdapter);
        // 同時實現上拉重新整理和下拉重新整理
        mPullToRefresh.setOnRefreshListener(new OnRefreshListener2() {

            // 實現下拉重新整理
            @Override
            public void onPullDownToRefresh(PullToRefreshBase refreshView) {
                // TODO Auto-generated method stub
                new GetDataTask().execute();

            }

            // 實現下拉重新整理
            @Override
            public void onPullUpToRefresh(PullToRefreshBase refreshView) {
                // TODO Auto-generated method stub
                new GetDataTask().execute();

            }
        });
    }

    private class GetDataTask extends AsyncTask<Void, Void, String> {

        @Override
        protected String doInBackground(Void... params) {
            // Simulates a background job.
            try {
                Thread.sleep(2000);
            } catch (InterruptedException e) {
            }
            return generateData();
        }

        @Override
        protected void onPostExecute(String result) {
            mList.add(result);

            mArrayAdapter.notifyDataSetChanged();

            // Call onRefreshComplete when the list has been refreshed.
            mPullToRefresh.onRefreshComplete();

            super.onPostExecute(result);
        }

        // 生成ListView中的一行資料
        private String generateData()

        {
            Set<String> treeSet = new TreeSet<String>();
            do {
                treeSet.add(generateARedBall());

            } while (treeSet.size() <= 6);
            String[] _string = new String[6];
            _string = treeSet.toArray(_string);
            StringBuilder _stringBuilder = new StringBuilder();
            _stringBuilder.append("【第" + (mList.size() + 1) + "組】紅：");
            for (int _i = 0; _i < 6; _i++) {
                _stringBuilder.append(_string[_i]);
                _stringBuilder.append(", ");
            }
            _stringBuilder = _stringBuilder.delete(_stringBuilder.length() - 2,
                    _stringBuilder.length() - 1);

            _stringBuilder.append("藍：" + generateABlueBall());
            return _stringBuilder.toString();
        }

        // 生成一組紅色球號碼
        private String generateARedBall() {
            // TODO Auto-generated method stub
            int i = (int) (Math.random() * 99 + 1);
            if (i < 10) {
                return "0" + String.valueOf(i);
            } else {
                return String.valueOf(i);
            }

        }

        // 生成一個藍色球號碼
        private String generateABlueBall() {
            // TODO Auto-generated method stub
            int i = (int) (Math.random() * 16 + 1);
            if (i < 10) {
                return "0" + String.valueOf(i);
            } else {
                return String.valueOf(i);
            }

        }

    }

}

程式碼實現了上述圖片所示效果，該程式通過匿名介面OnRefreshListener2物件實現了上拉重新整理和下拉重新整理兩種手勢操作，生成雙色球隨機數。