Android中ListView分页加载数据

关注

转载最新推荐文章于 2026-03-07 00:08:32 发布 683 阅读 AI 写同款· GEO 优化 ›

Android端使用200行代码实现的分页加载 --- PageHelper 在项目初期，为了统一管理列表的分页加载逻辑，于是写了一个BaseRvActivity/BaseRvFragment去实现。后来随着项目的不断庞大，渐渐地往里面增加了单选/多选，筛选条件配置等等其他的逻辑，甚至于还加入了一些业务相关的逻辑代码，并且还继承于这两个文件实现了几个扩展后的BaseXxActivity/BaseXxFragment，导致某些页面的Activity变成了BaseActivity的第N代子孙，继承关系就成了这样。这是我们想看到的吗？不，并不是。在这样的情境下，突然想到了最近在学习。阅读详情

熟悉Android的朋友们都知道，不管是微博客户端还是新闻客户端，都离不开列表组件，可以说列表组件是Android数据展现方面最重要的组件，我们今天就要讲一讲列表组件ListView加载数据的相关内容。通常来说，一个应用在展现大量数据时，不会将全部的可用数据都呈现给用户，因为这不管对于服务端还是客户端来说都是不小的压力，因此，很多应用都是采用分批次加载的形式来获取用户所需的数据。比如：微博客户端可能会在用户滑动至列表底端时自动加载下一页数据，也可能在底部放置一个“加载更多”按钮，用户点击后，加载下一页数据。

我们今天就结合实例来演示一下使用ListView获取数据的过程。

新建一个loadmore项目，我们来看一下结构图和最终效果图：

左图中包含了三个布局文件、一个Adapter和一个Activity，右图是我们运行后的主界面。

其中，main.xml是主界面的布局文件，它包含一个ListView组件，代码如下：

[html]view plaincopy 
   
 <?xml version="1.0" encoding="utf-8"?>  
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
     android:orientation="vertical"  
     android:layout_width="fill_parent"  
     android:layout_height="fill_parent"  
     android:paddingLeft="3dp"  
     android:paddingRight="3dp">  
     <ListView  
         android:id="@id/android:list"  
         android:layout_width="fill_parent"  
         android:layout_height="wrap_content"/>  
 </LinearLayout>  

这里我们引用了Android内置的名为list的id，因为我们后面要使用到ListActivity，我们的MainActivity继承于它。

然后就是list_item.xml，它是ListView中单个列表项的布局文件，从效果图中可以看到，这里只使用到了一个TextView组件，list_item.xml代码如下：

[html]view plaincopy 
   
 <?xml version="1.0" encoding="utf-8"?>  
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
     android:orientation="vertical"  
     android:layout_width="fill_parent"  
     android:layout_height="fill_parent">  
     <TextView  
         android:id="@+id/list_item_text"  
         android:layout_width="fill_parent"  
         android:layout_height="fill_parent"  
         android:gravity="center"  
         android:textSize="20sp"  
         android:paddingTop="10dp"  
         android:paddingBottom="10dp"/>  
 </LinearLayout>  

我们注意到在右图中列表底部有一个按钮不同于其他的列表项，这是什么情况？事实上这个按钮是我们在ListView底部添加的一个视图。ListView组件提供了两个很实用的功能，那就是可以在顶部和底部添加自定义的视图。我们在此处ListView的底部添加了一个视图用来加载更多数据，这个视图对应着load_more.xml布局文件，代码如下：

[html]view plaincopy 
   
 <?xml version="1.0" encoding="utf-8"?>  
 <LinearLayout  
   xmlns:android="http://schemas.android.com/apk/res/android"  
   android:orientation="vertical"  
   android:layout_width="fill_parent"  
   android:layout_height="wrap_content">  
   <Button  
         android:id="@+id/loadMoreButton"  
         android:layout_width="fill_parent"  
         android:layout_height="wrap_content"  
         android:text="load more"  
         android:onClick="loadMore"/>  
 </LinearLayout>  

接下来我们来了解一下我们的Adapter，ListViewAdapter代码如下：

[java]view plaincopy 
   
 package com.scott.loadmore;  
   
 import java.util.List;  
   
 import android.content.Context;  
 import android.view.LayoutInflater;  
 import android.view.View;  
 import android.view.ViewGroup;  
 import android.widget.BaseAdapter;  
 import android.widget.TextView;  
   
 public class ListViewAdapter extends BaseAdapter {  
     private List<String> items;  
     private LayoutInflater inflater;  
       
     public ListViewAdapter(Context context, List<String> items) {  
         this.items = items;  
         inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);        
     }  
       
     @Override  
     public int getCount() {  
         return items.size();  
     }  
   
     @Override  
     public Object getItem(int position) {  
         return items.get(position);  
     }  
   
     @Override  
     public long getItemId(int position) {  
         return position;  
     }  
   
     @Override  
     public View getView(int position, View view, ViewGroup parent) {  
         if (view == null) {  
             view = inflater.inflate(R.layout.list_item, null);  
         }  
         TextView text = (TextView) view.findViewById(R.id.list_item_text);  
         text.setText(items.get(position));  
         return view;  
     }  
       
     /** 
      * 添加列表项 
      * @param item 
      */  
     public void addItem(String item) {  
         items.add(item);  
     }  
 }  

