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

概述浅谈强大易用支持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 支

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 时统一回调

安装

CocoaPodstarget 'MyApp' do pod 'FFRouter'end

运行@H_403_31@ pod install

手动安装

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

使用方法

首先

#import "FFRouter.h"

1、基本使用

/** 注册 url @param routeURL 要注册的 URL @param handlerBlock URL 被 Route 后的回调 */+ (voID)registerRouteURL:(Nsstring *)routeURL handler:(FFRouterHandler)handlerBlock;/** 注册 URL,通过该方式注册的 URL 被 Route 后可返回一个 Object @param routeURL 要注册的 URL @param handlerBlock URL 被 Route 后的回调,可在回调中返回一个 Object */+ (voID)registerObjectRouteURL:(Nsstring *)routeURL handler:(FFObjectRouterHandler)handlerBlock;/** 判断 URL 是否可被 Route（是否已经注册） @param URL 要判断的 URL @return 是否可被 Route */+ (BOol)canRouteURL:(Nsstring *)URL;/** Route 一个 URL @param URL 要 Router 的 URL */+ (voID)routeURL:(Nsstring *)URL;/** Route 一个 URL，并带上额外参数 @param URL 要 Router 的 URL @param parameters 额外参数 */+ (voID)routeURL:(Nsstring *)URL withParameters:(NSDictionary<Nsstring *,ID> *)parameters;/** Route 一个 URL，可获得返回的 Object @param URL 要 Router 的 URL @return 返回的 Object */+ (ID)routeObjectURL:(Nsstring *)URL;/** Route 一个 URL，并带上额外参数，可获得返回的 Object @param URL 要 Router 的 URL @param parameters 额外参数 @return 返回的 Object */+ (ID)routeObjectURL:(Nsstring *)URL withParameters:(NSDictionary<Nsstring *,ID> *)parameters;/** Route 一个未注册 URL 时回调 @param handler 回调 */+ (voID)routeUnregisterURLHandler:(FFRouterUnregisterURLHandler)handler;/** 取消注册某个 URL @param URL 要被取消注册的 URL */+ (voID)unregisterRouteURL:(Nsstring *)URL;/** 取消注册所有 URL */+ (voID)unregisterallRoutes;/** 是否显示 Log，用于调试 @param enable YES or NO，默认为 NO */+ (voID)setLogEnabled:(BOol)enable;

【备注】

(1)注册 URL:

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

可通过routerParameters获取 URL 中的参数，routerParameters[FFRouterParameterURLKey]为完整的URL.

(2)当需要通过以下方法：

+ (ID)routeObjectURL:(Nsstring *)URL;

Route 一个 URL 并获取返回值时，需要使用如下方法注册 URL：

+ (voID)registerObjectRouteURL:(Nsstring *)routeURL handler:(FFObjectRouterHandler)handlerBlock;

并在 handlerBlock 中返回需要返回的 Object，例如：

//注册并返回必要的值[FFRouter registerObjectRouteURL:@"protocol://page/routerObjectDetails" handler:^ID(NSDictionary *routerParameters) {  Nsstring *str = @“根据需要返回必要的Object”;  return str; }];//获取返回的值Nsstring *ret = [FFRouter routeObjectURL:@"protocol://page/routerObjectDetails"];

(3)如果需要传递非常规对象作为参数，如UIImage等，可使用如下方式：

[FFRouter routeURL:@"protocol://page/routerDetails?nickname=imlifengfeng" withParameters:@{@"img":[UIImage imagenamed:@"router_test_img"]}];

2、URL Rewrite

/** 根据设置的 Rules 去 rewrite 一个 URL @param url 将被 rewrite 的 URL @return rewrite 后的 URL */+ (Nsstring *)rewriteURL:(Nsstring *)url;/** 添加一个 RewriteRule @param matchRule 正则匹配规则 @param targetRule 转换规则 */+ (voID)addRewriteMatchRule:(Nsstring *)matchRule targetRule:(Nsstring *)targetRule;/** 同时添加多个 RewriteRule，格式必须为：@[@{@"matchRule":@"YourMatchRule",@"targetRule":@"YourTargetRule"},...] @param rules RewriteRules */+ (voID)addRewriteRules:(NSArray<NSDictionary *> *)rules;/** 移除一个 RewriteRule @param matchRule 将被移除的 matchRule */+ (voID)removeRewriteMatchRule:(Nsstring *)matchRule;/** 移除所有 RewriteRule */+ (voID)removeAllRewriteRules;

【备注】

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

首先添加一条 Rewrite 规则：

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

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

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

(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/原子d对于Rewrite 规则(?:https://)?www.taobao.com/search/(.*)

=原子d$=%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/(.*)

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

3、FFRouterNavigation

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

/** push 时是否自动隐藏底部Tabbar @param hIDe 是否自动隐藏，默认为 NO */+ (voID)autoHIDesBottombarWhenPushed:(BOol)hIDe;/** 获取当前 VIEwController @return 当前 VIEwController */+ (UIVIEwController *)currentVIEwController;/** 获取当前 NavigationVIEwController @return return 当前 NavigationVIEwController */+ (nullable UINavigationController *)currentNavigationVIEwController;/** Push VIEwController @param vIEwController 被 Push 的 VIEwController @param animated 是否使用动画 */+ (voID)pushVIEwController:(UIVIEwController *)vIEwController animated:(BOol)animated;/** Push VIEwController，可设置当前 VIEwController 是否还保留 @param vIEwController 被 Push 的 VIEwController @param replace 当前 VIEwController 是否还保留 @param animated 是否使用动画 */+ (voID)pushVIEwController:(UIVIEwController *)vIEwController replace:(BOol)replace animated:(BOol)animated;/** Push 多个 VIEwController @param vIEwControllers VIEwController Array @param animated 是否使用动画 */+ (voID)pushVIEwControllerArray:(NSArray *)vIEwControllers animated:(BOol)animated;/** present VIEwController @param vIEwController 被 present 的 VIEwController @param animated 是否使用动画 @param completion 回调 */+ (voID)presentVIEwController:(UIVIEwController *)vIEwController animated:(BOol)animated completion:(voID (^ __nullable)(voID))completion;/** 关闭当前 VIEwController，push、present 方式通用 @param animated 是否使用动画 */+ (voID)closeVIEwControllerAnimated:(BOol)animated;

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

总结

以上是内存溢出为你收集整理的浅谈强大易用支持URL Rewrite的iOS路由库FFRouter全部内容，希望文章能够帮你解决浅谈强大易用支持URL Rewrite的iOS路由库FFRouter所遇到的程序开发问题。

如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。