当前位置:主页 > 移动开发 > iOS代码 >

iOS使用核心的50行代码撸一个路由组件

时间:2021-01-23 10:12:52 | 栏目:iOS代码 | 点击:

使用组件化是为了解耦处理,多个模块之间通过协议进行交互。而负责解析协议,找到目的控制器,或者是返回对象给调用者的这个组件就是路由组件。本文讲解如何使用核心的50行代码实现一个路由组件。

路由注册实现
路由使用实现

组件化和路由

之前看过挺多的关于路由管理、路由处理的文章,常常会和组件化出现在一起,一开始不知道为何路由和组件化出现在一起,后来公司的项目中使用了路由组件(他本身也是一个组件,确切的说是一个中间人或者中介者),才突然想明白了,原来如此。

使用组件化是为了解耦处理,多个模块之间通过协议进行交互。而负责解析协议,找到目的控制器,或者是返回对象给调用者的这个组件就是路由组件。

路由组件的职责主要是:

注册者传递path和path对应的block,block的具体实现又注册者自己处理

调用者最简单可以传递一个path给路由组件发起调用,路由组件会把具体的处理转发给注册者,理论上是可以任意的操作,包括页面跳转、弹窗提示、返回一个值给调用者等

下面会会在以上分析的基础上实现一个简单的路由组件,对应的代码可以在YTRouterDemo这里找到

路由的实现

路由的实现包括两部分:路由注册实现以及路由使用实现

路由注册实现

路由注册实现时序图:

如上图所示,步骤很简单:

以上步骤对应的代码如下:

- (void)registerPath:(NSString *)path actionBlock:(RouterActionBlock)actionBlock {
 YTRouterActionObject *actionObject = [YTRouterActionObject new];
 actionObject.path = path;
 actionObject.actionBlock = actionBlock;
 NSMutableDictionary *subRouter = [self subRouterMapWithPath:path];
 subRouter[YTRouterActionObjectKey] = actionObject;
}
- (NSMutableDictionary *)subRouterMapWithPath:(NSString *)path {
 NSArray *components = [path componentsSeparatedByString:@"/"];
 NSMutableDictionary *subRouter = self.routerMap;
 for (NSString *component in components) {
  if (component.length == 0) {
   continue;
  }
  if (!subRouter[component]) {
   subRouter[component] = [NSMutableDictionary new];
  }
  subRouter = subRouter[component];
 }
 return subRouter;
}

在Demo中注册的几个路由最终的配置如下,比如home/messagelist对应的路由配置保存在<YTRouterActionObject: 0x6040000365e0>对象中

Printing description of self->_routerMap:
{
 home =  {
  "_" = "<YTRouterActionObject: 0x60c00003b040>";
  messagelist =   {
   "_" = "<YTRouterActionObject: 0x6040000365e0>";
   detail =    {
    "_" = "<YTRouterActionObject: 0x600000038ec0>";
   };
   getmessage =    {
    "_" = "<YTRouterActionObject: 0x600000038e80>";
   };
  };
 };
}

路由使用实现

路由使用实现时序图:

如上图所示,步骤很简单:

从注册的配置中找到匹配的YTRouterActionObject对象

执行YTRouterActionObject对象的actionBlock,会传递一个YTRouterActionCallbackObject对象,如果调用者需要的是返回值,可以使用YTRouterActionCallbackObject对象的actionCallbackBlock传递一个返回值,这个actionBlock是又业务方的注册者实现的

以上步骤对应的代码如下:

- (BOOL)runWithActionCallbackObject:(YTRouterActionCallbackObject *)actionCallbackObject {
 // 判断是否支持scheme
 if (![self canAcceptScheme:actionCallbackObject.uri.scheme]) {
  return NO;
 }
 // 获取path对应的ActionObject
 YTRouterActionObject *actionObject = [self actionObjectWithPath:actionCallbackObject.uri.path];
 // 执行Path注册的对应Block
 !actionObject.actionBlock ?: actionObject.actionBlock(actionCallbackObject);
 return YES;
}
- (YTRouterActionObject *)actionObjectWithPath:(NSString *)path {
 NSMutableDictionary *subRouter = [self subRouterMapWithPath:path];
 return subRouter[YTRouterActionObjectKey];
}

客户端的使用

以上讲到了核心的路由注册实现和路由使用实现,总共代码还没有50行,所以还是很简单的,接下来会讲下客户端的使用步骤,包括

客户端注册者注册

