Alamofire 源碼學(xué)習(xí)(三)- 慣用編程技巧

本文討論 Alamofire 中使用到的一些 Swift 慣用編程技巧。

單例

單例模式是一種被廣泛運(yùn)用的設(shè)計(jì)模式板丽。一個(gè)設(shè)計(jì)正確的單例類必須保證應(yīng)用的生命周期之內(nèi)在內(nèi)存中有且只能有一個(gè)該類的實(shí)例,這也要求湿右,單例類的實(shí)例化方法必須是線程安全的痰憎。使用 Swift 有若干種方式可以實(shí)現(xiàn)單例類,下面是幾種常見(jiàn)的實(shí)現(xiàn)方式锅纺。

使用帶有明顯 Objective-C 風(fēng)格的 dispatch_once 方式:

class Singleton {
    public class var sharedInstance: Singleton {
        struct Static {
            static var onceToken: dispatch_once_t = 0
            static var instance: Singleton? = nil
        }

        dispatch_once(&Static.onceToken) {
            Static.instance = Singleton()
        }

        return Static.instance!
    }

    private init() {}
}

在類常量中嵌套一個(gè) struct 也可以完成任務(wù)(這里的 struct 類似于 C 語(yǔ)言中函數(shù)的 static 局部變量):

class Singleton {
    public class var sharedInstance: Singleton {
        struct Static {
            static let instance: Singleton = Singleton()
        }
        return Static.instance
    }

    private init() {}
}

實(shí)現(xiàn)單例類的最簡(jiǎn)潔的方式是使用類常量:

class Singleton {
    public static let sharedInstance = Singleton();

    private init() {}
}

至于類常量的線程安全性掷空,Swift 官方博客上面的一篇文章告訴我們,類常量的初始化工作實(shí)際上是在 dispatch_once 線程中完成的:

The lazy initializer for a global variable (also for static members of structs and enums) is run the first time that global is accessed, and is launched as dispatch_once to make sure that the initialization is atomic. This enables a cool way to use dispatch_once in your code: just declare a global variable with an initializer and mark it private.

Alamofire 正是使用了這種方式實(shí)現(xiàn)單例類。稍有不同的是坦弟,下面的例子使用了一個(gè)匿名閉包來(lái)初始化類常量护锤,這讓我們?cè)趯?shí)例化 Manager 對(duì)象之前可以做一些額外的準(zhǔn)備工作:

// Alamofire: Manager.swift

public class Manager {
    public static let sharedInstance: Manager = {
        let configuration = NSURLSessionConfiguration.defaultSessionConfiguration()
        configuration.HTTPAdditionalHeaders = Manager.defaultHTTPHeaders

        return Manager(configuration: configuration)
    }()
}

枚舉

Swift 提供了優(yōu)雅而且功能強(qiáng)大的枚舉類型。在 Swift 的枚舉類型中酿傍,每一個(gè)枚舉項(xiàng)均可以攜帶一個(gè)或者一組關(guān)聯(lián)值(Associated Values):

// Alamofire: NetworkReachabilityManager.swift

public enum NetworkReachabilityStatus {
    case Unknown
    case NotReachable
    case Reachable(ConnectionType)
}

另外烙懦,Swift 也支持具有原始值(Raw Value)的枚舉類型,這種枚舉類型繼承自其他類:

// Alamofire: Error.swift

public enum Code: Int {
    case InputStreamReadFailed           = -6000
    case OutputStreamWriteFailed         = -6001
    case ContentTypeValidationFailed     = -6002
    case StatusCodeValidationFailed      = -6003
    case DataSerializationFailed         = -6004
    case StringSerializationFailed       = -6005
    case JSONSerializationFailed         = -6006
    case PropertyListSerializationFailed = -6007
}

保鏢模式(Bouncer Pattern)

保鏢模式的原則是盡早發(fā)現(xiàn)錯(cuò)誤赤炒,然后將其拒之門外氯析。在 guard 關(guān)鍵字的幫助下,我們可以寫出線性的莺褒、邏輯非常直觀的函數(shù)魄鸦。

示例代碼:

// Alamofire: MultipartFormData.swift

public func appendBodyPart(fileURL fileURL: NSURL, name: String, fileName: String, mimeType: String) {
    let headers = contentHeaders(name: name, fileName: fileName, mimeType: mimeType)

    //============================================================
    //                 Check 1 - is file URL?
    //============================================================

    guard fileURL.fileURL else {
        let failureReason = "The file URL does not point to a file URL: \(fileURL)"
        setBodyPartError(code: NSURLErrorBadURL, failureReason: failureReason)
        return
    }

    //============================================================
    //              Check 2 - is file URL reachable?
    //============================================================

    var isReachable = true

    if #available(OSX 10.10, *) {
        isReachable = fileURL.checkPromisedItemIsReachableAndReturnError(nil)
    }

    guard isReachable else {
        setBodyPartError(code: NSURLErrorBadURL, failureReason: "The file URL is not reachable: \(fileURL)")
        return
    }

    // …
}

