iOS模式分析-使用适配器模式重构TableView

本文介绍了适配器模式的定义和概念,以及实际开发中的场景和案例,对应的代码可以在AdapterPatternDemo这里下载到。

1. 定义

什么是适配器模式?(电源适配器、转接头)
特点:

  • 将一个原始接口转成客户端需要的接口
  • 原始接口不兼容现在新的接口,将它们两个接口一起工作需要适配器解决

2. 应用场景

  • 接口不兼容(适配器模式)
  • 可以重复使用的类,用于与一些彼此之间没有太大关联的一些类一起工作(适配器模式)
  • 统一输出接口,输入的类型无法确定(适配器模式)

3. 角色划分

  • 第一个角色:适配器(最核心关键角色)
  • 第二个角色:目标接口
  • 第三个角色:被适配类(角色)
  • 第四个角色:客户端

4. 案例

4.1 案例说明

将美元(被适配对象—>Adaptee)——>人民币(目标接口——>Target)
适配器将美元转成人民币(Adaper)

4.2 定义Target协议

#import <Foundation/Foundation.h>

@protocol TargetProtocal <NSObject>

- (NSInteger)getCNY;

@end

4.3 定义被适配的对象类Adaptee

// USDAdaptee.h
#import <Foundation/Foundation.h>

@interface USDAdaptee : NSObject

- (void)setUSD:(NSInteger)usd;
- (NSInteger)getUSD;

@end


// USDAdaptee.m
#import "USDAdaptee.h"

@interface USDAdaptee ()
@property (nonatomic, assign) NSInteger usd;
@end

@implementation USDAdaptee

- (void)setUSD:(NSInteger)usd {
    _usd = usd;
}

- (NSInteger)getUSD {
    return _usd;
}

@end

4.4 使用对象适配器

对象适配器使用的是组合的模式,适配器类实现Target协议,并且在适配器类中定义一个Adaptee的属性,重写协议返回对Adaptee属性对象做相应的转换操作,来达到让Adaptee适配Target的目的。

// CNYObjectAdapter.h
#import <Foundation/Foundation.h>
#import "USDAdaptee.h"
#import "TargetProtocal.h"

@interface CNYObjectAdapter : NSObject <TargetProtocal>

@property (nonatomic, strong) USDAdaptee* usd;
- (instancetype)initWithUSD:(USDAdaptee*)usd;

@end

// CNYObjectAdapter.m
#import "CNYObjectAdapter.h"

@implementation CNYObjectAdapter

- (instancetype)initWithUSD:(USDAdaptee*)usd {
    self = [super init];
    if (self) {
        _usd = usd;
    }
    return self;
}

- (NSInteger)getCNY {
    return _usd.getUSD * 6.8;
}

@end

4.5 使用类适配器

类适配器使用的是继承的模式,适配器类实现Target协议,并且该适配器类继承Adaptee类,在重写的Target协议方法中使用super调用Adaptee的方法做相应的转换操作,来达到让Adaptee适配Target的目的。

// CNYClassAdapter.h
#import <Foundation/Foundation.h>
#import "USDAdaptee.h"
#import "TargetProtocal.h"

@interface CNYClassAdapter : USDAdaptee <TargetProtocal>

@end


// CNYClassAdapter.m
#import "CNYClassAdapter.h"

@implementation CNYClassAdapter

- (NSInteger)getCNY {
    return [self getUSD] * 6.8;
}

@end

4.6 客户端使用

    // 类适配器的使用
    CNYClassAdapter* cnyClsAdapter = [CNYClassAdapter new];
    [cnyClsAdapter setUSD:1000];
    NSInteger cny = [cnyClsAdapter getCNY];
    NSLog(@"CNYClassAdapter ==> cny = %@", @(cny));
    
    // 对象适配器的使用
    USDAdaptee* usd = [USDAdaptee new];
    [usd setUSD:1000];

    CNYObjectAdapter* cnyObjAdapter = [[CNYObjectAdapter alloc] initWithUSD:usd];
    NSInteger cny2 = [cnyObjAdapter getCNY];
    NSLog(@"CNYClassAdapter ==> cny = %@", @(cny2));

    // 结果输出
    //  CNYClassAdapter ==> cny = 6800
    // CNYClassAdapter ==> cny = 6800    

5. 真实开发案例

真实的开发案例中,会从一般的开发步骤说起,首先对一般的场景代码进行重构,把列表UITableVIewDataSource/UITableViewDelegate独立为一个简单的适配器;然后在此基础上进行抽象和扩展,构建一个更加灵活和易扩展的复杂列表适配器。

