原文博客地址：http://blog.csdn.net/leehong2005/article/details/12567757 （部分Bug处理请参考原文博客评论列表）

前段时间项目中用到了下拉刷新功能，之前在网上也找到过类似的demo，但这些demo的质量参差不齐，用户体验也不好，接口设计也不行。最张没办法，终于忍不了了，自己就写了一个下拉刷新的框架，这个框架是一个通用的框架，效果和设计感觉都还不错，现在分享给各位看官。

致谢：

1. 感谢lk6233160同学提出的问题，旋转View时调用setRotation方法只能是在API Level11（3.0）以上才能用，这个问题的解决办法是给ImageView设置一个Matrix，把Matrix上面作用一个旋转矩阵，但是如果不是ImageView的话，可能实现起来比较麻烦，再次谢谢lk6233160同学。

2. 谢谢如毛毛风提出的问题，向下滑动后，再向上滑动到头，只能再松手后才能再次下拉。这个问题的回复请参考评论。

技术交流群：

QQ：197990971

1. 关于下拉刷新

2. 实现原理

3. 具体实现

1、IPullToRefresh<T extends View>

[java] view plaincopy

1. public interface IPullToRefresh<T extends View> {  
2.     public void setPullRefreshEnabled(boolean pullRefreshEnabled);  
3.     public void setPullLoadEnabled(boolean pullLoadEnabled);  
4.     public void setScrollLoadEnabled(boolean scrollLoadEnabled);  
5.     public boolean isPullRefreshEnabled();  
6.     public boolean isPullLoadEnabled();  
7.     public boolean isScrollLoadEnabled();  
8.     public void setOnRefreshListener(OnRefreshListener<T> refreshListener);  
9.     public void onPullDownRefreshComplete();  
10.     public void onPullUpRefreshComplete();  
11.     public T getRefreshableView();  
12.     public LoadingLayout getHeaderLoadingLayout();  
13.     public LoadingLayout getFooterLoadingLayout();  
14.     public void setLastUpdatedLabel(CharSequence label);  
15. }  

这个接口是一个泛型的，它接受View的派生类，因为要放到我们的容器中的不就是一个View吗？

• 处理onInterceptTouchEvent()和onTouchEvent()中的事件：当内容的View（比如ListView）正如处于最顶部，此时再向下拉，我们必须截断事件，然后move事件就会把后续的事件传递到onTouchEvent()方法中，然后再在这个方法中，我们根据move的距离再进行scroll整个View。
• 负责创建Header、Footer和Content View：在构造方法中调用方法去创建这三个部分的View，派生类可以重写这些方法，以提供不同式样的Header和Footer，它会调用createHeaderLoadingLayout和createFooterLoadingLayout方法来创建Header和Footer创建Content View的方法是一个抽象方法，必须让派生类来实现，返回一个非null的View，然后容器再把这个View添加到自己里面。
• 设置各种状态：这里面有很多状态，如下拉、上拉、刷新、加载中、释放等，它会根据用户拉动的距离来更改状态，状态的改变，它也会把Header和Footer的状态改变，然后Header和Footer会根据状态去显示相应的界面式样。

[java] view plaincopy

1. /** 
2.  * 判断刷新的View是否滑动到顶部 
3.  *  
4.  * @return true表示已经滑动到顶部，否则false 
5.  */  
6. protected abstract boolean isReadyForPullDown();  
7.   
8. /** 
9.  * 判断刷新的View是否滑动到底 
10.  *  
11.  * @return true表示已经滑动到底部，否则false 
12.  */  
13. protected abstract boolean isReadyForPullUp();  

• 创建可下拉刷新的View（也就是content view）的抽象方法是

[java] view plaincopy

1. /** 
2.  * 创建可以刷新的View 
3.  *  
4.  * @param context context 
5.  * @param attrs 属性 
6.  * @return View 
7.  */  
8. protected abstract T createRefreshableView(Context context, AttributeSet attrs);  

4、LoadingLayout

4. 如何使用

[java] view plaincopy

1. @Override  
2.     public void onCreate(Bundle savedInstanceState) {  
3.         super.onCreate(savedInstanceState);  
4.           
5.         mPullListView = new PullToRefreshListView(this);  
6.         setContentView(mPullListView);  
7.           
8.         // 上拉加载不可用  
9.         mPullListView.setPullLoadEnabled(false);  
10.         // 滚动到底自动加载可用  
11.         mPullListView.setScrollLoadEnabled(true);  
12.           
13.         mCurIndex = mLoadDataCount;  
14.         mListItems = new LinkedList<String>();  
15.         mListItems.addAll(Arrays.asList(mStrings).subList(0, mCurIndex));  
16.         mAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, mListItems);  
17.           
18.         // 得到实际的ListView  
19.         mListView = mPullListView.getRefreshableView();  
20.         // 绑定数据  
21.         mListView.setAdapter(mAdapter);         
22.         // 设置下拉刷新的listener  
23.         mPullListView.setOnRefreshListener(new OnRefreshListener<ListView>() {  
24.             @Override  
25.             public void onPullDownToRefresh(PullToRefreshBase<ListView> refreshView) {  
26.                 mIsStart = true;  
27.                 new GetDataTask().execute();  
28.             }  
29.   
30.             @Override  
31.             public void onPullUpToRefresh(PullToRefreshBase<ListView> refreshView) {  
32.                 mIsStart = false;  
33.                 new GetDataTask().execute();  
34.             }  
35.         });  
36.         setLastUpdateTime();  
37.           
38.         // 自动刷新  
39.         mPullListView.doPullRefreshing(true, 500);  
40.     }  

