浅谈强大易用支持URL Rewrite的iOS路由库FFRouter

FFRouter 是 iOS 中一个强大且易用的 URL 路由库，支持 URL Rewrite，使 APP 在发布之后也可以动态修改相关路由逻辑。基于匹配查找 URL，效率高。集成和使用都非常简单！

Github链接：FFRouter

功能

• 具备基本的 URL 注册、Route、取消注册、打印 Log 等
• 支持使用通配符(*)注册 URL
• 支持 URL Rewrite
• 支持 Rewrite 时获取原 URL 参数或 URLComponents，并可对其进行URL Encode或 Decode
• 支持通过 URL 获取 Object
• 支持 Route URL 时传递非常规对象
• 支持 Route 一个未注册的 URL 时统一回调

安装

CocoaPods
target 'MyApp' do
 pod 'FFRouter'
end

运行 pod install

手动安装

添加其中的 FFRouter 文件夹到自己项目

使用方法

首先

#import "FFRouter.h"

1、基本使用

+ (void)registerRouteURL:(NSString *)routeURL handler:(FFRouterHandler)handlerBlock;


+ (void)registerObjectRouteURL:(NSString *)routeURL handler:(FFObjectRouterHandler)handlerBlock;




+ (BOOL)canRouteURL:(NSString *)URL;




+ (void)routeURL:(NSString *)URL;


+ (void)routeURL:(NSString *)URL withParameters:(NSDictionary *)parameters;


+ (id)routeObjectURL:(NSString *)URL;


+ (id)routeObjectURL:(NSString *)URL withParameters:(NSDictionary *)parameters;




+ (void)routeUnregisterURLHandler:(FFRouterUnregisterURLHandler)handler;




+ (void)unregisterRouteURL:(NSString *)URL;


+ (void)unregisterAllRoutes;



+ (void)setLogEnabled:(BOOL)enable;

【备注】

(1)注册 URL:

[FFRouter registerRouteURL:@"protocol://page/routerDetails/:id" handler:^(NSDictionary *routerParameters) {
 //Route的URL与本次注册URL匹配时的回调 
}];

[FFRouter registerRouteURL:@"wildcard:/
+ (NSString *)rewriteURL:(NSString *)url;


+ (void)addRewriteMatchRule:(NSString *)matchRule targetRule:(NSString *)targetRule;


+ (void)addRewriteRules:(NSArray *)rules;


+ (void)removeRewriteMatchRule:(NSString *)matchRule;


+ (void)removeAllRewriteRules;

【备注】

(1)可以使用正则添加一条 Rewrite 规则，例如：要实现打开 URL:https://www.taobao.com/search/原子弹时，将其拦截，改用本地已注册的URL:protocol://page/routerDetails?product=原子弹打开。

首先添加一条 Rewrite 规则：

[FFRouterRewrite addRewriteMatchRule:@"(?:https://)?www.taobao.com/search/(.*)" targetRule:@"protocol://page/routerDetails?product=$1"];

之后在打开URL:https://www.taobao.com/search/原子弹时，将会 Rewrite 到URL:protocol://page/routerDetails?product=原子弹。

[FFRouter routeURL:@https://www.taobao.com/search/原子弹];

(2)可以通过以下方法同时增加多个规则：

+ (void)addRewriteRules:(NSArray *)rules;

其中 rules 格式必须为以下格式：

@[@{@"matchRule":@"YourMatchRule1",@"targetRule":@"YourTargetRule1"},
 @{@"matchRule":@"YourMatchRule2",@"targetRule":@"YourTargetRule2"},
 @{@"matchRule":@"YourMatchRule3",@"targetRule":@"YourTargetRule3"},]

(3)Rewrite 规则中的保留字：

• 通过 $scheme、$host、$port、$path、$query、$fragment 获取标准 URL 中的相应部分。通过$url获取完整 URL
• 通过 $1、$2、$3...获取matchRule的正则中使用圆括号取出的参数
• $：原变量的值、$$：原变量URL Encode后的值、$#：原变量URL Decode后的值

例如：https://www.taobao.com/search/原子弹对于Rewrite 规则(?:https://)?www.taobao.com/search/(.*)

$1=原子弹
$$1=%e5%8e%9f%e5%ad%90%e5%bc%b9

同样，https://www.taobao.com/search/%e5%8e%9f%e5%ad%90%e5%bc%b9对于Rewrite 规则(?:https://)?www.taobao.com/search/(.*)

$1=%e5%8e%9f%e5%ad%90%e5%bc%b9
$#1=原子弹

3、FFRouterNavigation

考虑到经常用路由配置UIViewController之间的跳转，所以增加了额外的工具FFRouterNavigation来更方便地控制UIViewController之间的跳转。具体使用方法如下：

+ (void)autoHidesBottomBarWhenPushed:(BOOL)hide;

 


+ (UIViewController *)currentViewController;


+ (nullable UINavigationController *)currentNavigationViewController;

 


+ (void)pushViewController:(UIViewController *)viewController animated:(BOOL)animated;


+ (void)pushViewController:(UIViewController *)viewController replace:(BOOL)replace animated:(BOOL)animated;


+ (void)pushViewControllerArray:(NSArray *)viewControllers animated:(BOOL)animated;


+ (void)presentViewController:(UIViewController *)viewController animated:(BOOL)animated completion:(void (^ __nullable)(void))completion;

 


+ (void)closeViewControllerAnimated:(BOOL)animated;

 以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对考高分网的支持。