Swift?enum枚舉類型使用詳解
前言
我一直在思考如何去講解Swift中的枚舉類型,它是如此讓人熟悉,不免就讓你跟著編程經(jīng)驗(yàn)走,列舉幾個(gè)狀態(tài)就感覺萬事大吉了。它是如此讓人陌生,當(dāng)你深刻的理解其廣泛的用途后,你不得不嘆服蘋果在設(shè)計(jì)enum是多么讓人眼前一亮。
我思來想去,還是從Swift中最有特點(diǎn)的兩個(gè)系統(tǒng)枚舉入手:Optional和Result,而著名的第三庫中選擇的話,Alamofire中細(xì)化的AFError也是全面理解Swift中enum的很好的范例。
AFError
由于Alamofire中AFError這個(gè)文件中注釋加上代碼已經(jīng)接近900行了,所以我在舉例說明中會精簡很大一部分,通過拋磚引玉的方式讓大家了解Swift中的enum的特點(diǎn)特色。
import Foundation public enum AFError: Error { /// The underlying reason the `.urlRequestValidationFailed` public enum URLRequestValidationFailureReason { /// URLRequest with GET method had body data. case bodyDataInGETRequest(Data) } /// `URLRequest` failed validation. case urlRequestValidationFailed(reason: URLRequestValidationFailureReason) } // MARK: - Error Descriptions extension AFError: LocalizedError { public var errorDescription: String? { switch self { case .explicitlyCancelled: return "Request explicitly cancelled." case let .invalidURL(url): return "URL is not valid: \(url)" case let .parameterEncodingFailed(reason): return reason.localizedDescription case let .parameterEncoderFailed(reason): return reason.localizedDescription case let .multipartEncodingFailed(reason): return reason.localizedDescription case let .requestAdaptationFailed(error): return "Request adaption failed with error: \(error.localizedDescription)" case let .responseValidationFailed(reason): return reason.localizedDescription case let .responseSerializationFailed(reason): return reason.localizedDescription case let .requestRetryFailed(retryError, originalError): return """ Request retry failed with retry error: \(retryError.localizedDescription), \ original error: \(originalError.localizedDescription) """ case .sessionDeinitialized: return """ Session was invalidated without error, so it was likely deinitialized unexpectedly. \ Be sure to retain a reference to your Session for the duration of your requests. """ case let .sessionInvalidated(error): return "Session was invalidated with error: \(error?.localizedDescription ?? "No description.")" #if !(os(Linux) || os(Windows)) case let .serverTrustEvaluationFailed(reason): return "Server trust evaluation failed due to reason: \(reason.localizedDescription)" #endif case let .urlRequestValidationFailed(reason): return "URLRequest validation failed due to reason: \(reason.localizedDescription)" case let .createUploadableFailed(error): return "Uploadable creation failed with error: \(error.localizedDescription)" case let .createURLRequestFailed(error): return "URLRequest creation failed with error: \(error.localizedDescription)" case let .downloadedFileMoveFailed(error, source, destination): return "Moving downloaded file from: \(source) to: \(destination) failed with error: \(error.localizedDescription)" case let .sessionTaskFailed(error): return "URLSessionTask failed with error: \(error.localizedDescription)" } } } extension AFError.URLRequestValidationFailureReason { var localizedDescription: String { switch self { case let .bodyDataInGETRequest(data): return """ Invalid URLRequest: Requests with GET method cannot have body data: \(String(decoding: data, as: UTF8.self)) """ } } }
我們先一點(diǎn)點(diǎn)的分析吧:
- enum是一種特殊的struct!
- enum可以遵守協(xié)議,你看開頭一上來就是
public enum AFError: Error
,表示就是這個(gè)AFError遵守Error協(xié)議,感興趣的可以看看Error到底是什么喔。 - enum是可以帶參數(shù)的,我們看這個(gè)例子
case urlRequestValidationFailed(reason: URLRequestValidationFailureReason)
。
這個(gè)urlRequestValidationFailed帶了一個(gè)reason參數(shù),這個(gè)參數(shù)的類型是URLRequestValidationFailureReason,仔細(xì)看URLRequestValidationFailureReason,它其實(shí)也是個(gè)枚舉,并且?guī)?shù):
public enum URLRequestValidationFailureReason { /// URLRequest with GET method had body data. case bodyDataInGETRequest(Data) }
怎么樣,有點(diǎn)暈了沒?夠酸爽了吧?這還不夠呢,我們接著看:
enum不僅能帶參數(shù)、遵守協(xié)議,還能寫分類,并擴(kuò)展只讀計(jì)算屬性與函數(shù),extension AFError: LocalizedError
中就是遵守LocalizedError協(xié)議,并實(shí)現(xiàn)LocalizedError協(xié)議中的屬性var errorDescription: String?
。
我們看看這個(gè)只讀計(jì)算屬性的里面其中的一個(gè)實(shí)現(xiàn):
case let .urlRequestValidationFailed(reason): return "URLRequest validation failed due to reason: \(reason.localizedDescription)"
這個(gè)case let的意思是:如果是urlRequestValidationFailed這種情況,獲取這個(gè)枚舉中的reason參數(shù),并且進(jìn)行字符串表達(dá),除了上面這種表達(dá),經(jīng)常的書寫方式還有下面幾種:
/// 將let放在取枚舉值的地方,我個(gè)人比較喜歡這種寫法 case .urlRequestValidationFailed(let reason): /// 不關(guān)心枚舉帶參,用_代替 case .urlRequestValidationFailed(_): /// 直接只顯示枚舉的狀態(tài),省略參數(shù)顯示 case .urlRequestValidationFailed:
最后一個(gè)extension AFError.URLRequestValidationFailureReason
展示了在內(nèi)嵌的在AFError中的URLRequestValidationFailureReason類型應(yīng)該如何編寫分類。
怎么樣?單單看一個(gè)Alamofire的AFError就有不少的收獲吧?
Swift中的enum,是我目前學(xué)習(xí)過的編程語言中功能最強(qiáng)大的enum了。
Result
下面的是官方的Result的源碼,我只寫出了主干功能,大家看了,想想enum又支持什么功能呢?
@frozen public enum Result<Success, Failure> where Failure : Error { /// A success, storing a `Success` value. case success(Success) /// A failure, storing a `Failure` value. case failure(Failure) /// 其他的內(nèi)容我省略了 }
官方提供的Result枚舉在Swift5之后才正式上線,而Github開源的,我們可以看這個(gè)庫Result,它的.gitignore創(chuàng)建于6年前,可以看到Result類型的出現(xiàn)并不是偶然,它的出現(xiàn)更多是因?yàn)楣δ苌系脑V求。
當(dāng)前的異步回調(diào)中,最常見的情況有兩種:回調(diào)成功抑或回調(diào)失敗,在早期的Swift回調(diào)中,我們經(jīng)??匆娺@樣寫:
typealias Callback<Success, SomeError: Error> = (Success?, SomeError?) -> Void
因?yàn)槲抑阑卣{(diào)到底是否成功,所以Success與SomeError都是可選類型,使用Result類型后,我們就可以這么寫了:
typealias ResultCallback<Success, SomeError: Error> = (Result<Success, SomeError>) -> Void
回調(diào)的結(jié)果,有兩種情況,真實(shí)可靠——case success和case failure,直接減少了可選類型的使用,也就精簡了判空的邏輯。
通過Result這個(gè)枚舉,我們可以看出Swift中的enum是支持泛型的!??!
如果你一直使用過Alamofire和Kingfisher,你會發(fā)現(xiàn)它們里面的回調(diào)變遷也是圍繞這個(gè)上面兩個(gè)閉包的例子進(jìn)行演化的。
最后來介紹一下Swift中的可選類型。
Optional
下面的是官方的Optional的源碼,我只寫出了主干功能,是不是和Result非常相似呢?
@frozen public enum Optional<Wrapped> : ExpressibleByNilLiteral { /// The absence of a value. /// /// In code, the absence of a value is typically written using the `nil` /// literal rather than the explicit `.none` enumeration case. case none /// The presence of a value, stored as `Wrapped`. case some(Wrapped) }
而我經(jīng)??匆姷?code>String?這個(gè)寫法,不過是Optional<String>
的糖語法罷了。
最后舉一個(gè)enum的典型例子
enum NumberType: String { case one, two, three, four, five } let s: NumberType = .one print(s.rawValue)
s.rawValue的類型是String,而打印出來的就是字符串"one"。
這種enum NumberType: String
寫法,本質(zhì)上告訴編譯器枚舉中的rawValue值是String類型,怎么樣,有木有有點(diǎn)暈?zāi)兀?/p>
大家思考一下下面這種情況:
enum NumberValue: Int { case one = 3, two, three, four, five }
NumberValue.two.rawValue是什么呢?
總結(jié)
Swift中的enum,不僅是過去認(rèn)知中僅僅表示狀態(tài)的簡單類型,它有以下這些特性:
- 支持遵守協(xié)議
- 支持泛型使用
- 支持編寫擴(kuò)展
- 支持帶參數(shù)
- 支持繼承基礎(chǔ)數(shù)據(jù)類型,表示枚舉的rawValue的類型
還有其他有點(diǎn)意思的特性可能目前還沒有概括全面,我想表達(dá)的是,enum的設(shè)計(jì)是顛覆性,而靈活運(yùn)用這些enum特性,才是最難的。
之所以會先講解enum是因?yàn)樗臀覀冃枰v解的網(wǎng)絡(luò)請求封裝庫Moya非常密切。
以上就是Swift enum枚舉類型使用詳解的詳細(xì)內(nèi)容,更多關(guān)于Swift enum枚舉類型的資料請關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
在Mac OS的終端中運(yùn)行Swift應(yīng)用的方法
這篇文章主要介紹了在Mac OS的終端中運(yùn)行Swift應(yīng)用的方法,依靠Xcode的REPL功能來實(shí)現(xiàn),需要的朋友可以參考下2015-07-07Swift實(shí)現(xiàn)倒計(jì)時(shí)5秒功能
這篇文章主要為大家詳細(xì)介紹了Swift實(shí)現(xiàn)倒計(jì)時(shí)5秒功能,在“登錄”和“注冊”頁面也有相似功能,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2020-03-03Swift?中的?Actors?使用及如何防止數(shù)據(jù)競爭問題(示例詳解)
Swift中的Actors旨在完全解決數(shù)據(jù)競爭問題,但重要的是要明白,很可能還是會遇到數(shù)據(jù)競爭,本文將介紹Actors是如何工作的,以及你如何在你的項(xiàng)目中使用它們,感興趣的朋友跟隨小編一起看看吧2023-06-06Swift設(shè)計(jì)思想Result<T>與Result<T,?E:?Error>類型解析
這篇文章主要為大家介紹了Swift設(shè)計(jì)思想Result<T>與Result<T,?E:?Error>的類型示例解析,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-11-11Swift的開發(fā)環(huán)境搭建以及基本語法詳解
這篇文章主要介紹了Swift的開發(fā)環(huán)境搭建以及基本語法詳解,是Swift入門學(xué)習(xí)中的基礎(chǔ)知識,需要的朋友可以參考下2015-11-11Swift利用指紋識別或面部識別為應(yīng)用添加私密保護(hù)功能
這篇文章主要給大家介紹了關(guān)于Swift利用指紋識別或面部識別為應(yīng)用添加私密保護(hù)功能的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),對大家學(xué)習(xí)或者使用swift具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友下面隨著小編來一起看看吧2018-05-05Swift設(shè)置UILabel內(nèi)邊距的實(shí)例代碼
有時(shí)候,我們需要一個(gè)顯示文字,又想這些文字與邊界之間有自定義的邊距,所以下面這篇文章主要給大家介紹了關(guān)于Swift設(shè)置UILabel內(nèi)邊距的相關(guān)資料,需要的朋友可以參考下2021-10-10