Shulou(Shulou.com)06/03 Report--

This article mainly introduces how to use FFRouter, has a certain reference value, interested friends can refer to, I hope you can learn a lot after reading this article, the following let the editor take you to understand it.

FFRouter is a powerful and easy-to-use URL routing library in iOS, which supports URL Rewrite, so that APP can dynamically modify the relevant routing logic after release. It is efficient to find URL based on matching. Integration and use are very simple!

Function

Basic URL registration, Route, unregistration, printing Log, etc.

Support to register URL with wildcard (*)

Support for URL Rewrite

Get the original URL parameter or URLComponents when Rewrite is supported, and URL Encode or Decode it.

Support to obtain Object through URL

Pass unconventional objects when Route URL is supported

Unified callback when Route is supported for an unregistered URL

Installation

CocoaPodstarget 'MyApp' do pod' FFRouter'end

Run pod install

Manual installation

Add the FFRouter folder to your own project

Usage

First

# import "FFRouter.h"

1. Basic use

/ * * registering url @ param routeURL the URL @ param handlerBlock URL to be registered is called back by Route * / + (void) registerRouteURL: (NSString *) routeURL handler: (FFRouterHandler) handlerBlock;/** registers URL. After the URL registered in this way is Route, you can return a callback after Object @ param routeURL URL @ param handlerBlock URL is Route. You can return an Object * / + (void) registerObjectRouteURL: (NSString *) routeURL handler: (FFObjectRouterHandler handlerBlock) in the callback. / * * determine whether URL can be Route (registered or not) @ param URL whether the URL @ return can be judged by Route * / + (BOOL) canRouteURL: (NSString *) URL;/** Route a URL @ param URL to Router URL * / + (void) routeURL: (NSString *) URL;/** Route a URL, and take the extra parameter @ param URL to Router URL @ param parameters extra parameter * / + (void) routeURL: (NSString *) URL withParameters: (NSDictionary *) parameters / * * Route a URL, you can get Object * / + (id) routeObjectURL: (NSString *) URL;/** Route returned by Object * / + (id) routeObjectURL: (NSString *) URL;/** Route returned by URL @ return of the returned Object @ param URL, and with additional parameters, you can get the returned Object @ param URL URL @ param parameters extra parameter @ return returned Object * / + (id) routeObjectURL: (NSString *) URL withParameters: (NSDictionary *) parameters / * * Route callback @ param handler callback when a URL is not registered * / + (void) routeUnregisterURLHandler: (FFRouterUnregisterURLHandler) handler;/** unregisters a URL @ param URL URL * / + (void) unregisterRouteURL: (NSString *) URL;/** unregisters whether all URL * / + (void) unregisterAllRoutes;/** displays Log, used to debug @ param enable YES or NO, defaults to NO * / + (void) setLogEnabled: (BOOL) enable

[remarks]

(1) Register URL:

[FFRouter registerRouteURL:@ "protocol://page/routerDetails/:id" handler: ^ (NSDictionary * routerParameters) {/ / callback} when the URL of Route matches this registration URL]; [FFRouter registerRouteURL:@ "wildcard://*" handler: ^ (NSDictionary * routerParameters) {/ / callback} when the URL of Route matches this registration URL] [callback} when FFRouter registerRouteURL:@ "protocol://page/routerObjectDetails" handler: ^ (NSDictionary * routerParameters) {/ / Route's URL matches this registration URL}]

The parameters in URL can be obtained through routerParameters, and routerParameters [FFRouterParameterURLKey] is a complete URL.

(2) when necessary, through the following methods:

+ (id) routeObjectURL: (NSString *) URL

When you Route a URL and get the return value, you need to register the URL using the following method:

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

And return the Object to be returned in handlerBlock, for example:

/ / register and return the necessary value [FFRouter registerObjectRouteURL:@ "protocol://page/routerObjectDetails" handler: ^ id (NSDictionary * routerParameters) {NSString * str = @ "return necessary Object as needed; return str;}]; / / get the returned value NSString * ret = [FFRouter routeObjectURL:@" protocol://page/routerObjectDetails "]

(3) if you need to pass unconventional objects as parameters, such as UIImage, you can use the following methods:

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

2 、 URL Rewrite

/ * * according to the set Rules to rewrite a URL @ param url will be URL * / + (NSString *) rewriteURL: (NSString *) url;/** after rewrite's URL @ return rewrite add a RewriteRule @ param matchRule regular matching rule @ param targetRule conversion rule * / + (void) addRewriteMatchRule: (NSString *) matchRule targetRule: (NSString *) targetRule / * * add multiple RewriteRule at the same time. The format must be @ [@ @ "matchRule": @ "YourMatchRule", @ "targetRule": @ "YourTargetRule"},.] @ param rules RewriteRules * / + (void) addRewriteRules: (NSArray *) rules;/** remove a matchRule * / + (void) removeRewriteMatchRule: (NSString *) matchRule;/** that will be removed by RewriteRule @ param matchRule. Remove all RewriteRule * / + (void) removeAllRewriteRules.

[remarks]

(1) you can add a Rewrite rule using a rule, for example: to open the URL: https://www.taobao.com/search/ atomic bomb, intercept it and open it with a locally registered URL:protocol://page/routerDetails?product= atomic bomb.

First add a Rewrite rule:

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

After that, when the URL: https://www.taobao.com/search/ atomic bomb is opened, it will be Rewrite to URL:protocol://page/routerDetails?product= atomic bomb.

[FFRouter routeURL:@ https://www.taobao.com/search/ atomic bomb]

(2) multiple rules can be added at the same time by the following methods:

+ (void) addRewriteRules: (NSArray *) rules

The rules format must be in the following format:

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

(3) reserved words in Rewrite rules:

Get the corresponding parts of the standard URL through $scheme, $host, $port, $path, $query, and $fragment. Get the full URL through $url

Through $1, $2, $3. Get the parameters taken out using parentheses in the matchRule's regular

$: the value of the original variable, $$: the value after the original variable URL Encode, $#: the value after the original variable URL Decode

For example: https://www.taobao.com/search/ atomic bomb for Rewrite rule (?: https://)?www.taobao.com/search/(.*)

$1 = atomic bomb $$1=%e5%8e%9f%e5%ad%90%e5%bc%b9

Similarly, for the Rewrite rule (?: https://)?www.taobao.com/search/(.*)), https://www.taobao.com/search/%e5%8e%9f%e5%ad%90%e5%bc%b9

$1=%e5%8e%9f%e5%ad%90%e5%bc%b9 $# 1 = atomic bomb

3 、 FFRouterNavigation

Considering that routing is often used to configure the jump between UIViewController, an additional tool, FFRouterNavigation, is added to control the jump between UIViewController more easily. The specific usage is as follows:

/ * * whether the bottom TabBar @ param hide is automatically hidden when push. Default is NO * / + (void) autoHidesBottomBarWhenPushed: (BOOL) hide; / * * get current ViewController @ return current ViewController * / + (UIViewController *) currentViewController;/** get current NavigationViewController @ return return current NavigationViewController * / + (nullable UINavigationController *) currentNavigationViewController / * * Push ViewController @ param viewController whether the ViewController @ param animated of the Push uses animation * / + (void) pushViewController: (UIViewController *) viewController animated: (BOOL) animated;/** Push ViewController, you can set whether the current ViewController still retains @ param viewController ViewController @ param replace current ViewController whether or not @ param animated uses animation * / + (void) pushViewController: (UIViewController *) viewController replace: (BOOL) replace animated: (BOOL) animated / * * Push multiple ViewController @ param viewControllers ViewControllerArray @ param animated whether to use animation * / + (void) pushViewControllerArray: (NSArray *) viewControllers animated: (BOOL) animated;/** presentViewController @ param viewController ViewController @ param viewController whether to use animation @ param completion callback * / + (void) presentViewController: (UIViewController *) viewController animated: (BOOL) animated completion: (void (^ _ nullable) (void) completion / * * turn off the current ViewController,push, present general @ param animated whether to use animation * / + (void) closeViewControllerAnimated: (BOOL) animated; Thank you for reading this article carefully. I hope the article "how to use FFRouter" shared by the editor will be helpful to you. At the same time, I hope you will support and pay attention to the industry information channel. More related knowledge is waiting for you to learn!

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.