酷应用

iOS 撸一个简单路由Router

百家 作者：iOS开发 2018-09-26 12:58:14

程序员大咖
点击右侧关注，免费进阶高级！


作者：changsanjiang

https://www.jianshu.com/p/13c42f4e9af1


平常开发中用户点击头像， 进入个人主页，这看似平常的操作， 背后极有可能会牵扯到多个模块。 再如： 视频模块的播放页， 有与视频相关的音乐，点击这些音乐，需要跳转到音乐模块的播放页， 这样视频与音乐模块之间，不可避免的会产生依赖或耦合。 这个问题让人脑壳疼，相信很多朋友都这样做过，写一些代理或通知， 不停的传递事件； 有时干脆直接导入另一个模块。


因为我在公司独立开发， 顾及少一点，可以拿公司项目做实践，在尝试组件化的过程中， 了解到了路由， 对于解决上述问题， 有极大的帮助。因此我想总结并与大家分享一下。


接口预览


  • Router

NS_ASSUME_NONNULL_BEGIN
@interface SJRouter : NSObject
+ (instancetype)shared;

- (void)handleRequest:(SJRouteRequest *)request completionHandler:(SJCompletionHandler)completionHandler;
@end
NS_ASSUME_NONNULL_END


  • RouteRequest

NS_ASSUME_NONNULL_BEGIN
@interface SJRouteRequest : NSObject
- (instancetype)initWithURL:(NSURL *)URL;
- (instancetype)initWithPath:(NSString *)requestPath parameters:(nullable SJParameters)parameters;
@property (nonatomic, strong, readonly) NSString *requestPath;
@property (nonatomic, strong, readonly, nullable) SJParameters prts;
- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new  NS_UNAVAILABLE;
@end
NS_ASSUME_NONNULL_END


  • RouteHandlerProtocol

NS_ASSUME_NONNULL_BEGIN
typedef id SJParameters;

@protocol SJRouteHandler
+ (NSString *)routePath;
+ (void)handleRequestWithParameters:(nullable SJParameters)parameters topViewController:(UIViewController *)topViewController completionHandler:(nullable SJCompletionHandler)completionHandler;
@end
NS_ASSUME_NONNULL_END


流程


简单的讲，app应用中，路由识别一个请求， 将它分派给对应的handler进行处理。 这个流程非常像发送一个网络请求（拼接参数=>发起请求=>回调）。


同样的，当Router收到下面的请求时(请求视频播放页)：

- (void)push:(id)sender {
    SJRouteRequest *request = [[SJRouteRequest alloc] initWithPath:@"video/playbackInfo" parameters:@{@"video_id":@(111)}];
    [SJRouter.shared handleRequest:request completionHandler:^(id  _Nullable result, NSError * _Nullable error) {
#ifdef DEBUG
        NSLog(@"%d - %s", (int)__LINE__, __func__);
#endif
    }];
}


会尝试识别路由， 找到匹配的handler，传递必要参数：

