MJRefresh源码解析

上一篇详细写了GCD的探索,这次想写一个平时常用的第三方库的解析文章,由于最近时间比较紧,所以AFNetworking这种超级耗时的就先放一边了,那么MJRefresh也是我们项目中比较常用的一个UI功能库了,主要用于滚动视图的上下拉刷新加载的功能,这里暂且不对作者进行讨论,单纯分析源码的实现。首先先看一下整个项目的结构:


MJRefresh项目结构

首先是一些头文件和常用分类

MJRefresh
所有文件的头文件,开发中只需要导入这个文件即可
MJRefreshConst
一些库中使用到的常量和宏定义,如果想修改文字等信息,只要修改这个文件中内容即可
NSBundle+MJRefresh
负责操作涉及包内文件的分类,主要有箭头图片的处理以及国际化的操作,国际化的内容全部放到了Resources文件中
UIScrollView+MJExtension
主要负责将结构体代码简易化的分类,避免项目中操作结构体的代码过长
UIView+MJExtension
和scrollview结构体简易化的功能一样,只不过是针对于UIView的分类,但是作用是类似的
UIScrollView+MJRefresh
这里是给UIScrollView和其派生类添加刷新控件的分类,对于不同类型有多重实现

@implementation NSObject (MJRefresh)

+ (void)exchangeInstanceMethod1:(SEL)method1 method2:(SEL)method2
{
    method_exchangeImplementations(class_getInstanceMethod(self, method1), class_getInstanceMethod(self, method2));
}

+ (void)exchangeClassMethod1:(SEL)method1 method2:(SEL)method2
{
    method_exchangeImplementations(class_getClassMethod(self, method1), class_getClassMethod(self, method2));
}

@end

这里使用runtime定义了实例方法和类方法的方法交换(Method Swizzling)规则,runtime知识点会在接下来的文章中探讨这里暂时不加赘述,不是很了解的同学可以先查一下资料。
由于分类中的属性不能自动生成有效的setter和getter方法,所以这里依然使用runtime的设置关联对象的方式实现这两个必要方法。

- (void)setMj_header:(MJRefreshHeader *)mj_header
{
    if (mj_header != self.mj_header) {
        // 如果不是同一个对象,那么将之前的header删除,添加一个新的header
        [self.mj_header removeFromSuperview];
        [self insertSubview:mj_header atIndex:0];
        
        // 使用kvo监听这个对象的添加时机,使用关联对象将header设置给当前控件
        [self willChangeValueForKey:@"mj_header"]; // KVO
        objc_setAssociatedObject(self, &MJRefreshHeaderKey,
                                 mj_header, OBJC_ASSOCIATION_ASSIGN);
        [self didChangeValueForKey:@"mj_header"]; // KVO
    }
}

- (MJRefreshHeader *)mj_header
{
    //同样使用关联对象的方式取值
    return objc_getAssociatedObject(self, &MJRefreshHeaderKey);
}

这里footer和header实现方式一样,所以只用header进行讲解

- (void)setHeader:(MJRefreshHeader *)header
{
    self.mj_header = header;
}

- (MJRefreshHeader *)header
{
    return self.mj_header;
}

这里也许会存在疑问,在set方法中用到了属性设置的问题,如果是正常情况下,必须使用_header=header;的形式,否则会造成无限调用set方法导致循环的问题,而这里不会出现类似问题,self.mj_header会调用一次setMj_header的方法,setHeader将header的值实际赋给了mj_header,所以不会存在问题。

+ (void)load
{
    [self exchangeInstanceMethod1:@selector(reloadData) method2:@selector(mj_reloadData)];
}

load函数无论文件被引用或者调用与否,都会先于main函数执行,所以在运行的一开始,交换方法就已经完成了

- (void)mj_reloadData
{
    [self mj_reloadData];
    
    [self executeReloadDataBlock];
}
- (void)executeReloadDataBlock
{
    !self.mj_reloadDataBlock ? : self.mj_reloadDataBlock(self.mj_totalDataCount);
}

