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

iOS FFRouter 2022-06-01 13:06:11 336人浏览泡泡鱼

摘要

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

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<NSString *, id> *)parameters;


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


+ (id)routeObjectURL:(NSString *)URL withParameters:(NSDictionary<NSString *, id> *)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<NSDictionary *> *)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<NSDictionary *> *)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;

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

--结束END--

本文标题: 浅谈强大易用支持URL Rewrite的iOS路由库FFRouter

本文链接: https://lsjlt.com/news/30206.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341