查看: 303|回复: 0

[IOS开发教程] iOS 模块化之JLRoute路由示例

发表于 2018-4-13 08:00:05

JLRoutes是一个调用极少代码 , 可以很方便的处理不同URL schemes以及解析它们的参数,并通过回调block来处理URL对应的操作 , 可以用于处理复杂跳转逻辑的三方库.

1.在日常开发中 , push , present 出现在整个程序的各个地方 , 如果你想快速理清一个项目的整体逻辑 , 非常麻烦 . 大多数情况 , 你得找到代码目录 ,根据层级结构分出关系 , 然后找到对应的push位置 , 寻找下一级页面 , 如果本身项目的目录就非常乱 , 那么如果要了解一个项目的整体跳转逻辑 , 非常的难.

即便可以将 UIViewController-Swizzled 库集成到项目中 ,然后一页一页点击查询 , 但也是比较痛苦的.

如果 , 是把整个项目的跳转逻辑都给抽取出来 , 单独放在一个类 , 模块化管理 , 那么思路就会清晰很多 , 甚至可以用XMind根据代码画出整个项目的树状图

2.如果所处公司存在多个app , app之间互相推荐 , 互相跳转是再正常不过的需求,就类似于QQ , 微信三方分享跳转等 .如果用Appdelegate原生方法进行拦截 , 所做的事至少得是判断Scheme是否匹配 , 想办法进入需要跳到的界面 , 如果要涉及传参 , 就更加麻烦.

3. 如果用户是从PC端识别二维码,或者通过链接想要进入app指定页面

基于 JLRoute 实现的模块化示例,包括链接跳转原生页面、WebView页面和ReactNative页面

模块化已经成为调剂庞大项目结构的一剂良药,对项目的开发、维护和后续的扩展的好处已经不言而喻。

要求

  1. iOS 8.0+
  2. Xcode 7.0+

安装方法

安装

在 iOS, 你需要在 Podfile 中添加.

  1. source 'https://github.com/CocoaPods/Specs.git'
  2. platform :ios, '9.0'
  3. use_frameworks!
  4. pod 'JLRoutes', '~> 2.0.1'
  5. # 'node_modules'目录一般位于根目录中
  6. # 但是如果你的结构不同,那你就要根据实际路径修改下面的`:path`
  7. pod 'React', :path => './node_modules/react-native', :subspecs => [
  8. 'Core',
  9. 'RCTText',
  10. 'RCTNetwork',
  11. 'RCTWebSocket', # 这个模块是用于调试功能的
  12. # 在这里继续添加你所需要的模块
  13. ]
  14. # 如果你的RN版本 >= 0.42.0,请加入下面这行
  15. pod "Yoga", :path => "./node_modules/react-native/ReactCommon/yoga"
复制代码

启动 ReactNative 环境

1.修改项目ModuleARNPageViewController.m IP 跳转地址

2.进入项目所在目录,运行

  1. npm start
复制代码

JLRoutes的工作流程和原理

单一的Scheme注册过程:

1.调用注册方法(用户注册routePattern,默认优先级0)

代码如下:
- (void)addRoute:(NSString *)routePattern handler:(BOOL (^__nullable)(NSDictionary *parameters))handlerBlock;

2.路由解析(这些解析跟我们设置路由的规则有直接关系)

(1)判断接口URL是否设置可选性URL并将对应的URL封装成JLRRouteDefinition对象

(2)将JLRRouteDefinition对象装载进一个可变数组,内存保留了所有的对象!!

(JLRRouteDefinition对象包括有路径,参数解析,block等信息)

单一的Scheme调用过程:

1.调用URL

  1. + (BOOL)routeURL:(NSURL *)URL
复制代码

2.解析URL,将参数,路由信息封装成JLRRouteRequest对象

代码如下:
- (instancetype)initWithURL:(NSURL *)URL alwaysTreatsHostAsPathComponent:(BOOL)alwaysTreatsHostAsPathComponent

3.给JLrouteRequest对象和路由数组里的JLRRouteDefinition对象作比对,并且返回JLRRouteResponse 对象抽出参数和URL在数组里

代码如下:
JLRRouteResponse *response = [route routeResponseForRequest:request decodePlusSymbols:shouldDecodePlusSymbols];

4.调用JLRRouteResponse 对象里面的回调方法

  1. [route callHandlerBlockWithParameters:finalParameters];
复制代码

JLRoutes的URL注册规则:

1.普通注册

  1. JLRoutes *routes = [JLRoutes globalRoutes];
  2. [routes addRoute:@"/user/view/:userID" handler:^BOOL(NSDictionary *parameters) {
  3. NSString *userID = parameters[@"userID"]; // defined in the route by specifying ":userID"
  4. // present UI for viewing user with ID 'userID'
  5. return YES; // return YES to say we have handled the route
  6. }];
复制代码

URL里,分号表示这个是参数

另外一种注册方式,下标注册法

  1. JLRoutes.globalRoutes[@"/route/:param"] = ^BOOL(NSDictionary *parameters) {
  2. // ...
  3. };
复制代码

