一种简单的iOS 的组件化设计

前言:如今iOS的开发中,组件化设计都成为一种标配了,要是不用上好像就赶不上潮流了。网上相关的方案分析也多如牛毛。分析比较多的是URLRoute / 蘑菇街的 url-block 和 Protocol-Class / 和 casa 的target-action。

一、 方案比较

URLRoute 与蘑菇街 url-block 和Protocol-Class 都不得不维护一套 url 或 Protocol 与组件间的映射,通过 url 或 Protocol 去寻找组件。先不说效率问题,单是编写和维护这个映射的代码,使用者使用必须先注册,然后才能使用,模板代码会充满整个项目。其实小的觉得这份映射是完全没必要的。

casa 的target-action 不用维护映射表,这个方案使用 “Target_ + 组件名字” 作 为key 通过runtime 寻找服务。但是 hardcode 的地方太多,宏定义或者const 变量充满了头文件。这样使用起来必须记忆很多const变量,编码效率也稍微下降。在调用组件的时候,cache 了 targetClass。不晓得是否觉得NSClassFromString 方法不够高效。

二、小的试把两套方案结合起来,弄一个叫protocol-module模式的组件化

  1. 约定

oc 语言中充满了约定。比如 类的初始化方法 initXXX,系统合成的setter getter方法。更具体的是KVO观察了一个类的属性,被观察的类变更为一个带约定前缀的子类

- (instancetype)initWithNibName:(nullable NSString *)nibNameOrNil bundle:(nullable NSBundle *)nibBundleOrNil NS_DESIGNATED_INITIALIZER;
image.png

小的这套方案最主要的是编写代码的约定,思路如下图


image.png

2.说明
小的打个比方。我们把主app称为用户,用户委托商家生产一个组件。用户把需求和想怎么使用这个组件告诉商家。“需求”的实现就是组件本身,“怎么使用”对应的就是协议了。因为协议是双方都知晓的,所以是公开的。这样的好处是,用户不管组件是怎么实现的,我只要按协议使用就行了。

图中public protocol 是定义好的组件调用协议,基本协议规定了组件回调的 callback,和服务体 serverBody,也就是组件提供服务的 controller。组件moduleA 、moduleB等为了使用者方便,都会实现一个interface的类。这个类遵守对应的协议,类名必须是 “协议名 + SI”。比如协议名是ModuleA,那么interface类的类名就是ModuleASI。

1)编写协议和组件
基本协议定义如下

#ifndef MoudleProtocol_ServerInterface
#define MoudleProtocol_ServerInterface @"SI"
#endif

@protocol BaseModule <NSObject>
@required
// server body
@property(nonatomic, weak) __kindof UIViewController *serverBody;

@optional
// callback
@property(nonatomic, copy) void (^callback) (id params);

@end

通过将 BaseModule 协议子协议化,定制特定组件调用协议。例如我们要调用组件moduleA,我们可以定义一个叫ModuleA的协议,这个协议遵守BaseModule协议

@protocol ModuleA <BaseModule>

@required
// input
@property(nonatomic, strong) NSString *name;

@end

这个协议很简单,只有一个属性name,指定了我们调用组件时要传入的参数是name。

定好了协议,商家生产出组件后,他还要做一件事就是实现interface接口类ModuleASI
这个类实现如下

@interface MouduleASI : NSObject <ModuleA>

@end

@implementation MouduleASI

@synthesize callback;

@synthesize name;

@synthesize serverBody;

- (UIViewController *)serverBody {
  if (!serverBody) {
    UIStoryboard *sb  = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
    serverBody = [sb instantiateViewControllerWithIdentifier: @"OhgRacViewController"];
    ((OhgRacViewController *)serverBody).interface = self;
  }
  return serverBody;
}
@end

好了,代码很简单不是吗,商家不会抱怨让他多干活的。在MouduleASI的.m文件里,商家简单的返回一个serverBody。

2)大功告成了吗?还差一点

组件化最重要的路由忘了。不过放心,小的这个路由很简单的,老规矩,先看代码,路由定义

@interface OHGRouter : NSObject

