HHRouter解析

2019-05-04  本文已影响0人  jessica711

关于App内部的路由设计,主要需要解决2个问题:

1.各个页面和组件之间的跳转问题。

2.各个组件之间相互调用。

HHRouter从GitHub上获取源码

这是布丁动画的一个Router,灵感来自于ABRouterRoutable iOS

先来看看HHRouter的Api。它提供的方法非常清晰。

ViewController提供了2个方法。map是用来设置路由规则,matchController是用来匹配路由规则的,匹配争取之后返回对应的UIViewController。


-(void)map:(NSString*)route toControllerClass:(Class)controllerClass;

-(UIViewController*)matchController:(NSString*)route;

block闭包提供了三个方法,map也是设置路由规则,matchBlock:是用来匹配路由,找到指定的block,但是不会调用该block。callBlock:是找到指定的block,找到以后就立即调用。


-(void)map:(NSString*)route toBlock:(HHRouterBlock)block;

-(HHRouterBlock)matchBlock:(NSString*)route;

-(id)callBlock:(NSString*)route;

matchBlock:和callBlock:的区别就在于前者不会自动调用闭包。所以matchBlock:方法找到对应的block之后,如果想调用,需要手动调用一次。

除去上面这些方法,HHRouter还为我们提供了一个特殊的方法。


-(HHRouteType)canRoute:(NSString*)route;

这个方法就是用来找到执行路由规则对应的RouteType,RouteType总共就3种:


typedefNS_ENUM(NSInteger,HHRouteType){
HHRouteTypeNone=0,
HHRouteTypeViewController=1,
HHRouteTypeBlock=2
};

再来看看HHRouter是如何管理路由规则的。整个HHRouter就是由一个NSMutableDictionary *routes控制的。


@interfaceHHRouter()

@property(strong,nonatomic)NSMutableDictionary*routes;

@end

image

别看只有这一个看似“简单”的字典数据结构,但是HHRouter路由设计的还是很精妙的。


-(void)map:(NSString*)route toBlock:(HHRouterBlock)block

{

NSMutableDictionary*subRoutes=[selfsubRoutesToRoute:route];

subRoutes[@"_"]=[block copy];

}

-(void)map:(NSString*)route toControllerClass:(Class)controllerClass

{

NSMutableDictionary*subRoutes=[selfsubRoutesToRoute:route];

subRoutes[@"_"]=controllerClass;

}

上面两个方法分别是block闭包和ViewController设置路由规则调用的方法实体。不管是ViewController还是block闭包,设置规则的时候都会调用subRoutesToRoute:方法。


-(NSMutableDictionary*)subRoutesToRoute:(NSString*)route

{

NSArray*pathComponents=[selfpathComponentsFromRoute:route];

NSInteger index=0;

NSMutableDictionary*subRoutes=self.routes;

while(index<pathComponents.count)

{

NSString*pathComponent=pathComponents[index];

if(![subRoutes objectForKey:pathComponent])

{

subRoutes[pathComponent]=[[NSMutableDictionary alloc]init];

}

subRoutes=subRoutes[pathComponent];

index++;

}

returnsubRoutes;

}

上面这段函数就是来构造路由匹配规则的字典。

举个例子:


[[HHRouter shared]map:@"/user/:userId/"toControllerClass:[UserViewController class]];

[[HHRouter shared]map:@"/story/:storyId/"toControllerClass:[StoryViewController class]];

[[HHRouter shared]map:@"/user/:userId/story/?a=0"toControllerClass:[StoryListViewController class]];

设置3条规则以后,按照上面构造路由匹配规则的字典的方法,该路由规则字典就会变成这个样子:


{

story={

":storyId"={

"_"=StoryViewController;

};

};

user={

":userId"={

"_"=UserViewController;

story={"_"=StoryListViewController;};

};

};

}

路由规则字典生成之后,等到匹配的时候就会遍历这个字典。

假设这时候有一条路由过来:


[[[HHRouter shared]matchController:@"hhrouter20://user/1/"]class];

HHRouter对这条路由的处理方式是先匹配前面的scheme,如果连scheme都不正确的话,会直接导致后面匹配失败。

然后再进行路由匹配,最后生成的参数字典如下:


{

"controller_class"=UserViewController;
route="/user/1/";
userId=1;

}

具体的路由参数匹配的函数在


-(NSDictionary*)paramsInRoute:(NSString*)route

这个方法里面实现的。这个方法就是按照路由匹配规则,把传进来的URL的参数都一一解析出来,带?号的也都会解析成字典。这个方法没什么难度,就不在赘述了。

ViewController 的字典里面默认还会加上2项:

"controller_class"=

route=

route里面都会保存传过来的完整的URL。

如果传进来的路由后面带访问字符串呢?那我们再来看看:


[[HHRouter shared]matchController:@"/user/1/?a=b&c=d"];

那么解析出所有的参数字典会是下面的样子:


{

a=b;

c=d;

"controller_class"=UserViewController;

route="/user/1/?a=b&c=d";
userId=1;

}

同理,如果是一个block闭包的情况呢?

还是先添加一条block闭包的路由规则:


[[HHRouter shared]map:@"/user/add/"toBlock:^id(NSDictionary*params){}];

这条规则对应的会生成一个路由规则的字典。


{

story={

":storyId"={
"_"=StoryViewController;
};

};

user={

":userId"={

"_"=UserViewController;

story={"_"=StoryListViewController;

};

};

add={

"_"="<__NSMallocBlock__: 0x600000240480>";

};

};

}

注意”_”后面跟着是一个block。

匹配block闭包的方式有两种。

// 1.第一种方式匹配到对应的block之后,还需要手动调用一次闭包。HHRouterBlock block=[[HHRouter shared]matchBlock:@"/user/add/?a=1&b=2"];block(nil);// 2.第二种方式匹配block之后自动会调用改闭包。[[HHRouter shared]callBlock:@"/user/add/?a=1&b=2"];

匹配出来的参数字典是如下:


{

a=1;

b=2;

block="<__NSMallocBlock__: 0x600000056b90>";

route="/user/add/?a=1&b=2";

}

block的字典里面会默认加上下面这2项:

block=

route=

route里面都会保存传过来的完整的URL。

生成的参数字典最终会被绑定到ViewController的Associated Object关联对象上。


-(void)setParams:(NSDictionary*)paramsDictionary{

objc_setAssociatedObject(self,&kAssociatedParamsObjectKey,paramsDictionary,OBJC_ASSOCIATION_RETAIN_NONATOMIC);

}

-(NSDictionary*)params{

returnobjc_getAssociatedObject(self,&kAssociatedParamsObjectKey);

}

这个绑定的过程是在match匹配完成的时候进行的。


-(UIViewController*)matchController:(NSString*)route{

NSDictionary*params=[selfparamsInRoute:route];

Class controllerClass=params[@"controller_class"];

UIViewController*viewController=[[controllerClass alloc]init];

if([viewController respondsToSelector:@selector(setParams:)]){

[viewController performSelector:@selector(setParams:)withObject:[params copy]];

}

returnviewController;

}

最终得到的ViewController也是我们想要的。相应的参数都在它绑定的params属性的字典里面。

将上述过程图解出来,如下:

image

参考:https://halfrost.com/ios_router/

上一篇下一篇

猜你喜欢

热点阅读