WSRouter—一款轻量级路由跳转框架

简介

大约6个月前,笔者写了一个基于url-block的路由跳转框架,命名为WSRouter。这是一个轻量级框架,仅包含4个.m文件共400多行代码。虽然这个框架很轻,但并不代表其功能不完备,相反,这个框架的功能完全可以应付我们日常的开发需要。无论是对于项目使用还是学习参考,WSRouter都是一个不错的选择。 目前路由跳转方案有很多,有基于Target-action的跳转方案,有基于protocol-class的跳转方案,有基于url-Controller的跳转方案,还有本文所说的基于URL-Block的跳转方案。本文不对这些方案的优缺点进行对比,仅对WSRouter的基本功能和实现做一些简介,欢迎大家使用或star。为了便于陈述,基于URL-Controller和URL-Block统称为基于URL的跳转方案。

原理

基于URL的路由跳转本质上是有一个路由中介者管理着这些ViewController与URL的映射关系。每一个ViewController都有一个与之对应的URL。每添加一个ViewController我们都要注册一个能够唯一标识这个ViewController的URL到映射表中。如果是基于URL-block的方案,这个映射表中保存的是url-block的关系。当通过URL执行页面转场时,我们通过解析URL中的scheme、host、path。把这3者拼接成scheme://host/path的形式去注册表中查找对应的block或controller,然后解析URL中的query参数,用query参数配置这个ViewController对象。如果你对URL中的scheme、host、path、query等URL的各个部分不甚了解,下面的例子可以帮助你:

NSURL *url = [NSURL URLWithString:@"ws://www.ws.com/first?uid=999&bid=666"];
id query = url.query;               // uid=999&bid=666
id scheme = url.scheme;             // ws
id host = url.host;                 // www.ws.com
id path = url.path;                 // /first
id absString = url.absoluteString;  // WS://www.ws.com/first?uid=999&bid=666
id absUrl = url.absoluteURL;        // WS://www.ws.com/first?uid=999&bid=666

使用

下面的例子中,先在+(void)load方法中注册了url和block的映射关系。然后调用transferFromViewController:toURL:方法执行跳转。需要注意的是,我们在block的实现中创建了一个对应的控制器实例,然后用URL.query对控制器进行配置。通常,我们将需要传递个目的控制器的参数都拼接到URL.query中

push转场

#import "WSRouter.h"
+ (void)load {
    [self registerRouter];
}

// 注册路由
+ (void)registerRouter {
NSURL *url = [NSURL URLWithString:@"ws://www.ws.com/first"];    
    
    [WSRouter registerRouterWithPrefixURL:url handler:^UIViewController *(NSURL *URL, UIViewController *sourceViewController) {
       // 实例化控制器
        WSPushedViewController *destViewController = [[WSPushedViewController alloc] init];
        // 转场
        [WSRouter transferViewController:destViewController
                      fromViewController:sourceViewController
                              transition:WSTransitionPush];
        destViewController.params = [NSString ws_parameterFromURLQuery:URL.query];
        return destViewController;
    }];
}


// 执行跳转
 [WSRouter transferFromViewController:self
                                   toURL:[NSURL URLWithString:@"WS://www.ws.com/first?uid=666"]];

带回调的转场

还是上面那个例子,有时候我们从目的控制器返回到上一个控制器时,需要执行某些回调,我们仅需要把上例的transferFromViewController:toURL:换成transferFromViewController:toURL:viewWillDisappearCallBack:。这样在页面退出是即可执行回调通知上一个控制器执行一些操作。此外除了viewWillDisappearCallBack之外,WSRouter还支持viewDidDisappearCallBack。其实现使用了Method swizzling。

[WSRouter transferFromViewController:self
                               toURL:[NSURL URLWithString:@"WS://www.ws.com/first?uid=666"]
           viewWillDisappearCallBack:^(UIViewController *destViewController, id callbackData) {
               NSLog(@"%@",callbackData);
           }];

modal转场

如果需要以modal的方式转场,那么仅需要在注册的block中把transition改为WSTransitionPresent即可。如下:

+ (void)registerRouter {
    NSURL *url = [NSURL URLWithString:@"WS://www.ws.com/second"];
    [WSRouter registerRouterWithPrefixURL:url handler:^UIViewController *(NSURL *URL, UIViewController *sourceViewController) {
        UIViewController *destViewController = [[WSPresentedViewController alloc] init];
        [WSRouter transferViewController:destViewController
                      fromViewController:sourceViewController
                              transition:WSTransitionPresent];
        return destViewController;
    }];
}

同一个block跳转不同的页面

值得注意的是,并不是注册一个block只能跳转同一个viewController。我们也可以根据实际情况(比如url中的query参数不同)选择跳转不同的页面,WSRouter也是支持的。但是笔者并不支持这样做。如果我们的工程中存在一个block中根据if...else...语句跳转了不同的页面,那么我们可以考虑对这些不同的页面分开注册。如下: block中根据query中的web字段是否为ture来区分是否要跳转webViewController。这是一种解决方案,但更好的解决方案是对这两个控制器分开注册。

+ (void)registerRouter {
    // example: url ws://www.ws.com/detail?web=1&uid=999
    NSURL *url = [NSURL URLWithString:@"ws://www.ws.com/third"];
    [WSRouter registerRouterWithPrefixURL:url handler:^UIViewController *(NSURL *URL, UIViewController *sourceViewController) {
        UIViewController *destViewController = nil;
        
        NSDictionary *params = [NSString ws_parameterFromURLQuery:URL.query];
        if ([params[@"web"] boolValue]) {
            destViewController = [[WSWebViewController alloc] init];
        } else {
            destViewController = [[WSPushedViewController alloc] init];
        }
        
        [WSRouter transferViewController:destViewController
                      fromViewController:sourceViewController
                              transition:WSTransitionPush];
        return destViewController;
    }];
}

注意:注册的URL必须是有效的,需要包括scheme、host、path。如果目的控制器需要业务参数,我们还要在跳转URL中携带query部分。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

扫码关注云+社区

领取腾讯云代金券