Overview:
在多人开发环境中时常某个ViewController会引入大量的其他ViewController,例如:FirstViewController会引入SecondViewController、ThirdViewController。
大家肯定会遇见如下情景:
1. 个别时候由于需求的变更会时常修改ViewController名字,这样也就造成了个别文件需要手动修改名字。
2. 如果两个人在开发两个ViewController,如果同学A需要引入同学B的Controller时,只能让同学B开发者先把这个类submit一下,或者有其他解决方案。
3. 等等等
总之在iOS Develop里面#import "XxxViewController.h"这句话可谓是出现频率最高的一项了。尤其现在xcode时常无法寻找到其他类名,要死啦!
下面我给大家介绍一款全新的ViewController跳转方式,从此不用再需要import其他类了。
Open Source Framework HHRouter
HHRouter介绍:https://github.com/Huohua/HHRouter
HHRouter 不依赖于其他库,自己实现了一套简单的 Mapping 算法,性能特别不错,更优于同类Router框架,特别值得推荐使用,因为功能单一,所以性能很强,简单可依赖!
Simple Demo
我们只需要在AppDelegate.m里面引入如下代码:
[[HHRouter shared] map:@"one" toControllerClass:[OneViewController class]];
现在我们在任何一个ViewController里面去跳转这个OneViewController时,不需要在import这个文件了,只需要:
ViewController *vc = [[HHRouter shared] matchController:@"one"];
[self.navigationController pushViewController:vc animated:YES];
感觉是不是很简单啊?So easy!
如果你只想页面跳转跳转不需要考虑传值到此为止就可以了。
进阶!
传值
如果你想跳转的同时还要进行属性传值,那么你只需要在定义Router时候改为如下即可:
[[HHRouter shared] map:@"/user/:userId/" toControllerClass:[UserViewController class]];
跳转的时候改为如下:
ViewController *vc = [[HHRouter shared] matchController:@"/user/1/"];
[self.navigationController pushViewController:vc animated:YES];
在UserViewController里面加入测试:
NSLog(@"%@", self.params[@"userId"]);
输出:1
原理
因为当使用URL传值的时候,HHRouter会把相应的key和value放在params字典里面,params属性是在UIViewController Category里定义的:
@interface UIViewController (HHRouter)
@property (nonatomic, strong) NSDictionary *params;
@end
URL查询参数
URL查询参数也是支持,并且使用起来非常简单!
UIViewController *viewController = [[HHRouter shared] matchController:@"/user/1/?tabIndex=3"];
NSLog(@"%@", viewController.params[@"tabIndex"]);
输出:3
URL Schemes
如果你的app已经定义了一些URL schemes,HHRouter也可以解决。
UIViewController *viewController = [[HHRouter shared] matchController:@"hhrouter://user/1/"];
[viewController class] 等于 [UserViewController class]
UserViewController里面的params[@"userId"]值等于1
Block
- (void)map:(NSString *)route toBlock:(HHRouterBlock)block;
- (HHRouterBlock)matchBlock:(NSString *)route;
- (id)callBlock:(NSString *)route;
HHRouter还支持Block回调,如果感兴趣的同学可以看下.h文件,使用方式和视图跳转是一样的!
Block定义
[[HHRouter shared] map:@"block1" toBlock:^id(NSDictionary *params) {
NSLog(@"%@", params);
return @"test";
}];
因为返回值是id类型,所以,你可以返回数组,字典等等都可以!
调用有两种方式:
第一种:
HHRouterBlock block = [[HHRouter shared] matchBlock:@"block1"];
NSLog(@"%@", block(@{@"aaaaaa": @"aaaaa"}));
输出:
{
aaaaaa = aaaaa;
block = "<__NSGlobalBlock__: 0x1081a5120>";
route = block1;
}
test
第二种:
NSLog(@"%@", [[HHRouter shared] callBlock:@"block1"]);
输出:
{
block = "<__NSGlobalBlock__: 0x1081a5120>";
route = block1;
}
test
细心的同学看出来来了吧?
第一种调用方式会返回一个block可以往里面进行传值。
第二种是直接调用无需进行传值操作。
各位可以根据自己的业务需求来进行选择。
安装
CocoaPods
pod 'HHRouter', '~> 0.1.5'
手动
直接把GitHub里面的HHRouter.h和HHRouter.m文件引入到你的项目里面即可。
在你需要的ViewController里面import:
#import "HHRouter.h"
许可证:
HHRouter遵循MIT许可证
网友评论
Map URL patterns to viewController. Better in AppDelegate.
我刚接手一个项目,都是写在了 ViewController 中到 load 方法中,
不过我现在遇到一个更严重到问题: Storyboard 中到 ViewController 如何关联映射.
支持参数扩展,支持结果输出,支持异步处理,支持容错处理,支持scheme,host,port筛选过滤,支持适配器分组模式,支持目标解决方案
支持参数扩展,支持结果输出,支持异步处理,支持容错处理,支持scheme,host,port筛选过滤,支持适配器分组模式,支持目标解决方案