如何按照以上的方式注册,在任何时刻(包括在其它的APP)你都可以调用这个URL。

  1. NSURL *viewUserURL = [NSURL URLWithString:@"myapp://user/view/joeldev"];
  2. [[UIApplication sharedApplication] openURL:viewUserURL];
复制代码

在这个例子中,在parmameters字典里面的userID会传给block,它是一个键值对。”userID”: “joeldev”。给UI层或者任何需要它的地方用的。

字典参数:

字典参数总包括至少一下3个键:

  1. {
  2. "JLRouteURL": "(the NSURL that caused this block to be fired)",
  3. "JLRoutePattern": "(the actual route pattern string)",
  4. "JLRouteScheme": "(the route scheme, defaults to JLRoutesGlobalRoutesScheme)"
  5. }
复制代码

处理Block

你会发现,每个注册的block都会返回一个YES。这个值,如果你返回NO,JLRoutes会跳过这个匹配,然后继续去匹配其它的。

如果你的block设置成nil,它会默认返回YES。

2.复杂注册

  1. [[JLRoutes globalRoutes] addRoute:@"/:object/:action/:primaryKey" handler:^BOOL(NSDictionary *parameters) {
  2. NSString *object = parameters[@"object"];
  3. NSString *action = parameters[@"action"];
  4. NSString *primaryKey = parameters[@"primaryKey"];
  5. // stuff
  6. return YES;
  7. }];
复制代码

这个地址会被匹配很多URL,如/user/view/joeldev or /post/edit/123。这些URL上的是参数。

  1. NSURL *editPost = [NSURL URLWithString:@"myapp://post/edit/123?debug=true&foo=bar"];
  2. [[UIApplication sharedApplication] openURL:editPost];
复制代码

这时,pramater字典就会是以下这样的(传参)

  1. {
  2. "object": "post",
  3. "action": "edit",
  4. "primaryKey": "123",
  5. "debug": "true",
  6. "foo": "bar",
  7. "JLRouteURL": "myapp://post/edit/123?debug=true&foo=bar",
  8. "JLRoutePattern": "/:object/:action/:primaryKey",
  9. "JLRouteScheme": "JLRoutesGlobalRoutesScheme"
  10. }
复制代码

3.Scheme(有没有多态的感觉)

JLRoutes支持用指定的URL scheme来创建路由。相同的scheme才能被匹配。默认地,所有的URL会设置进global scheme。

  1. [[JLRoutes globalRoutes] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
  2. // This block is called if the scheme is not 'thing' or 'stuff' (see below)
  3. return YES;
  4. }];
  5. [[JLRoutes routesForScheme:@"thing"] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
  6. // This block is called for thing://foo
  7. return YES;
  8. }];
  9. [[JLRoutes routesForScheme:@"stuff"] addRoute:@"/foo" handler:^BOOL(NSDictionary *parameters) {
  10. // This block is called for stuff://foo
  11. return YES;
  12. }];
  13. 如果你调用的使用,是这样调用的
  14. [[JLRoutes globalRoutes] addRoute:@"/global" handler:^BOOL(NSDictionary *parameters) {
  15. return YES;
  16. }];
复制代码

它只会调用global scheme的对应的URL。不会调用ting scheme里面对应的URL。

当然,你可以设置,如果指定的scheme没有这个URL,去查询global scheme 有没有。你需要设置一个属性。

  1. [JLRoutes routesForScheme:@"thing"].shouldFallbackToGlobalRoutes = YES;
复制代码

3.通配符的设置URL的方式

通配符为:*

通配符符后面所有的URL上的参数都会以一个数组保存在parameters字典里面的JLRouteWildcardComponentsKey对应的value里。

例如,如果你注册URL如下:

  1. [[JLRoutes globalRoutes] addRoute:@"/wildcard/*" handler:^BOOL(NSDictionary *parameters) {
  2. NSArray *pathComponents = parameters[JLRouteWildcardComponentsKey];
  3. if ([pathComponents count] > 0 && [pathComponents[0] isEqualToString:@"joker"]) {
  4. // the route matched; do stuff
  5. return YES;
  6. }
  7. // not interested unless the joker's in it
  8. return NO;
  9. }];
复制代码

如果调用的URL开始是/wildcard,这个路由就可能被触发!!如果第一个参数是joker,就被触发,如果不是,就被拒绝触发。。。

4.选择性路由

如果路由地址设置样式有括号,如:/the(/foo/:a)(/bar/:b),其实它代表的URL有如下:

  1. /the/foo/:a/bar/:b
  2. /the/foo/:a
  3. /the/bar/:b
  4. /the
复制代码

5.查询 Routes

下面的方式,你可以查看Routes里所有注册的URL Routes。

  1. /// All registered routes, keyed by scheme
  2. + (NSDictionary <NSString *, NSArray <JLRRouteDefinition *> *> *)allRoutes;
  3. /// Return all registered routes in the receiving scheme namespace.
  4. - (NSArray <JLRRouteDefinition *> *)routes;
复制代码

自定义路由解析 如果你想自己定制一个路由编辑,你可以继承JLRouteDefinition并且用 addRoute:方法去添加你自定义类的对象。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持程序员之家。



回复

使用道具 举报