玩转iOS开发：打造一个低耦合可复用的《TableViewController》

CainLuo
2,616 阅读4分钟

文章分享至我的个人技术博客: https://cainluo.github.io/15009611814095.html

最近有些变懒了, 学习的步伐放慢了很多, 估计玩懒了身子, 连博客都少写了咯.

之前有个老铁问我, 怎么去封装一个低耦合可服用的TableViewController, 那时候没多说啥, 直接把我封装的框架丢给他了, 但他还是有很多乱七八糟的问题问我, 干脆直接写一篇博文当成教程好了.

转载声明:如需要转载该文章, 请联系作者, 并且注明出处, 以及不能擅自修改本文.

MVVM模式

由于这里我是用MVVM模式来封装的, 这里我就简单点, 通俗点, 易懂点的说说MVVM吧.

很多老铁都习惯于用MVC, 虽然有听过MVVM, 但也没去咋了解, 其实MVVM没有那么复杂, 传统的MVC是有Model, Views, Controller, 而MVVM只是在这个得基础上加了一个ViewModel, 并且弱化了Controller的职能.

MVC: Model, Views, Controller MVVM: Model, Views, ViewModel

那么弱化了的Controller就负责作为一个粘合剂, 像乐高积木一样, 把Model, Views, ViewModel组装在一起, 成为一个模块, 而Model, Views, ViewModel分别又是独立的个体, 谁都不会离不开谁.

大概就酱紫吧, 如果有更好的说法, 欢迎各位老铁补充补充哈~~

动工前的思考

这里说一下, CLTableViewController是我自己封装的TableViewController, 由于我比较懒, 所以里面直接集成了MJRefresh, 各位老铁随意喷哈.

这里说一下思路, 由于TableView还有TableViewDataSource, TableViewDelegate, 所以这里我们需要把两个模块分开, 这样子就不会造成代码臃肿的情况啦.

注意: 这里不包括各位的业务逻辑哈

封装TableViewDataSource

刚刚其实还说漏了一个, 除去TableViewDataSource, TableViewDelegate, 期是还有一个ViewModel层, 这个是用来请求数据的.

现在我们先来看TableViewDataSource:

#import <Foundation/Foundation.h>
#import "CLTableViewBaseModel.h"

@interface CLTableViewDataSource : NSObject <UITableViewDataSource>

@property (nonatomic, strong, readonly) CLTableViewBaseModel *cl_viewModel;

- (instancetype)initTableViewDataSourceWithViewModel:(CLTableViewBaseModel *)viewModel;

@end

#import "CLTableViewDataSource.h"

@interface CLTableViewDataSource ()

@property (nonatomic, strong, readwrite) CLTableViewBaseModel *cl_viewModel;

@end

@implementation CLTableViewDataSource

- (instancetype)initTableViewDataSourceWithViewModel:(CLTableViewBaseModel *)viewModel {
    
    self = [super init];
    
    if (self) {
        
        self.cl_viewModel = viewModel;
    }
    
    return self;
}

- (NSInteger)tableView:(UITableView *)tableView
 numberOfRowsInSection:(NSInteger)section {
    
    return self.cl_viewModel.cl_dataSource.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView
         cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"UITableViewCell"];
    
    if (!cell) {
        
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault
                                      reuseIdentifier:@"UITableViewCell"];
    }
    
    return cell;
}

@end

在.h文件里, 只提供了一个供给指定ViewModel的初始化方法, 内部的实现, 所返回的数据源数量也是指定ViewModel的数组个数, 默认返回一个系统的UITableViewCell, 这样子就好了.

封装TableViewDelegate

关于TableViewDelegate更多是采用系统的特性, 这里就没写什么内部实现了:

#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>
#import "CLTableViewBaseModel.h"

@interface CLTableViewDelegate : NSObject <UITableViewDelegate>

@property (nonatomic, strong, readonly) CLTableViewBaseModel *cl_viewModel;

- (instancetype)initTableViewDelegateWithViewModel:(CLTableViewBaseModel *)viewModel;

@end

#import "CLTableViewDelegate.h"

@interface CLTableViewDelegate ()