这里使用了方法交换,将原本的reloadData和mj_reloadData做了交换,当外部使用类似[self.tableView reloadData];的时候,实际调用了这个方法,而里面使用[self mj_reloadData];方法不会造成循环问题,由于已经做了方法交换,这个方法会被替换成[self reloadData];所以相当于在原本的方法基础上多调用了一次executeReloadDataBlock这个回调方法。

到此刷新控件以外的代码都已经分析完毕了,接下来是本文的重点。

下面开始刷新控件的重点

MJRefreshComponent:
刷新控件的基类,包含刷新的状态的属性,状态回调,子控件布局等方法,以及一些交由子类实现的统一方法。

- (void)willMoveToSuperview:(UIView *)newSuperview{
//当视图即将加入到父视图时调用,如果刷新控件父视图不是Scrollview或Scrollview的派生类,那么不执行任何操作
//添加新的父控件的监听,包括contentOffset和ContentSize以及拖动手势的监听。
}
//监听了如下方法,由子类去实现
- (void)scrollViewContentOffsetDidChange:(NSDictionary *)change{}
- (void)scrollViewContentSizeDidChange:(NSDictionary *)change{}
- (void)scrollViewPanStateDidChange:(NSDictionary *)change{}
//开始及结束刷新调用的方法和方法回调,修改刷新状态值
- (void)beginRefreshing{//启动刷新动画,并且将状态变为正在刷新状态}
- (void)beginRefreshingWithCompletionBlock:(void (^)(void))completionBlock{}
- (void)endRefreshing{//结束刷新动画,并且将状态变为普通状态}
- (void)endRefreshingWithCompletionBlock:(void (^)(void))completionBlock{}
//当刷新state为MJRefreshStateRefreshing正在刷新中时,由子类调用该方法,方法内容为进入刷新的一些回调
- (void)executeRefreshingCallback{}

MJRefreshHeader
继承自MJRefreshComponent,实为下拉功能的基类,主要负责创建header,以及刷新header的时间记录等

- (void)scrollViewContentOffsetDidChange:(NSDictionary *)change{
    if (self.state == MJRefreshStateRefreshing) {
    //下拉松手之后,进入正在刷新状态,这里代码确保刷新时可以在某一个高度悬停
    }
    if (self.scrollView.isDragging) { 
        //如果当前scrollview正在拖拽
        if (self.state == MJRefreshStateIdle && offsetY < normal2pullingOffsetY) {
            // 如果当前状态为普通状态,并且下拉幅度已经超过了刷新高度范围,那么将状态设置为MJRefreshStatePulling,即松开手就可以刷新的状态,这时认为需要刷新
            self.state = MJRefreshStatePulling;
        } else if (self.state == MJRefreshStatePulling && offsetY >= normal2pullingOffsetY) {
            // 如果状态为松开手就可以刷新,但是下拉幅度小于可以刷新的高度范围,那么将状态设置为普通状态,这时认为用户取消了刷新的手势操作
            self.state = MJRefreshStateIdle;
        }
    } else if (self.state == MJRefreshStatePulling) {
        // 如果当前scrollview不在拖拽状态,并且状态为松手就可以刷新,表示当前scrollview的偏移量已经超过了刷新的高度范围,可以进行刷新
        // 那么这里调用父类刷新方法,并且将状态设置为刷新状态,直到接收到endRefreshing的通知
        [self beginRefreshing];
    } else if (pullingPercent < 1) {
        self.pullingPercent = pullingPercent;
    }
}

- (void)setState:(MJRefreshState)state {
    if (state == MJRefreshStateIdle) {
        //保存刷新时间,恢复offset和inset,动画结束调用刷新结束的回调
    } else if (state == MJRefreshStateRefreshing) {
        //异步回到主线程,执行刷新回弹的动画,以及动画结束启动开始刷新的回调
    }
}

MJRefreshNormalHeader
继承自MJRefreshHeader,实现最后的细节功能,包括下拉箭头,加载进度圈,提示文字等

- (void)placeSubviews{
    //将加载圈和下拉箭头等子控件进行布局
}
- (void)setState:(MJRefreshState)state{
    if (state == MJRefreshStateIdle) {
        //将所有子控件都回归正常状态
    } else if (state == MJRefreshStatePulling) {
        //箭头转向,加载圈动画停止
    } else if (state == MJRefreshStateRefreshing) {
        //隐藏箭头,加载圈启动动画
    }
}

MJRefreshNormalHeader
同样继承自MJRefreshHeader,将刷新动画换为GIF动画的形式

- (void)setState:(MJRefreshState)state
{
    
    // 这里动画使用帧动画的形式,使用一组不同动作的图片按照顺序展示,形成动画
    if (state == MJRefreshStatePulling || state == MJRefreshStateRefreshing) {
       //启动帧动画
        }
    } else if (state == MJRefreshStateIdle) {
        //停止帧动画
    } 
}

MJRefreshFooter
和MJRefreshHeader一样,是所有上拉加载的基类,但是比下拉多了 No More Data 这种状态,当出现这种状态时,表示所有数据已经加载完毕,无法继续上拉加载。

MJRefreshBackFooter
继承自MJRefreshFooter,是两种上拉效果的其中一种,表示正常的上拉触发到回弹才会加载的方式

- (void)scrollViewContentOffsetDidChange:(NSDictionary *)change {
    if (self.state == MJRefreshStateNoMoreData) {
        //如果状态为 No More Data,表示已经没有数据,所以不需要有后续的动画效果
    }
    //其他状态同 header 的效果一样
}

MJRefreshAutoFooter
同样继承自MJRefreshFooter,是两种上拉效果的其中另外一种,表示无需回弹效果,只要触发上拉动作就会刷新的方式

- (void)scrollViewPanStateDidChange:(NSDictionary *)change
{        
    //表示当拖拽到结束的时候触发的事件
    if (_scrollView.panGestureRecognizer.state == UIGestureRecognizerStateEnded) {
        if (_scrollView.mj_insetT + _scrollView.mj_contentH <= _scrollView.mj_h) {  
    //当内容不能撑满一个屏幕的时候,只需要有上拉动作就可以进行加载操作
            if (_scrollView.mj_offsetY >= - _scrollView.mj_insetT) { 
                [self beginRefreshing];
            }
        } else {
    //当内容超过一个屏幕的时候,并且滑动范围超过了最底部的位置,立刻触发刷新
            if (_scrollView.mj_offsetY >= _scrollView.mj_contentH + _scrollView.mj_insetB - _scrollView.mj_h) {
                [self beginRefreshing];
            }
        }
    }
}

MJRefreshBackNormalFooter MJRefreshBackGifFooter MJRefreshAutoNormalFooter MJRefreshAutoGifFooter
这四个类分别是MJRefreshBackFooter和MJRefreshAutoFooter的派生类,功能和header是一样的,所以就不再多加赘述了。

至此,整个MJRefresh已经全部解析完毕,实现起来并不难,虽然内容不多,但是很多地方用的很精妙,感谢作者的开源代码库给我们平时开发带来的种种便利,并且感谢所有继续维护的大神们。
如果本文有任何疏漏,还请各路大神多加指导,欢迎在下方进行评论~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 210,978评论 6 490
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 89,954评论 2 384
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 156,623评论 0 345
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,324评论 1 282
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,390评论 5 384
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,741评论 1 289
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,892评论 3 405
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,655评论 0 266
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,104评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,451评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,569评论 1 340
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,254评论 4 328
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,834评论 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,725评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,950评论 1 264
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,260评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,446评论 2 348

推荐阅读更多精彩内容