这是初始化一个下拉刷新的布局，并且调用setContentView来设置到Activity中。

5. 运行效果

6. 源码下载

7. Bug修复

• PullToRefreshListView#setScrollLoadEnabled方法，修正后的代码如下：

[java] view plaincopy

1. @Override  
2. public void setScrollLoadEnabled(boolean scrollLoadEnabled) {  
3.     if (isScrollLoadEnabled() == scrollLoadEnabled) {  
4.         return;  
5.     }  
6.       
7.     super.setScrollLoadEnabled(scrollLoadEnabled);  
8.       
9.     if (scrollLoadEnabled) {  
10.         // 设置Footer  
11.         if (null == mLoadMoreFooterLayout) {  
12.             mLoadMoreFooterLayout = new FooterLoadingLayout(getContext());  
13.             mListView.addFooterView(mLoadMoreFooterLayout, null, false);  
14.         }  
15.           
16.         mLoadMoreFooterLayout.show(true);  
17.     } else {  
18.         if (null != mLoadMoreFooterLayout) {  
19.             mLoadMoreFooterLayout.show(false);  
20.         }  
21.     }  
22. }  

• LoadingLayout#show方法，修正后的代码如下：

[java] view plaincopy

1. /** 
2.  * 显示或隐藏这个布局 
3.  *  
4.  * @param show flag 
5.  */  
6. public void show(boolean show) {  
7.     // If is showing, do nothing.  
8.     if (show == (View.VISIBLE == getVisibility())) {  
9.         return;  
10.     }  
11.       
12.     ViewGroup.LayoutParams params = mContainer.getLayoutParams();  
13.     if (null != params) {  
14.         if (show) {  
15.             params.height = ViewGroup.LayoutParams.WRAP_CONTENT;  
16.         } else {  
17.             params.height = 0;  
18.         }  
19.           
20.         requestLayout();  
21.         setVisibility(show ? View.VISIBLE : View.INVISIBLE);  
22.     }  
23. }  

在更改LayoutParameter后，调用requestLayout()方法。

• 图片旋转兼容2.x系统

我之前想的是这个只需要兼容3.x以上的系统，但发现有很多网友在使用过程中遇到过兼容性问题，这次抽空将这个兼容性一并实现了。

       onPull的修改如下：

[java] view plaincopy

1. @Override  
2. public void onPull(float scale) {  
3.     if (null == mRotationHelper) {  
4.         mRotationHelper = new ImageViewRotationHelper(mArrowImageView);  
5.     }  
6.       
7.     float angle = scale * 180f; // SUPPRESS CHECKSTYLE  
8.     mRotationHelper.setRotation(angle);  
9. }  

ImageViewRotationHelper主要的作用就是实现了ImageView的旋转功能，内部作了版本的区分，实现代码如下：

[java] view plaincopy

1. /** 
2.      * The image view rotation helper 
3.      *  
4.      * @author lihong06 
5.      * @since 2014-5-2 
6.      */  
7.     static class ImageViewRotationHelper {  
8.         /** The imageview */  
9.         private final ImageView mImageView;  
10.         /** The matrix */  
11.         private Matrix mMatrix;  
12.         /** Pivot X */  
13.         private float mRotationPivotX;  
14.         /** Pivot Y */  
15.         private float mRotationPivotY;  
16.           
17.         /** 
18.          * The constructor method. 
19.          *  
20.          * @param imageView the image view 
21.          */  
22.         public ImageViewRotationHelper(ImageView imageView) {  
23.             mImageView = imageView;  
24.         }  
25.           
26.         /** 
27.          * Sets the degrees that the view is rotated around the pivot point. Increasing values 
28.          * result in clockwise rotation. 
29.          * 
30.          * @param rotation The degrees of rotation. 
31.          * 
32.          * @see #getRotation() 
33.          * @see #getPivotX() 
34.          * @see #getPivotY() 
35.          * @see #setRotationX(float) 
36.          * @see #setRotationY(float) 
37.          * 
38.          * @attr ref android.R.styleable#View_rotation 
39.          */  
40.         public void setRotation(float rotation) {  
41.             if (APIUtils.hasHoneycomb()) {  
42.                 mImageView.setRotation(rotation);  
43.             } else {  
44.                 if (null == mMatrix) {  
45.                     mMatrix = new Matrix();  
46.                       
47.                     // 计算旋转的中心点  
48.                     Drawable imageDrawable = mImageView.getDrawable();  
49.                     if (null != imageDrawable) {  
50.                         mRotationPivotX = Math.round(imageDrawable.getIntrinsicWidth() / 2f);  
51.                         mRotationPivotY = Math.round(imageDrawable.getIntrinsicHeight() / 2f);  
52.                     }  
53.                 }  
54.                   
55.                 mMatrix.setRotate(rotation, mRotationPivotX, mRotationPivotY);  
56.                 mImageView.setImageMatrix(mMatrix);  
57.             }  
58.         }  
59.     }  

最核心的就是，如果在2.x的版本上，旋转ImageView使用Matrix。

• PullToRefreshBase构造方法兼容2.x

在三个参数的构造方法声明如下标注：

    @SuppressLint("NewApi")
    @TargetApi(Build.VERSION_CODES.HONEYCOMB)