@property (nonatomic, strong, readwrite) CLTableViewBaseModel *cl_viewModel;

@end

@implementation CLTableViewDelegate

- (instancetype)initTableViewDelegateWithViewModel:(CLTableViewBaseModel *)viewModel {
    
    self = [super init];
    
    if (self) {
        
        self.cl_viewModel = viewModel;
    }
    
    return self;
}

@end

只定义了一个指定ViewModel的初始化方法.

封装CLTableViewBaseModel

关于ViewModel层, 这里我提供了三个方法, 两个属性:

#import <Foundation/Foundation.h>
#import "CLTableViewController.h"

@interface CLTableViewBaseModel : NSObject

@property (nonatomic, strong) NSMutableArray *cl_dataSource;
@property (nonatomic, weak, readonly) CLTableViewController *cl_tableViewController;

- (instancetype)initTableViewBaseModelWithController:(CLTableViewController *)viewController;

/**
 通过HTTP请求数据
 */
- (void)cl_tableViewHTTPRequest;

/**
 配置TableView每一条Cell所显示的分割线
 */
- (void)cl_configTableViewWithDataSource;

@end

#import "CLTableViewBaseModel.h"

@interface CLTableViewBaseModel()

@property (nonatomic, weak, readwrite) CLTableViewController *cl_tableViewController;

@end

@implementation CLTableViewBaseModel

- (instancetype)initTableViewBaseModelWithController:(CLTableViewController *)viewController {
    
    self = [super init];
    
    if (self) {
        self.cl_tableViewController = viewController;
    }
    
    return self;
}

- (NSMutableArray *)cl_dataSource {
    
    if (!_cl_dataSource) {
        
        _cl_dataSource = [NSMutableArray array];
    }
    
    return _cl_dataSource;
}

- (void)cl_tableViewHTTPRequest {
    
}

- (void)cl_configTableViewWithDataSource {
    
    if (self.cl_dataSource.count > 0) {
        
        self.cl_tableViewController.cl_tableView.separatorStyle = UITableViewCellSeparatorStyleSingleLine;
    }
}

@end

这样子就大功告成了, 接下来就是组装起它们就可以了.

组装成CLTableViewController

刚刚我们已经把三个模块写好了, 现在就开始组装:

#import "CLViewController.h"

NS_ASSUME_NONNULL_BEGIN
@interface CLTableViewController : CLViewController

@property (nonatomic, strong, readonly) UITableView *cl_tableView;

/**
 初始化CLTableViewController

 @param style UITableViewStyle, 默认是UITableViewStylePlain
 @return CLTableViewController
 */
- (instancetype)initTableViewControllerWithStyle:(UITableViewStyle)style;

- (void)cl_removeRefresh;
- (void)cl_removeHeaderRefresh;
- (void)cl_removeFooterRefresh;

/**
 下拉刷新方法/上拉加载方法
 */
- (void)cl_dropDownRefresh;
- (void)cl_pullUpRefresh;

/**
 开始执行下拉操作/结束下拉操作
 */
- (void)cl_dropDownBeginRefresh;
- (void)cl_dropDownEndRefresh;

/**
 开始执行上拉操作/结束上拉操作
 */
- (void)cl_pullUpBeginRefresh;
- (void)cl_pullUpEndRefresh;

- (void)cl_setTableViewDelegate:(_Nullable id <UITableViewDelegate>)delegate
                     dataSource:(_Nullable id <UITableViewDataSource>)dataSource;
@end
NS_ASSUME_NONNULL_END

#import "CLTableViewController.h"
#import "MJRefresh.h"
#import "CLTableViewDelegate.h"
#import "CLTableViewBaseModel.h"

@interface CLTableViewController ()

@property (nonatomic, assign) UITableViewStyle tableViewStyle;

@property (nonatomic, strong, readwrite) UITableView *cl_tableView;

@property (nonatomic, strong) CLTableViewDelegate *cl_tableViewDelegate;
@property (nonatomic, strong) CLTableViewBaseModel *cl_ableViewBaseModel;

@end

@implementation CLTableViewController

