瀑布流ListView

前言　　

　　终于忙完了一段时间，现在前段时间写的一个瀑布流ListView到想法分享下，这个东西是扩展自Listview，当列表内容拉到最后后触发刷新操作，以便抓取更多到数据。

先贴下整个代码，先有个整体到概念，然后再进一步细聊。代码如下

 package cn.bitlove.waterfalllistview.widget;

 import cn.bitlove.waterfalllistview.R;
 import android.content.Context;
 import android.util.AttributeSet;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.AbsListView;
 import android.widget.FrameLayout;
 import android.widget.AbsListView.OnScrollListener;
 import android.widget.ListView;

 /**
  * 瀑布流Listview
  * */
 public class WaterfallListview extends ListView implements OnScrollListener {

     final private String tag="WaterfallListView";
     private Context mContext;
     private LayoutInflater mInflater;
     final int REFRESH_IDEL=0;        //空闲中
     final int REFRESH_PREPARE=1;    //准备刷新
     final int REFRESH_ING=2;        //刷新中
     final int REFRESH_End=3;        //刷新完成
     private int mRefreshState = REFRESH_IDEL;        //刷新状态
     private int mScrollState;        //滚动状态

     private FrameLayout mFooterLayout;    //ListView 的footer
     private View mListFoot;        //底部刷新区域

     private IOnRefresh mRefreshListener = null;    //刷新监听器
     public WaterfallListview(Context context) {
         super(context);
     }
     public  WaterfallListview(Context context, AttributeSet attrs) {
         super(context,attrs);
         init();
     }
     @Override
     public void onScrollStateChanged(AbsListView view, int scrollState) {
         mScrollState = scrollState;
     }

     @Override
     public void onScroll(AbsListView view, int firstVisibleItem,
             int visibleItemCount, int totalItemCount) {
         if(totalItemCount==0 || mScrollState==SCROLL_STATE_IDLE){
             return;
         }
         //最后一个item
         int lastItemCount = firstVisibleItem+visibleItemCount;
         if(lastItemCount==totalItemCount && mRefreshState==REFRESH_IDEL){
             prepareRefresh();
             doRefresh();
         }
     }

     private void init(){
         mContext = getContext();
         mInflater = (LayoutInflater) mContext.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
         initFooter();
         setOnScrollListener(this);
     }
     /**
      * 设置刷新器
      * */
     public void setRefreshListener(IOnRefresh refresher){
         mRefreshListener = refresher;
     }

     /**
      * 初始化底部刷新内容
      * */
     private void initFooter(){
         mListFoot = mInflater.inflate(R.layout.foot_waterfall_listview, null);
         mFooterLayout = new FrameLayout(mContext);
         addFooterView(mFooterLayout);
     }
     /**
      * 准备刷新
      * */
     private void prepareRefresh(){
         //Log.i(tag,"prepareRefresh");
         mRefreshState = REFRESH_PREPARE;
         ViewGroup vg = (ViewGroup) mListFoot.getParent();
         if(vg!=null){
             vg.removeView(mListFoot);
         }

         mFooterLayout.addView(mListFoot);

         if(mRefreshListener!=null){
             mRefreshListener.beforeRefresh();
         }
     }
     /**
      * 执行刷新
      * */
     private void doRefresh(){
         //Log.i(tag,"doRefresh");
         mRefreshState=REFRESH_ING;

         if(mRefreshListener!=null){
             mRefreshListener.doRefresh();
         }

     }
     /**
      * 完成刷新
      * */
     public void completeRefresh(){
         mRefreshState = REFRESH_IDEL;
         mFooterLayout.removeAllViews();
     }

     public interface IOnRefresh{
         public void beforeRefresh();
         /**
          * 执行完doRefresh操作后，必须调用completeRefresh方法来清理刷新状态
          * */
         public void doRefresh();
     }
 }

底部视图　　

　　为了完成滑动到底部后触发刷新事件，为此给Listview增加了一个底部view，代码如下

 <?xml version="1.0" encoding="utf-8"?>
 <!-- waterfallListview 底部刷新区域 -->
 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     >

 <TextView
     android:layout_height="40dp"
     android:layout_width="match_parent"
     android:text="加载更多数据..."
     android:gravity="center"
     />
 </RelativeLayout>

很简单，只是用来展示一个获取状态。

接口

　　 除此之外，还增加了一个内部接口，IOnRefresh,表示相关事件，代码如下所示

 public interface IOnRefresh{
         public void beforeRefresh();
         /**
          * 执行完doRefresh操作后，必须调用completeRefresh方法来清理刷新状态
          * */
         public void doRefresh();
 }

这两个方法的含义根据名字来看就很清楚了，beforeRefresh，在刷新之前调用，让client有机会做一些事情；doRefresh，真正执行刷新到部分，另外需要注意到时候，当执行完刷新到时候，要掉用下widget的completeRefresh方法来清理刷新状态，标示真正执行完了刷新操作

completeRefresh方法

很简单到一个方法，有两个主要功能，一是置状态，二是取消listview底部的view，代码如下

 public void completeRefresh(){
         mRefreshState = REFRESH_IDEL;
         mFooterLayout.removeAllViews();
 }

设计思路

　　大体到内容就是以上那些，下面来看下实现的思路。
　　为了完成这个功能，增加了一个刷新状态mRefreshState,这个状态用来表示当前控件所处到刷新状态，以便在不同状态下做不同到处理，其有以下四个状态

final int REFRESH_IDEL=0;        //空闲中
final int REFRESH_PREPARE=1;    //准备刷新
final int REFRESH_ING=2;        //刷新中
final int REFRESH_End=3;        //刷新完成

然后整个widget到逻辑就是控制这四个状态，然后在不同到状态执行不同到操作，比如在执行beforeRefresh函数时，此时状态处于REFRESH_PREPARE，
当执行doRefresh时状态处于REFRESH_ING，当我们调用completeRefresh后，状态改为REFRESH_IDEL，其实当初设计的时候还希望有一个REFRESH_End状态，但是实现过程中没有发现此状态的用处，暂时为保留状态，以便以后扩充用。

控制状态

控制状态，主要是在onScroll函数中操作的，代码如下

 @Override
     public void onScroll(AbsListView view, int firstVisibleItem,
             int visibleItemCount, int totalItemCount) {
         if(totalItemCount==0 || mScrollState==SCROLL_STATE_IDLE){
             return;
         }
         //最后一个item
         int lastItemCount = firstVisibleItem+visibleItemCount;
         if(lastItemCount==totalItemCount && mRefreshState==REFRESH_IDEL){
             prepareRefresh();
             doRefresh();
         }
     }

主要实现思路就是监测最后一个item是否出现。

　　好了，到此为止，主要到思路就完了。

后记

　　这个控件到Demo程序下载地址：https://github.com/xiaoai-opensource/WaterfallListview

　　有需要到朋友可以前去下载查看