5.1 一般的开发步骤

一般的,在做一个列表的展示数据的时候,我们习惯的把创建列表、创建列表数据、注册列表的cell、实现列表的UITableVIewDataSource/UITableViewDelegate方法等步骤放在ViewController来完成,类似如下的代码,这种方法在简单的列表中看不出弊端,如果这个ViewController中添加了其他更多的逻辑、代码、这个类就显得十分庞大了;此外其他的页面有用到这个一样的列表只是数据不同,那么还得重新去实现这个步骤,列表的这部分逻辑不能够复用,产生了冗余的代码,don't repeat yourself,这很糟糕,所以很有必要重构这段代码,让他能够很好的进行复用,使用适配器模式就能够很好的做到这点。下面会讲到一个简单点的适配器和一个复杂点的适配器,来重构我们的代码。


@implementation SimpleViewController

- (void)viewDidLoad {
    // 处理UI和数据的步骤省略....
  
    // retister cell
    [self.tableView registerClass:[GameCell class] forCellReuseIdentifier:NSStringFromClass([GameCell class])];
    
}

#pragma mark - ......::::::: UITableViewDelegate :::::::......

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

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    GameCell* cell = [tableView dequeueReusableCellWithIdentifier:NSStringFromClass([GameCell class])];
    GameModel* gameModel = _datas[indexPath.row];
    [cell loadData:gameModel indexPath:indexPath];
    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    [tableView deselectRowAtIndexPath:indexPath animated:YES];
    
    UITableViewCell* cell = [tableView cellForRowAtIndexPath:indexPath];
}
@end

5.2 简单的列表适配器

简单的列表适配器就是把和UITableVIewDataSource/UITableViewDelegate相关的代码独立出来,来减轻ViewController,实现起来也很简单:

// SimpleAdapter.h
#import <Foundation/Foundation.h>
#import <UIKit/UIKit.h>

@interface SimpleAdapter : NSObject <UITableViewDelegate, UITableViewDataSource>
- (instancetype)initWithTableView:(UITableView*)tableView datas:(NSMutableArray*)datas;
@end


// SimpleAdapter.m
#import "SimpleAdapter.h"
#import "GameCell.h"
#import "GameModel.h"

@interface SimpleAdapter ()
@property (nonatomic, strong) NSMutableArray* datas;
@end

@implementation SimpleAdapter

- (instancetype)initWithTableView:(UITableView*)tableView datas:(NSMutableArray*)datas {
    self = [super init];
    if (self) {
        // retister cell
        [tableView registerClass:[GameCell class] forCellReuseIdentifier:NSStringFromClass([GameCell class])];
        _datas = datas;
    }
    return self;
}

- (void)dealloc {
    NSLog(@"=====SimpleAdapter dealloc=====");
}

#pragma mark - ......::::::: UITableViewDelegate :::::::......

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

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    GameCell* cell = [tableView dequeueReusableCellWithIdentifier:NSStringFromClass([GameCell class])];
    GameModel* gameModel = _datas[indexPath.row];
    [cell loadData:gameModel indexPath:indexPath];
    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    [tableView deselectRowAtIndexPath:indexPath animated:YES];
    
    UITableViewCell* cell = [tableView cellForRowAtIndexPath:indexPath];
}

@end

5.3 简单列表适配器的使用

简单列表适配器的使用十分的简单,把TableVIew的delegate和DataSource设置为Adapter对象就行了,并且列表的适配器复用也变得十分的方便了,当然使用这种方法在一些复杂的场景就不那么适用了,下面会在简单列表适配器的基础上进行扩展,也就是复杂的列表适配器,适用于更复杂的更一般性的场景,并且具有良好的扩张性。


@implementation SimpleAdapterViewController

- (void)viewDidLoad {
    // 处理UI和数据的步骤省略....
    
    self.adapter = [[SimpleAdapter alloc] initWithTableView:self.tableView datas:datas];
    self.tableView.dataSource = self.adapter;
    self.tableView.delegate = self.adapter;
}
@end

5.4 复杂的列表适配器

5.4.1 复杂的列表适配器层级分析

复杂列表适配器分为三个层

  1. Cell适配器层
  2. Section适配器层
  3. List列表适配器层

这三个层可以是独立的存在,同时地底层也可以作为高层的依赖,使用组合的方式实现扩展。
对应的创建三个层的协议:

// Cell适配器层->CellAdapterProtocal
@protocol CellAdapterProtocal <NSObject, UITableViewDelegate, UITableViewDataSource>
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section;
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath;
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath;
@end

