Android应用中ListView利用OnScrollListener分页加载数据

当用户从网络上读取微薄的时候，如果一下子全部加载用户未读的微薄这将耗费比较长的时间，造成不好的用户体验，同时一屏的内容也不足以显示如此多的内容。这时候，我们就需要用到另一个功能，那就是listview的分页了。通过分页分次加载数据，用户看多少就去加载多少。

通常这也分为两种方式，一种是设置一个按钮，用户点击即加载。另一种是当用户滑动到底部时自动加载。今天我就和大家分享一下这个功能的实现。

首先，写一个xml文件，moredata.xml，该文件即定义了放在listview底部的视图：

<?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" >
<Button  
  android:id="@+id/bt_load"  
  android:layout_width="fill_parent"  
  android:layout_height="wrap_content"
  android:text="加载更多数据" />
<ProgressBar
  android:id="@+id/pg"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:layout_gravity="center_horizontal"
  android:visibility="gone"
  />
</LinearLayout>

可以看到是一个按钮和一个进度条。因为只做一个演示，这里简单处理，通过设置控件的visibility，未加载时显示按钮，加载时就显示进度条。

写一个item.xml，大家应该很熟悉了。用来定义listview的每个item的视图。

<?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" >

<TextView
   android:id="@+id/tv_title"
   android:textSize="20sp"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_marginTop="5dp"
   />
 <TextView
   android:textSize="12sp"
   android:id="@+id/tv_content"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_marginTop="5dp"
   />

</LinearLayout>

main.xml就不贴了，整个主界面就一个listview。

直接先看下Activity的代码，在里面实现分页效果。

package com.notice.moredate;

import java.util.ArrayList;
import java.util.HashMap;

import android.app.Activity;
import android.os.Bundle;
import android.os.Handler;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.AbsListView;
import android.widget.AbsListView.OnScrollListener;
import android.widget.Button;
import android.widget.ListView;
import android.widget.ProgressBar;
import android.widget.SimpleAdapter;
import android.widget.Toast;

public class MoreDateListActivity extends Activity implements OnScrollListener {

// ListView的Adapter
 private SimpleAdapter mSimpleAdapter;
 private ListView lv;
 private Button bt;
 private ProgressBar pg;
 private ArrayList<HashMap<String,String>> list;
 // ListView底部View
 private View moreView;
 private Handler handler;
 // 设置一个最大的数据条数，超过即不再加载
 private int MaxDateNum;
 // 最后可见条目的索引
 private int lastVisibleIndex;

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

MaxDateNum = 22; // 设置最大数据条数

lv = (ListView) findViewById(R.id.lv);

// 实例化底部布局
   moreView = getLayoutInflater().inflate(R.layout.moredate, null);

bt = (Button) moreView.findViewById(R.id.bt_load);
   pg = (ProgressBar) moreView.findViewById(R.id.pg);
   handler = new Handler();

// 用map来装载数据，初始化10条数据
   list = new ArrayList<HashMap<String,String>>();
   for (int i = 0; i < 10; i++) {
     HashMap<String, String> map = new HashMap<String, String>();
     map.put("ItemTitle", "第" + i + "行标题");
     map.put("ItemText", "第" + i + "行内容");
     list.add(map);
   }
   // 实例化SimpleAdapter
   mSimpleAdapter = new SimpleAdapter(this, list, R.layout.item,
       new String[] { "ItemTitle", "ItemText" },
       new int[] { R.id.tv_title, R.id.tv_content });
   // 加上底部View，注意要放在setAdapter方法前
   lv.addFooterView(moreView);
   lv.setAdapter(mSimpleAdapter);
   // 绑定 *
   lv.setOnScrollListener(this);

bt.setOnClickListener(new OnClickListener() {

@Override
     public void onClick(View v) {
       pg.setVisibility(View.VISIBLE);// 将进度条可见
       bt.setVisibility(View.GONE);// 按钮不可见

handler.postDelayed(new Runnable() {

@Override
         public void run() {
           loadMoreDate();// 加载更多数据
           bt.setVisibility(View.VISIBLE);
           pg.setVisibility(View.GONE);
           mSimpleAdapter.notifyDataSetChanged();// 通知listView刷新数据
         }

}, 2000);
     }
   });

}

private void loadMoreDate() {
   int count = mSimpleAdapter.getCount();
   if (count + 5 < MaxDateNum) {
     // 每次加载5条
     for (int i = count; i < count + 5; i++) {
       HashMap<String, String> map = new HashMap<String, String>();
       map.put("ItemTitle", "新增第" + i + "行标题");
       map.put("ItemText", "新增第" + i + "行内容");
       list.add(map);
     }
   } else {
     // 数据已经不足5条
     for (int i = count; i < MaxDateNum; i++) {
       HashMap<String, String> map = new HashMap<String, String>();
       map.put("ItemTitle", "新增第" + i + "行标题");
       map.put("ItemText", "新增第" + i + "行内容");
       list.add(map);
     }
   }

}