guard 關(guān)鍵字是一個(gè)極具爭(zhēng)議性的關(guān)鍵字。有人認(rèn)為 guard 關(guān)鍵字是多余的癣朗,因?yàn)?guard 能做到的事情拾因,if 也可以做到。本文并不打算介入這一爭(zhēng)論旷余。

尾式閉包

尾式閉包(trailing closure)特性幫助寫出簡(jiǎn)短易讀的代碼绢记。當(dāng)函數(shù)的最后一個(gè)參數(shù)是一個(gè)閉包時(shí),我們可以使用下面的語(yǔ)法調(diào)用該函數(shù):

func networkRequest(completion: (response: String) -> Void) {
    // function body goes here
}

// here's how you call this function with a trailing closure:

networkRequest() { response in
    // trailing closure’s body goes here
}

class 與 struct

在 Swift 中正卧,classstruct 兩種類型之間最大的區(qū)別是蠢熄,class 是引用類型,而 struct 是值類型炉旷。下面的兩個(gè)例子對(duì)此做出了說(shuō)明签孔。

class 的例子:

class PersonClass {
    var name: String

    init(name: String) {
        self.name = name
    }
}

let personA = PersonClass(name: "Tom")
let personB = personA
personB.name = "Bob"

print(personA.name)     // "Bob"
print(personB.name)     // "Bob"

struct 的例子:

struct PersonStruct {
    var name: String

    init(name: String) {
        self.name = name
    }
}

let personA = PersonStruct(name: "Tom")
let personB = personA
personB.name = "Bob"

print(personA.name)     // "Tom"
print(personB.name)     // "Bob"

一般而言,需要處理復(fù)雜的數(shù)據(jù)結(jié)構(gòu)時(shí)窘行,使用 class饥追;需要封裝少量簡(jiǎn)單的數(shù)值而且期望在復(fù)制操作中進(jìn)行值拷貝時(shí),使用 struct罐盔。

GCD 與 NSOperation

GCD (Grand Central Dispatch)和 NSOperation 是 Cocoa 框架提供的兩種并發(fā)編程技術(shù)但绕。GCD 在 C 語(yǔ)言層面實(shí)現(xiàn)了并發(fā)編程的基礎(chǔ)設(shè)施,NSOperation 則是對(duì) GCD 的上層封裝惶看。想要講清楚這兩個(gè)概念需要不小的篇幅捏顺,本文不打算展開(kāi)討論。具體的細(xì)節(jié)請(qǐng)參考相關(guān)技術(shù)文檔:

(未完)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末纬黎,一起剝皮案震驚了整個(gè)濱河市幅骄,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌本今,老刑警劉巖拆座,帶你破解...
    沈念sama閱讀 218,941評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件主巍,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡懂拾,警方通過(guò)查閱死者的電腦和手機(jī)煤禽,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,397評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門铐达,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)岖赋,“玉大人,你說(shuō)我怎么就攤上這事瓮孙√贫希” “怎么了?”我有些...
    開(kāi)封第一講書人閱讀 165,345評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵杭抠,是天一觀的道長(zhǎng)脸甘。 經(jīng)常有香客問(wèn)我,道長(zhǎng)偏灿,這世上最難降的妖魔是什么丹诀? 我笑而不...
    開(kāi)封第一講書人閱讀 58,851評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮翁垂,結(jié)果婚禮上铆遭,老公的妹妹穿的比我還像新娘。我一直安慰自己沿猜,他們只是感情好枚荣,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,868評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著啼肩,像睡著了一般橄妆。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上祈坠,一...
    開(kāi)封第一講書人閱讀 51,688評(píng)論 1 305
  • 那天害碾,我揣著相機(jī)與錄音,去河邊找鬼赦拘。 笑死蛮原,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的另绩。 我是一名探鬼主播儒陨,決...
    沈念sama閱讀 40,414評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼笋籽!你這毒婦竟也來(lái)了蹦漠?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書人閱讀 39,319評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤车海,失蹤者是張志新(化名)和其女友劉穎笛园,沒(méi)想到半個(gè)月后隘击,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,775評(píng)論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡研铆,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,945評(píng)論 3 336
  • 正文 我和宋清朗相戀三年埋同,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片棵红。...
    茶點(diǎn)故事閱讀 40,096評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡凶赁,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出逆甜,到底是詐尸還是另有隱情虱肄,我是刑警寧澤,帶...
    沈念sama閱讀 35,789評(píng)論 5 346
  • 正文 年R本政府宣布交煞,位于F島的核電站咏窿,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏素征。R本人自食惡果不足惜集嵌,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,437評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望御毅。 院中可真熱鬧根欧,春花似錦、人聲如沸亚享。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 31,993評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)欺税。三九已至侈沪,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間晚凿,已是汗流浹背亭罪。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 33,107評(píng)論 1 271
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留歼秽,地道東北人应役。 一個(gè)月前我還...
    沈念sama閱讀 48,308評(píng)論 3 372
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像燥筷,于是被迫代替她去往敵國(guó)和親箩祥。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,037評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容