// Section适配器层->SectionAdapterProtocal
@protocol SectionAdapterProtocal <NSObject, UITableViewDelegate, UITableViewDataSource>
- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section;
- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section;
- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section;
- (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section;
- (UIView *)tableView:(UITableView *)tableView viewForFooterInSection:(NSInteger)section;
@end

// List列表适配器层->ListAdapterProtocal
@protocol ListAdapterProtocal <NSObject, SectionAdapterProtocal, CellAdapterProtocal>
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView;
@end
5.4.2 对应层的Base实现

对应层需要做一个Base的实现,目的是为了把通用的工作放在Base实现类中,把差异的工作放到子类中,这样达到复用代码和减少实现代码的目的。

  • Cell适配器层的Base实现
@implementation BaseCellAdapter

- (instancetype)initWithTableView:(UITableView*)tableView datas:(NSMutableArray*)datas {
    self = [super init];
    if (self) {
        // retister cell
        for (Class claz in [self registerCellClasses]) {
            [tableView registerClass:claz forCellReuseIdentifier:NSStringFromClass(claz)];
        }
        _datas = datas;
    }
    return self;
}

#pragma mark - ......::::::: UITableViewDelegate :::::::......
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    return self.datas.count;
}

#pragma mark - ......::::::: override :::::::......
- (NSArray*)registerCellClasses {
    return nil;
}
@end
  • Section适配器层的Base实现

Section适配器层除了做了和列表Section展示有关的工作,还负责做Cell展示相关的工作,所以Section适配器层依赖了Cell适配器层,需要把Cell适配器层用到的内容转发给Cell适配器层,转发这部分使用了OC中的转发来减少代码量,使用的的方法为respondsToSelectorforwardingTargetForSelector,具体可以看下面的代码。

// BaseSectionAdapter.h
@interface BaseSectionAdapter : NSObject <SectionAdapterProtocal, CellAdapterProtocal>

@property (nonatomic, strong) NSString* sectionTitle;
@property (nonatomic, assign) NSInteger sectionHeight;
@property (nonatomic, strong) id<CellAdapterProtocal> cellAdapter;

- (instancetype)initWithCellAdapter:(id<CellAdapterProtocal>)cellAdapter sectionTitle:(NSString*)sectionTitle sectionHeight:(NSInteger)sectionHeight;

@end

// BaseSectionAdapter.m
@implementation BaseSectionAdapter

- (instancetype)initWithCellAdapter:(id<CellAdapterProtocal>)cellAdapter sectionTitle:(NSString*)sectionTitle sectionHeight:(NSInteger)sectionHeight {
    self = [super init];
    if (self) {
        _cellAdapter = cellAdapter;
        _sectionTitle = sectionTitle;
        _sectionHeight = sectionHeight;
    }
    return self;
}

#pragma mark - ......::::::: Section Handler :::::::......

- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    return self.sectionHeight;
}

- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
    return self.sectionTitle;
}

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    return nil;
}

- (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section {
    return 0;
}

- (UIView *)tableView:(UITableView *)tableView viewForFooterInSection:(NSInteger)section {
    return nil;
}


#pragma mark - ......::::::: Cell Handler :::::::......
#pragma mark 使用事件转发处理Cell

- (BOOL)respondsToSelector:(SEL)aSelector
{
    BOOL responds = [super respondsToSelector:aSelector];
    if (!responds && self.cellAdapter != self) {
        responds = [self.cellAdapter respondsToSelector:aSelector];
    }
    return responds;
}

- (id)forwardingTargetForSelector:(SEL)aSelector {
    if ([self.cellAdapter respondsToSelector:aSelector]) {
        return self.cellAdapter;
    }
    return self;
}

@end
  • List列表适配器层的Base实现

List列表适配器层主要是做一个整合的实现,需要把对应的事件转发给对应的Section适配器层,Section适配器层再负责把对应的事件转发给Cell适配器层。

// BaseListAdapter.h
@interface BaseListAdapter : NSObject <ListAdapterProtocal>
@property (nonatomic, strong) NSMutableArray<id<SectionAdapterProtocal>>* sections;
@end

// BaseListAdapter.m
@implementation BaseListAdapter 

#pragma mark - ......::::::: Section Handler :::::::......

- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
    return self.sections.count;
}

#pragma mark - ......::::::: Section Handler :::::::......

- (CGFloat)tableView:(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    id<SectionAdapterProtocal> sectionAdapter = self.sections[section];
    return [sectionAdapter tableView:tableView heightForHeaderInSection:section];
}

- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
    id<SectionAdapterProtocal> sectionAdapter = self.sections[section];
    return [sectionAdapter tableView:tableView titleForHeaderInSection:section];
}

- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    id<SectionAdapterProtocal> sectionAdapter = self.sections[section];
    return [sectionAdapter tableView:tableView viewForHeaderInSection:section];
}

- (CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section {
    id<SectionAdapterProtocal> sectionAdapter = self.sections[section];
    return [sectionAdapter tableView:tableView heightForFooterInSection:section];
}

- (UIView *)tableView:(UITableView *)tableView viewForFooterInSection:(NSInteger)section {
    id<SectionAdapterProtocal> sectionAdapter = self.sections[section];
    return [sectionAdapter tableView:tableView viewForFooterInSection:section];
}

#pragma mark - ......::::::: Cell Handler :::::::......

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
    id<SectionAdapterProtocal> cellAdapter = self.sections[section];
    return [cellAdapter tableView:tableView numberOfRowsInSection:section];
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    id<SectionAdapterProtocal> cellAdapter = self.sections[indexPath.section];
    return [cellAdapter tableView:tableView cellForRowAtIndexPath:indexPath];
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    id<SectionAdapterProtocal> cellAdapter = self.sections[indexPath.section];
    return [cellAdapter tableView:tableView didSelectRowAtIndexPath:indexPath];
}

@end
5.4.3 具体的适配器
  • 具体的Cell适配器
@implementation GameCellAdapter

#pragma mark - ......::::::: UITableViewDelegate :::::::......

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
    GameCell* cell = [tableView dequeueReusableCellWithIdentifier:NSStringFromClass([GameCell class])];
    GameModel* gameModel = self.datas[indexPath.row];
    [cell loadData:gameModel indexPath:indexPath];
    return cell;
}

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
    [tableView deselectRowAtIndexPath:indexPath animated:YES];
    
    UITableViewCell* cell = [tableView cellForRowAtIndexPath:indexPath];
}


#pragma mark - ......::::::: override :::::::......
- (NSArray*)registerCellClasses {
    return @[[GameCell class]];
}

@end
  • 具体的Section适配器

简单的定义了一个GameSectionAdapter继承了BaseSectionAdapter,没有更多的扩展,实际情况可以在这边添加更多自定义功能的代码,来扩展Section的功能。

@interface GameSectionAdapter : BaseSectionAdapter
@end

@implementation GameSectionAdapter
@end
  • 具体的List适配器
    和GameSectionAdapter一样,List适配器一般是比较固定的,一般的可以直接使用BaseListAdapter来完成对应的工作,无需额外的工作,这里作为Demo还是简单的继承BaseListAdapter实现一个自定义的List适配器,这里可以直接使用BaseListAdapter达到相同的效果。
@interface GameDetailListAdapter : BaseListAdapter
@end

@implementation GameDetailListAdapter
@end
5.4.4 复杂适配器的使用

复杂适配器需要创建CellAdapter对象、SectionAdapter对象、ListAdapter对象,进行组合,最后用ListAdapter对象作为列表的delegate和dataSource。

@implementation SectionAdapterViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 处理UI和数据的步骤省略....
    
    GameCellAdapter* cellAdapter = [[GameCellAdapter alloc] initWithTableView:self.tableView datas:datas];
    GameSectionAdapter* fpsSectionAdapter = [[GameSectionAdapter alloc] initWithCellAdapter:cellAdapter sectionTitle:@"FPS Games" sectionHeight:60];
    GameSectionAdapter* roleSectionAdapter = [[GameSectionAdapter alloc] initWithCellAdapter:cellAdapter sectionTitle:@"Role Play Games" sectionHeight:60];

    self.adapter = [[GameDetailListAdapter alloc] init];
    self.adapter.sections = [@[fpsSectionAdapter, roleSectionAdapter] mutableCopy];
    
    self.tableView.dataSource = self.adapter;
    self.tableView.delegate = self.adapter;
}

@end

实现的效果如下图:

复杂适配器的使用效果图

6. UML分析

对象适配器和类适配器

7. Demo

本文的Demo可以在AdapterPatternDemo这里下载到

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

推荐阅读更多精彩内容

  • 1 场景问题# 1.1 装配电脑的例子## 旧的硬盘和电源 小李有一台老的台式电脑,硬盘实在是太小了,仅仅40GB...
    七寸知架构阅读 3,215评论 5 59
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,029评论 4 62
  • 关于岁月,经历世事的我们想来都有自己的感受。明明年少时所发生的一些事情还历历在目,可回过头来,自己已与那个时候...
    意缄言言阅读 844评论 1 5