注册的时机需要比较找,考虑到集成的方便,选择在load方法中处理路由注册,如下代码所示,添加了几个测试的路由,分两种情况来说明下使用

1、不需要返回值

如下注册"home/messagelist"的是一个页面跳转的路由,actionBlock的参数是一个YTRouterActionCallbackObject对象,可以从YTRouterActionCallbackObject对象或者到参数,关于如何传递值,会在下面的客户端调用者使用这里讲到。然后在actionBlock处理目的页面的初始化、参数设置等步骤,然后执行页面跳转。

2、需要返回值

如下注册"home/messagelist/getmessage"的是一个提供返回值的路由,同样也可以从YTRouterActionCallbackObject对象获取参数,另外YTRouterActionCallbackObject对象还有一个actionCallbackBlock属性是专门处理返回参数给调用者的,如下的代码只是简单返回一个字符串,在更加具体的业务场景中,这里会设置接口调用、数据库查询等任务,最后把结果返回。

@implementation ModuleAUriRegister
+ (void)load {
 [[YTRouterManager sharedRouterManager] registerPath:@"home/messagelist" actionBlock:^(YTRouterActionCallbackObject *callbackObject) {
  MessageListViewController *messageListVC = [MessageListViewController new];
  NSString *title = callbackObject.uri.params[@"title"];
  messageListVC.title = title;
  [[UIViewController yt_currentViewControlloer].navigationController pushViewController:messageListVC animated:YES];;
 }];
 [[YTRouterManager sharedRouterManager] registerPath:@"home/" actionBlock:^(YTRouterActionCallbackObject *callbackObject) {
 }];
 [[YTRouterManager sharedRouterManager] registerPath:@"home/messagelist/detail" actionBlock:^(YTRouterActionCallbackObject *callbackObject) {
 }];
 [[YTRouterManager sharedRouterManager] registerPath:@"home/messagelist/getmessage" actionBlock:^(YTRouterActionCallbackObject *callbackObject) {
  // 内容回调
  !callbackObject.actionCallbackBlock ?: callbackObject.actionCallbackBlock(@"message content text demo");
 }];
}
@end

客户端调用者使用

1、简单的path跳转调用

使用YTRouterManager单例对象的runWithPath方法,传递一个注册的path参数完成跳转。

[self addActionWithTitle:@"Router页面跳转" detailText:@"home/messagelist" callback:^{
 [[YTRouterManager sharedRouterManager] runWithPath:@"home/messagelist"];
}];

2、使用URL调用和有URL参数的调用

使用YTRouterManager单例对象的runWithURLString方法,传递一个完整的包含了scheme/path,或者有参数的会才有参数的URL,比如"YTRouter://home/messagelist" 和 "YTRouter://home/messagelist?title=Hello Message" ,路由组件会解析出里面的scheme、path、params,进行scheme过滤处理、path查询YTRouterActionObject对象处理、参数传递处理。

[self addActionWithTitle:@"Router使用URL调用" detailText:@"YTRouter://home/messagelist" callback:^{
 [[YTRouterManager sharedRouterManager] runWithURLString:@"YTRouter://home/messagelist"];
}];
[self addActionWithTitle:@"Router使用带参数的URL调用" detailText:@"YTRouter://home/messagelist?title=Hello Message" callback:^{
 [[YTRouterManager sharedRouterManager] runWithURLString:@"YTRouter://home/messagelist?title=Hello Message"];
}];

效果如下图所示:

效果图

3、简单的path跳转调用

使用YTRouterManager单例对象的runWithActionCallbackObject方法,传递一个YTRouterActionCallbackObject类型的参数,设置YTRouterActionCallbackObject对象的uri和结果回调actionCallbackBlock参数,在actionCallbackBlock中处理返回值。

[self addActionWithTitle:@"Router获取返回值" detailText:@"home/messagelist/getmessage" callback:^{
 __block id message = nil;
 YTRouterActionCallbackObject *actionCallbackObject = [YTRouterActionCallbackObject new];
 actionCallbackObject.uri = [[YTUri alloc] initWithPath:@"home/messagelist/getmessage"];
 actionCallbackObject.actionCallbackBlock = ^(id result) {
  message = result;
 };
 [[YTRouterManager sharedRouterManager] runWithActionCallbackObject:actionCallbackObject];
 
 NSLog(@"message = %@", message);
}];

一些小想法

总结

您可能感兴趣的文章:

相关文章