@Override
 public void onScroll(AbsListView view, int firstVisibleItem,
     int visibleItemCount, int totalItemCount) {
   // 计算最后可见条目的索引
   lastVisibleIndex = firstVisibleItem + visibleItemCount - 1;

// 所有的条目已经和最大条数相等，则移除底部的View
   if (totalItemCount == MaxDateNum + 1) {
     lv.removeFooterView(moreView);
     Toast.makeText(this, "数据全部加载完成，没有更多数据！", Toast.LENGTH_LONG).show();
   }

}

@Override
 public void onScrollStateChanged(AbsListView view, int scrollState) {
   // 滑到底部后自动加载，判断listview已经停止滚动并且最后可视的条目等于adapter的条目
   if (scrollState == OnScrollListener.SCROLL_STATE_IDLE
       && lastVisibleIndex == mSimpleAdapter.getCount()) {
     // 当滑到底部时自动加载
     // pg.setVisibility(View.VISIBLE);
     // bt.setVisibility(View.GONE);
     // handler.postDelayed(new Runnable() {
     //
     // @Override
     // public void run() {
     // loadMoreDate();
     // bt.setVisibility(View.VISIBLE);
     // pg.setVisibility(View.GONE);
     // mSimpleAdapter.notifyDataSetChanged();
     // }
     //
     // }, 2000);

}

}

}

通过注释，大家应该很容易理解了。这里做下简单的解析。首先要注意的是，addFootView方法一定要在setAdapter方法之前，否则会无效。addFootView方法为listview底部加入一个视图，在本例中就是那个Button加progressbar的视图。当用户点击按钮时，调用loadmoreDate方法，为listview绑定更多的数据，通过adapter的notifyDataSetChanged方法通知listview刷新，显示刚加入的数据。

这里用handler异步延迟2秒操作，模仿加载过程。同时listview绑定了onScrollListener * ，并且实现了onScroll和onScrollStateChanged方法。在后者方法中，我们通过判断listview已经停止滚动并且最后可视的条目等于adapter的条目，可以知道用户已经滑动到底部并且自动加载，代码中将这部分代码注释掉了，大家可以自己试下。

代码中还加入了一个MaxDateNum变量，用来记录最大的数据数量。也就是说网络或者其他地方一共的数据。通过onScroll方法判断用户加载完这些数据后，移除listview底部视图，不让继续加载。同时在loadmoreDate方法中也对最大数据量做相应的操作来判断加载数量。（默认加载5条，不足5条时加载剩余的）。

看下效果图：

关于OnScrollListener事件顺序次数的简要分析
在 Android 的 OnScrollListener 整个事件我主要分析下他的执行顺序：
实现滚动事件的监听接口

new AbsListView.OnScrollListener(){
 @Override
 public void onScrollStateChanged(AbsListView absListView, int scrollState)
 {
   switch (scrollState) {
     case AbsListView.OnScrollListener.SCROLL_STATE_TOUCH_SCROLL:
       // 手指触屏拉动准备滚动，只触发一次    顺序: 2
       break;
     case AbsListView.OnScrollListener.SCROLL_STATE_FLING:
       // 持续滚动开始，只触发一次        顺序: 4
       break;
     case AbsListView.OnScrollListener.SCROLL_STATE_IDLE:
       // 整个滚动事件结束，只触发一次      顺序: 6
       break;
     default:
       break;
   }
 }

@Override
 public void onScroll(AbsListView absListView, int i, int i1, int i2)
 {
   // 一直在滚动中，多次触发             顺序: 1、3、5
 }
}

之前一直很迷糊，后来仔细测试后得出上面代码注释中的结论。
另外对于 ListView 图片列表的滚动，应该在SCROLL_STATE_FLING时让图片不显示，提高滚动性能让滚动更平滑，SCROLL_STATE_IDLE时显示当前屏幕可见的图片，对于onScroll()接口方法基本上不用他。
补充：
1. 当手指只轻触屏幕不拉动只会触发一次onScroll方法，不会触发其他滚动事件；
2. 如果手指触碰屏幕后停滞一下再滑动则首先执行一次onScroll方法 然后才是SCROLL_STATE_TOUCH_SCROLL事件；
3. 如果手指碰到屏幕后直接滑动则第一次就执行SCROLL_STATE_TOUCH_SCROLL事件；
3. 触发SCROLL_STATE_TOUCH_SCROLL事件后还会继续多次触发onScroll事件，而不是直接触发SCROLL_STATE_FLING事件；
4. 滚动后不一定会触发 SCROLL_STATE_FLING事件，可能和手指滑动的距离有关系；
5. 滚动的过程中会多次调用onScroll方法；
6. 除了onScroll触发多次，其他事件在整个过程中只会触发一次。