+ (instancetype) router;
- (id) interfaceForProtocol:(Protocol *) p;
- (id) interfaceForURL:(NSURL *) url;

// for unit test
- (void) assertForMoudleWithProtocol:(Protocol *) p;
- (void) assertForMoudleWithURL:(NSURL *) url;

// navi type for vc
// push present
- (UIViewController *) findVcOfView:(UIView *) view;

@end

同样简单的要死,小的不用说各位看官都基本明白了,不过,还是啰嗦一下...别打脸

  • (instancetype) router;这个方法略
  • (id) interfaceForProtocol:(Protocol *) p;这个方法是通过协议找到对应的组件接口类,实现如下
- (id)interfaceForProtocol:(Protocol *)p {
  Class cls = [self _clsForProtocol:p];
  return [[cls alloc] init];
}

- (Class) _clsForProtocol:(Protocol *) p {
  NSString *clsString = [NSStringFromProtocol(p) stringByAppendingString: MoudleProtocol_ServerInterface];
  return NSClassFromString(clsString);
}

好吧,就这么点代码,获取协议名,拼接上前面public protocol的宏定MoudleProtocol_ServerInterface @"SI",就是我们的接口类名。这就是我们为啥提前做了约定的原因。(类似苹果实现的KVO),这个约定好处在于,我们完全不用维护 url-block / protocol-class / target-action等在内存的映射,也就不需要注册组件了。

  • (id) interfaceForURL:(NSURL *) url;这个方法可以处理远端调用组件,我们稍后再说

// for unit test

  • (void) assertForMoudleWithProtocol:(Protocol *) p;
  • (void) assertForMoudleWithURL:(NSURL *) url;
    这两个方法很有意思,在单元测试的时候,我们容易通过协议和url检查,组件是否实现了 interface 接口类,看代码
- (void)assertForMoudleWithProtocol:(Protocol *)p {
  if (![self _clsForProtocol:p]) {
    NSString *protocolName = NSStringFromProtocol(p);
    NSString *clsName = [protocolName stringByAppendingString: MoudleProtocol_ServerInterface];
    NSString *reason = [NSString stringWithFormat: @"找不到协议 %@ 对应的接口类 %@ 的实现", protocolName, clsName];
    [self _throwException: reason];
  }
}

如果我们找不到接口类,说明组件还没写好,抛出异常。
以上,路由也就写好了。

3)很快就完成了,看看怎么使用
在ViewController.m下

#import "ViewController.h"
#import "OHGRouter.h"

@implementation ViewController
- (IBAction)showModlue:(id)sender { 
  id <ModuleA> obj = [[OHGRouter router] interfaceForProtocol: @protocol(ModuleA)];
//  id<ModuleA> obj = [[OHGRouter router] interfaceForURL:[NSURL URLWithString:@"ModuleA://?name=xiaobaitu"]];
  obj.name = @"小白兔";
  obj.callback = ^(id params) {
    NSLog(@"%@", params);
  };
  [self.navigationController pushViewController: obj.serverBody animated: YES];
}
@end

在showModlue方法里,小的简单的传入协议ModuleA,就能调用组件了,传入参数name, 实现回调callback。并且咱基本上没有hardcode,所以还有编码过程编译器还能给温馨提示。在整个ViewController.m,咱并没有导入任何组件相关的信息,路由里也没有,很简单的咱就实现了组件的解耦。这一切就是因为我们一开始就明确了协议和组件接口的约定。

4)还没完
前面说到路由- (id) interfaceForURL:(NSURL ) url;方法,从使用就可以看出来这事怎么回事了id<ModuleA> obj = [[OHGRouter router] interfaceForURL:[NSURL URLWithString:@"ModuleA://?name=xiaobaitu"]];
只要我们按格式|
协议名://参数 *| 调用就大功告成了,例如: ModuleA://?name=xiaobaitu。


好了,完了

附上demo地址:https://github.com/ovcv8/a_simple_router

ps: 针对@inxx 同学提出的建议,又有一些新的想法,俺打算开本篇的第二篇,这里先打个桩😄。

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

推荐阅读更多精彩内容