Android之ListView滚动到底后自动加载数据

jopen 10年前

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

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

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

Android之ListView滚动到底后自动加载数据  Android之ListView滚动到底后自动加载数据

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

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

    <?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>  
</div> </div> 这里我们引用了Android内置的名为list的id,因为我们后面要使用到ListActivity,我们的MainActivity继承于它。

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

    <?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>  
</div> </div>

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

    <?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>  
</div> </div>

接下来我们来了解一下我们的Adapter,ListViewAdapter代码如下:

    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);            }        }  
</div> </div>

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

最后我们来看一下MainActivity:

    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));                }            }        }  
</div> </div>

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

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

Android之ListView滚动到底后自动加载数据  Android之ListView滚动到底后自动加载数据

如图,当点击完按钮后,出现加载动作,加载完之后如右图所示,新数据紧接在原数据之后。然后我们滑动到底部,加载按钮仍可工作:

Android之ListView滚动到底后自动加载数据

最后,我们测试一下滑动列表到底部,然后松开,控制台打印如下:

Android之ListView滚动到底后自动加载数据