@implementation SJRouter
- (void)handleRequest:(SJRouteRequest *)request completionHandler:(SJCompletionHandler)completionHandler {
    NSParameterAssert(request); if ( !request ) return;
    Class handler = _handlersM[request.requestPath];
    if ( handler ) {
        [handler handleRequestWithParameters:request.requestPath topViewController:_sj_get_top_view_controller() completionHandler:completionHandler];
    }
    else {
        printf("
 (-_-) Unhandled request: %s", request.description.UTF8String);
    }
}
@end


最后handler进行处理。

@implementation TestViewController
+ (NSString *)routePath {
    return @"video/playbackInfo";
}

+ (void)handleRequestWithParameters:(nullable SJParameters)parameters topViewController:(UIViewController *)topViewController completionHandler:(nullable  SJCompletionHandler)completionHandler {
    TestViewController *vc = [TestViewController new];
    vc.completionHandler = completionHandler;
    [topViewController.navigationController pushViewController:vc animated:YES];
}
@end


至此， 我们再回过头看刚开始举的那个例子：
视频模块的播放页， 有与视频相关的音乐，点击这些音乐，需要跳转到音乐模块的播放页。
此时，可以让视频模块依赖Router， 进行跳转请求。这看起来都是依赖，实则两者差别很大了。


  • 路由不止能处理跳转音乐模块的请求， 依赖也从多个变成只依赖Router即可。。。

  • 在删除某个依赖模块时， 需要删除依赖的代码， 很烦的， 对吧。

  • 吧啦吧啦吧啦吧啦吧啦。。。


所以点击跳转音乐模块，可以替换成如下操作, 发起请求：

SJRouteRequest *request = [[SJRouteRequest alloc] initWithPath:@"audio/playbackInfo" parameters:@{@"audio_id":@(232)}];
    [SJRouter.shared handleRequest:request completionHandler:^(id  _Nullable result, NSError * _Nullable error) {
#ifdef DEBUG
        NSLog(@"%d - %s", (int)__LINE__, __func__);
#endif
    }];

router找到对应的handler， 让其进行处理。



Handler


从开始到现在，可以看出Handler就是最终执行请求的那个家伙。 相信大家都有疑问， 如何成为一个Handler？


很简单，它是自动的(参见Router)， 只要某个类遵守了SJRouteHandlerProtocol， 它便成为了一个Handler。再来看一遍协议吧。


NS_ASSUME_NONNULL_BEGIN
typedef id SJParameters;

@protocol SJRouteHandler
+ (NSString *)routePath;
+ (void)handleRequestWithParameters:(nullable SJParameters)parameters topViewController:(UIViewController *)topViewController completionHandler:(nullable SJCompletionHandler)completionHandler;
@end
NS_ASSUME_NONNULL_END


  • routePath： 即路径， 表示handler能够处理的路径。当发起请求时， Router会通过路径获取到对应的handler， 交给其进行处理。

  • handleRequestWithParameters。。。： handler进行的处理。



Router


在整个请求过程中，Router做的事情实质上就是在众多Handler中寻找命中注定的那一个。如何寻找呢？为什么遵守了SJRouteHandlerProtocol便自动成为了Handler呢？


这自然要归功于Runtime的强大力量，我们先看如何实现吧。


@implementation SJRouter 
- (instancetype)init {
    self = [super init];
    if ( !self ) return nil;
    _handlersM = [NSMutableDictionary new];
    int count = objc_getClassList(NULL, 0);
    Class *classes = (Class *)malloc(sizeof(Class) * count); objc_getClassList(classes, count);
    Protocol *p_handler = @protocol(SJRouteHandler);
    for ( int i = 0 ; i <  count ; ++ i ) {
        Class cls = classes[i];
        for ( Class thisCls = cls ; nil != thisCls ; thisCls = class_getSuperclass(thisCls) ) {
            if ( !class_conformsToProtocol(thisCls, p_handler) ) continue;
            if ( ![(id)thisCls respondsToSelector:@selector(routePath)] ) continue;
            if ( ![(id)thisCls respondsToSelector:@selector(handleRequestWithParameters:topViewController:completionHandler:)] ) continue;
            _handlersM[[(id)thisCls routePath]] = thisCls;
            break;
        }
    }
    if ( classes ) free(classes);
    return self;
}
@end


  • objc_getClassList： 很明显了， 获取App所有类。

  • class_conformsToProtocol： 该类是否遵守某个协议。


得益于Runtime的这两个函数，即可获取到众多的Handler。 当发起请求时， 在众多Handler中寻找注定的那一个， 岂不是易如反掌。


注: 关于优化两层for循环的问题, 我在文章最后补更了一下. (2018年09月18日)



Request


App发起的跳转请求，更多到是内部页面之间的跳转， 我们最需要关注的就是它的路径，所以整个路由都是围绕着路径去跳转的， 而像URL中的scheme和host，体现出来的作用倒是不大。


因此， Request持有每个请求的路径， 以及必要的参数， 之后再无多余操作。



好了， 就到这里了。


下面是项目地址， 有兴趣到话可以与我一起交流哦。。。


https://github.com/changsanjiang/SJRouter


Email: changsanjiang@gmail.com


最后，文章难免会有疏漏与考虑不周之处， 望请大家指正。



2018年09月18日19:25:09  优化for循环补更:


关于Router初始化时, 两层for循环效率问题的解决, 引用自这边简文: https://www.jianshu.com/p/534eccb63974. 故完善后的代码如下:


- (instancetype)init {
    self = [super init];
    if ( !self ) return nil;
    _handlersM = [NSMutableDictionary new];

    /// Thanks @yehot, @Potato121
    /// https://www.jianshu.com/p/534eccb63974
    /// https://github.com/changsanjiang/SJRouter/pull/1

    unsigned int cls_count = 0;
    NSString *app_img = [NSBundle mainBundle].executablePath;
    const char **classes = objc_copyClassNamesForImage([app_img UTF8String], &cls_count);
    Protocol *p_handler = @protocol(SJRouteHandler);
    for ( unsigned int i = 0 ; i <  cls_count ; ++ i ) {
        const char *cls_name = classes[i];
        NSString *cls_str = [NSString stringWithUTF8String:cls_name];
        Class cls = NSClassFromString(cls_str);
        if ( ![cls conformsToProtocol:p_handler] ) continue;
        if ( ![(id)cls respondsToSelector:@selector(routePath)] ) continue;
        if ( ![(id)cls respondsToSelector:@selector(handleRequestWithParameters:topViewController:completionHandler:)] ) continue;
        _handlersM[[(id)cls routePath]] = cls;
    }
    if ( classes ) free(classes);
    return self;
}


【点击成为源码大神】

关注公众号：拾黑（shiheibook）了解更多

[广告]赞助链接：

四季很好，只要有你，文娱排行榜：https://www.yaopaiming.com/
让资讯触达的更精准有趣：https://www.0xu.cn/

*文章为作者独立观点，不代表 爱尖刀 立场
本文由 iOS开发发表，转载此文章须经作者同意，并请附上出处( 爱尖刀 )及本页链接。
原文链接 https://www.ijiandao.com/2b/baijia/170682.html
IOS
图库
iOS开发 iOS开发
公众号 关注网络尖刀微信公众号
随时掌握互联网精彩
赞助链接
百度热搜榜
排名 热点 搜索指数
iTrust
AiDeep Ued
关于我们 联系我们 升级日志 法律声明 广告服务 侵删通道
Copyright © 2021 K2CMS All rights reserved.
京ICP备14006288号