- (instancetype)initTableViewControllerWithStyle:(UITableViewStyle)style {
    
    self = [super init];
    
    if (self) {
        
        [self setTableViewStyle:style];
    }
    
    return self;
}

#pragma mark - View Did Load
- (void)viewDidLoad {
    [super viewDidLoad];
    
    self.view.opaque = YES;
    self.automaticallyAdjustsScrollViewInsets = NO;

    self.view.backgroundColor = [UIColor whiteColor];
    
    [self cl_addRefresh];
}

- (UITableView *)cl_tableView {
    
    if (!_cl_tableView) {
        
        _cl_tableView = [[UITableView alloc] initWithFrame:self.view.frame
                                                     style:self.tableViewStyle];
        
        if (self.tableViewStyle == UITableViewStylePlain) {
            
            _cl_tableView.separatorStyle = UITableViewCellSeparatorStyleNone;
        }
        
        _cl_tableView.opaque = YES;
    }
    
    return _cl_tableView;
}

- (void)cl_setTableViewDelegate:(id<UITableViewDelegate>)delegate
                     dataSource:(id<UITableViewDataSource>)dataSource {
    
    self.cl_tableView.delegate   = delegate;
    self.cl_tableView.dataSource = dataSource;
}

#pragma mark - Table View Delegate
- (CLTableViewDelegate *)cl_tableViewDelegate {
    
    if (!_cl_tableViewDelegate) {
        
        _cl_tableViewDelegate = [[CLTableViewDelegate alloc] initTableViewDelegateWithViewModel:self.cl_ableViewBaseModel];
    }
    
    return _cl_tableViewDelegate;
}

#pragma mark - Table View Base Model
- (CLTableViewBaseModel *)cl_ableViewBaseModel {
    
    if (!_cl_ableViewBaseModel) {
        _cl_ableViewBaseModel = [[CLTableViewBaseModel alloc] initTableViewBaseModelWithController:self];
    }
    
    return _cl_ableViewBaseModel;
}

#pragma mark - Refresh
- (void)cl_addRefresh {
    
    MJRefreshNormalHeader *header = [MJRefreshNormalHeader headerWithRefreshingBlock:^{
        [self cl_dropDownRefresh];
    }];
    
    self.cl_tableView.mj_header = header;
    
    MJRefreshBackNormalFooter *refreshFooter = [MJRefreshBackNormalFooter footerWithRefreshingBlock:^{
        [self cl_pullUpEndRefresh];
    }];
    
    self.cl_tableView.mj_footer = refreshFooter;
    
    [self.view addSubview:self.cl_tableView];
}

- (void)cl_dropDownRefresh {}

- (void)cl_pullUpRefresh {}

- (void)cl_dropDownBeginRefresh {
    [self.cl_tableView.mj_header beginRefreshing];
}

- (void)cl_dropDownEndRefresh {
    [self.cl_tableView.mj_header endRefreshing];
}

- (void)cl_pullUpBeginRefresh {
    [self.cl_tableView.mj_footer beginRefreshing];
}

- (void)cl_pullUpEndRefresh {
    [self.cl_tableView.mj_footer endRefreshing];
}

- (void)cl_removeRefresh {
    
    self.cl_tableView.mj_header = nil;
    self.cl_tableView.mj_footer = nil;
}

- (void)cl_removeHeaderRefresh {
    self.cl_tableView.mj_header = nil;
}

- (void)cl_removeFooterRefresh {
    self.cl_tableView.mj_footer = nil;
}

@end

完成了!!! 现在封装好了一个属于我们自己的TableViewController啦.

总结

由于这里封装的比较简单, 如果有更好建议的老铁可以私下留言一下, 我也会跟进优化, 方便大家, 当然我自己封装的框架还有其他, 但是太多了不好一一写出来, 喜欢的话, 可以Star一下我的CLFramework, 如果有老铁想一起维护一下这个开源库的话, 也可以和我说说.

关于详细的用法, 大家可以在里面找到SimpleProject工程, 里面有我的详细用法.

最后

码字很费脑, 看官赏点饭钱可好

微信

支付宝

avatar
文章
阅读
粉丝