2023-02-26 今天難得的一個好天氣,一整天陽光暖洋洋,精力十足,整理框架時,對路由一些小想法,于是花了一整天,把整個路由組件做成了pod,抽了出來.

上一篇路由講了個當時隨手寫的一個框架,但寫完后項目沒怎么用,后面因為事情太多,漸漸也就忘了,這次重新整理了一下思路,對路由重新設計了一番.

架構(gòu)

|____Classes
| |____GetRouter.swift
| |____GetRouterHandlerSource.swift
| |____.gitkeep
| |____ReplaceMe.swift
| |____GetRouterMiddleware.swift
| |____GetRouterName.swift
| |____GetRouterHandler.swift
|____Assets
| |____.gitkeep

路由設計

路由分遠程路由和本地路由,我們需要做的是統(tǒng)一,遠程路由適用與banner跳轉(zhuǎn),js交互操作等等情況,一般來說是string執(zhí)行的路由跳轉(zhuǎn),本地路由需要規(guī)定要,一個頁面的跳轉(zhuǎn),最好走唯一的路由,好處就是封裝,低耦合,A頁面理論上是不應該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路由名設計

原先我們設計的路由名是這樣的

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

在我看來,路由設計應該是可以純粹的解耦合的,他跟業(yè)務的跳轉(zhuǎn)沒有一點關(guān)系,只是一些規(guī)則的解析,
總結(jié)一下,回顧了下整個路由設計,一天的收獲滿滿,如果你們喜歡我的文章,或者對路由設計有什么批評建議意見,希望可以點贊留言
最后留一下git地址: 戳這前往