这个ListViewAdapter是我们自定义适配器，它继承自BaseAdapter，实例化此适配器需要一个Context对象来获取LayoutInflater实例和一个集合对象来充当适配器的数据集；在getView方法中我们填充list_item.xml布局文件，完成列表每一项的数据显示；addItem方法用来在加载数据时向数据集中添加新数据。

最后我们来看一下MainActivity：

[java]view plaincopy 
   
 package com.scott.loadmore;  
   
 import java.util.ArrayList;  
   
 import android.app.ListActivity;  
 import android.os.Bundle;  
 import android.os.Handler;  
 import android.util.Log;  
 import android.view.View;  
 import android.widget.AbsListView;  
 import android.widget.AbsListView.OnScrollListener;  
 import android.widget.Button;  
 import android.widget.ListView;  
   
 public class MainActivity extends ListActivity implements OnScrollListener {  
     private ListView listView;  
     private int visibleLastIndex = 0;   //最后的可视项索引  
     private int visibleItemCount;       // 当前窗口可见项总数  
     private ListViewAdapter adapter;  
     private View loadMoreView;  
     private Button loadMoreButton;  
     private Handler handler = new Handler();  
   
     @Override  
     public void onCreate(Bundle savedInstanceState) {  
         super.onCreate(savedInstanceState);  
         setContentView(R.layout.main);  
           
         loadMoreView = getLayoutInflater().inflate(R.layout.load_more, null);  
         loadMoreButton = (Button) loadMoreView.findViewById(R.id.loadMoreButton);  
   
         listView = getListView();               //获取id是list的ListView  
           
         listView.addFooterView(loadMoreView);   //设置列表底部视图  
   
         initAdapter();  
           
         setListAdapter(adapter);                //自动为id是list的ListView设置适配器  
           
         listView.setOnScrollListener(this);     //添加滑动监听  
     }  
       
     /** 
      * 初始化适配器 
      */  
     private void initAdapter() {  
         ArrayList<String> items = new ArrayList<String>();  
         for (int i = 0; i < 10; i++) {  
             items.add(String.valueOf(i + 1));  
         }  
         adapter = new ListViewAdapter(this, items);  
     }  
   
     /** 
      * 滑动时被调用 
      */  
     @Override  
     public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {  
         this.visibleItemCount = visibleItemCount;  
         visibleLastIndex = firstVisibleItem + visibleItemCount - 1;  
     }  
   
     /** 
      * 滑动状态改变时被调用 
      */  
     @Override  
     public void onScrollStateChanged(AbsListView view, int scrollState) {  
         int itemsLastIndex = adapter.getCount() - 1;    //数据集最后一项的索引  
         int lastIndex = itemsLastIndex + 1;             //加上底部的loadMoreView项  
         if (scrollState == OnScrollListener.SCROLL_STATE_IDLE && visibleLastIndex == lastIndex) {  
             //如果是自动加载,可以在这里放置异步加载数据的代码  
             Log.i("LOADMORE", "loading...");  
         }  
     }  
       
     /** 
      * 点击按钮事件 
      * @param view 
      */  
     public void loadMore(View view) {  
         loadMoreButton.setText("loading...");   //设置按钮文字loading  
         handler.postDelayed(new Runnable() {  
             @Override  
             public void run() {  
                   
                 loadData();  
                   
                 adapter.notifyDataSetChanged(); //数据集变化后,通知adapter  
                 listView.setSelection(visibleLastIndex - visibleItemCount + 1); //设置选中项  
                   
                 loadMoreButton.setText("load more");    //恢复按钮文字  
             }  
         }, 2000);  
     }  
       
     /** 
      * 模拟加载数据 
      */  
     private void loadData() {  
         int count = adapter.getCount();  
         for (int i = count; i < count + 10; i++) {  
             adapter.addItem(String.valueOf(i + 1));  
         }  
     }  
 }  

如代码所示，我们在onCreate方法被调用时获取listView组件，设置其底部视图为loadMoreView，它包含一个按钮，点击时会触发loadMore方法调用，另外在为listView设置完适配器时，又为其设置了滑动事件监听器，滑动列表时onScroll会被调用，滑动状态改变时onScrollStateChanged会被调用。

我们来演示一下这个加载过程：