2023-02-26 今天難得的一個好天氣,一整天陽光暖洋洋,精力十足,整理框架時,對路由一些小想法,于是花了一整天,把整個路由組件做成了pod,抽了出來.
上一篇路由講了個當時隨手寫的一個框架,但寫完后項目沒怎么用,后面因為事情太多,漸漸也就忘了,這次重新整理了一下思路,對路由重新設(shè)計了一番.
架構(gòu)
|____Classes
| |____GetRouter.swift
| |____GetRouterHandlerSource.swift
| |____.gitkeep
| |____ReplaceMe.swift
| |____GetRouterMiddleware.swift
| |____GetRouterName.swift
| |____GetRouterHandler.swift
|____Assets
| |____.gitkeep
路由設(shè)計
路由分遠程路由和本地路由,我們需要做的是統(tǒng)一,遠程路由適用與banner跳轉(zhuǎn),js交互操作等等情況,一般來說是string執(zhí)行的路由跳轉(zhuǎn),本地路由需要規(guī)定要,一個頁面的跳轉(zhuǎn),最好走唯一的路由,好處就是封裝,低耦合,A頁面理論上是不應(yīng)該import B頁面的,還有就是埋點參數(shù)上報等等,統(tǒng)一路徑.
流程
- 遠程路由
urlStirng->encoding->parse解析路由,合并參數(shù)->匹配本地路由->執(zhí)行跳轉(zhuǎn) - 本地路由
匹配本地路由->執(zhí)行跳轉(zhuǎn)
GetRouter
遠程路由與本地路由解析的流程文件后,解析完成后交給GetRougerHandler執(zhí)行
GetRougerHandler
匹配路由名相同的GetPage 執(zhí)行中間件攔截, 執(zhí)行跳轉(zhuǎn)
GetRouterMiddleware中間件攔截
中間件用于公共攔截方式,舉例說明,我們?nèi)绻胩D(zhuǎn)vip直播間,我們需要前置判斷當前登錄者是不是vip,當前vip直播間是否正在直播,一個是同步就可以判斷出當前用戶vip狀態(tài),一個需要實時請求后端直播狀態(tài)接口等.
傳統(tǒng)方式中,我們可能需要通用寫個判斷
// 判斷vip
guard User.isVip else {
return
}
// 判斷直播狀態(tài)
RequestLiveStatus {
jumpLive()
}
這樣寫不太優(yōu)雅, 所以我增加了同步攔截與異步攔截(注意,中間件的環(huán)境在iOS13以上處于異步線程,執(zhí)行UI操作,吐絲重定向等請回到主線程執(zhí)行)
open class GetRouterMiddleware {
/// 優(yōu)先級
let priority: Int
public init(priority: Int) {
self.priority = priority
}
/// 處理返回結(jié)果
/// - Returns: true: 允許通過 false: 禁止
open func handler(routeName: GetRouterName, params: GetDict?) -> Bool { true }
@available(iOS 13.0.0, *)
/// 異步中間件, 注意如果想要在此出重定向路由,注意要回到mainThread
/// - Parameter routeName: 路由名
/// - Returns: true: 允許通過 false: 禁止
open func handlerAsync(routeName: GetRouterName, params: GetDict?) async throws -> Bool { true }
}
GetPage
注冊路由時包裝的路由匹配信息,包括中間件和行為.
GetRouterHandlerSource
提供GetPage的source來源
GetRouterName路由名設(shè)計
原先我們設(shè)計的路由名是這樣的
enum GetRouterName: String {
// MARK: - --------------------------------------公共
case http = "http"
case https = "https"
// MARK: - --------------------------------------發(fā)現(xiàn)
// MARK: - --------------------------------------社區(qū)
case community_post_detail = "community_post_detail"
// MARK: - --------------------------------------個人
// MARK: - --------------------------------------我的
case mine_setting = "mine_setting"
case mine_complete = "mine_complete"
// MARK: - --------------------------------------帖子
case post_detail = "post_detail"
}
很簡單,很易懂,但是有缺點
- enum可以在switch中可以枚舉掉所有的選項,保證我們不會漏掉任何路由名,但是,enum無法寫成extension,也就是說,我們必須把所有名卸載一個文件里,這樣對模塊化是不好的,我希望使用的場景是我每個模塊去注冊這個路由,然后提供我模塊的模塊名和路由處理選項,這樣就可以做到單獨開發(fā)自己的選項
- string不是類型,在本地調(diào)用中,我們不可避免的會出現(xiàn)必須強制帶類名的方式,寫起來就不是那么清爽,例如
Router.to(GetRouterName.mine_setting),我想要的是Router.to(.mine_setting)
所以,利用swift的語法特點,我修改成這種寫法
/// 路由列表容器
public struct GetRouterNames {}
/// 路由列表
public struct GetRouterName: RawRepresentable,
ExpressibleByStringLiteral,
Hashable {
public var rawValue: String
public init(rawValue: String) {
self.rawValue = rawValue
}
public init(stringLiteral value: StringLiteralType) {
self.rawValue = value
}
public var hashValue: Int {
rawValue.hashValue
}
}
這里寫了一個類型GetRouterName,利用swift字面量,可以達到這種定義路由名的效果
// GetRouter+Home.swift
// quick
//
// Created by suyikun on 2023/2/25.
//
import Foundation
extension GetRouterNames {
/// 發(fā)現(xiàn)列表
static let discover: GetRouterName = "/discover/list"
/// 發(fā)現(xiàn)頁詳情
static let discoverDetail: GetRouterName = "/discover/detail"
}
雖然,我們損失了enum強制枚舉所有枚舉的效果,但是,我們收獲了模塊化路由名+路由名類型的優(yōu)點
使用示例
注意事項: 獲取參數(shù)時,遠程路由獲取的value是string類型,需要在寫代碼時考慮兼容轉(zhuǎn)換
PS
在我看來,路由設(shè)計應(yīng)該是可以純粹的解耦合的,他跟業(yè)務(wù)的跳轉(zhuǎn)沒有一點關(guān)系,只是一些規(guī)則的解析,
總結(jié)一下,回顧了下整個路由設(shè)計,一天的收獲滿滿,如果你們喜歡我的文章,或者對路由設(shè)計有什么批評建議意見,希望可以點贊留言
最后留一下git地址: 戳這前往
