RxSwift+Moya+ObjectMapper數據轉換
一 Rxswift 簡單介紹
二 Moya 簡單介紹以及使用
三 ObjectMapper 簡單介紹以及使用
四 RxSwift+Moya+ObjectMapper優雅的網絡請求及數據轉換
一 RxSwift 簡單介紹
- RxSwift是Swift函數響應式編程的一個開源庫,由GitHub的ReactiveX組織開發和維護
- 其他語言像C#,Java 和JS也有: Rx.Net、RxJava、RxJS
- RxSwift的目的是讓數據/事件流和異步任務能夠更方便的序
列化處理 能夠使用Swift進行響應式編程
本文就不詳細介紹Rxswift 樓主之前寫過RxSwift 的介紹以及使用 可以參看一下 [RxSwift 個人學習筆記記錄](http://www.jianshu.com/p/00ded20182d2)
二 Moya 簡單介紹以及使用
1 Moya 簡單介紹
》[Moya](https://github.com/Moya/Moya)是一個基于Alamofire的Networking library,并且添加了對于ReactiveCocoa和RxSwift的接口支持,大大簡化了開發過程,是Reactive Functional Programming的網絡層首選。
Github上的官方介紹羅列了Moya的一些特點:
* 編譯的時候會檢查API endpoint
* 可以用枚舉值清楚地定義很多endpoint
* 增加了stubResponse類型,大大方便了unit testing
2 Moya 的 使用
首先我們需要聲明一個enum來對請求進行明確分類。
enum APIManager{ case GetHomeList // 獲取首頁列表 case GetHomeDetail(Int) // 獲取詳情頁 }
然后我們需要讓這個enum遵守TargetType協議,在這個協議中可以看到 TargetType定義了我們發送一個網絡請求所需要的東西,baseURL,parameter,method等一些計算性屬性,我們要做的就是去實現這些東西,當然有帶默認值的我們可以不去實現。
extension APIManager: TargetType { /// The target‘s base `URL`。 var baseURL: URL { return URL.init(string: “http://news-at.zhihu.com/api/”)! } /// The path to be appended to `baseURL` to form the full `URL`。 var path: String { switch self { case .GetHomeList: // 不帶參數的請求 return “4/news/latest” case .GetHomeDetail(let id): // 帶參數的請求 return “4/theme/(id)” } } // 區分get 和 post var method: Moya.Method { return .get } /// The parameters to be incoded in the request. var parameters: [String: Any]? { return nil } /// The method used for parameter encoding. var parameterEncoding: ParameterEncoding { return URLEncoding.default } /// Provides stub data for use in testing. var sampleData: Data { return “”.data(using: String.Encoding.utf8)! } /// The type of HTTP task to be performed. var task: Task { return .request } /// Whether or not to perform Alamofire validation. Defaults to `false`。 var validate: Bool { return false } }
寫好上邊的以后 我們就可以去發送一個請求了
private let provider = RxMoyaProvider() // 請求數據 provider .request(.GetHomeList) .filterSuccessfulStatusCodes() .mapJSON().subscribe(onNext: { (json) in print(json) }).addDisposableTo(bag)
上邊就是請求數據了 回調出來json數據
》如果對RxSwift還不熟悉的話 建議去看一下之前寫的文章[RxSwift 個人學習筆記記錄](http://www.jianshu.com/p/00ded20182d2)
Moya其實是提供了非常方面的RxSwift擴展
簡單介紹一下上邊方法和變量中的各個名詞:
* RxMoyaProvider是MoyaProvider的子類,是對RxSwift的擴展
* filterSuccessfulStatusCodes() 是Moya為RxSwift提供的擴展方法,顧名思義,可以得到成功成功地網絡請求,忽略其他的
* mapJSON() 也是Moya RxSwift的擴展方法,可以把返回的數據解析成 JSON 格式 會返回一個Observable
然后我們就可以對這個Observable進行訂閱了
然后我們就可以得到下邊的json數據 只展示了部分數據
網絡請求就已經結束了 就這這么簡單輕松and easy ????
{ date = 20170908; stories = ( { “ga_prefix” = 090817; id = 9602715; images = ( “https://pic2.zhimg.com/v2-3b39b83f560e089a7f6ddb00f6948b81.jpg” ); title = “U4e24U5343U591aU5e74U524dUff0cU79e6U56fdU4e3aU4ec0U4e48U8981U7edfU4e00U4e2dU56fdUff1f”; type = 0; }, { “ga_prefix” = 090816; id = 9601590; images = ( “https://pic4.zhimg.com/v2-700a8c29d04a885354d78d5a91a9fa5b.jpg” ); title = “U8fdcU5904U6765U4e86U8f66Uff0cU5148U89c1U5230U8f66U9876U5c31U8bf4U660eU5730U7403U662fU5706U7684Uff1fU4e0dU53efU80fdU7684”; type = 0; }, ); “top_stories” = ( { “ga_prefix” = 090815; id = 9607829; image = “https://pic3.zhimg.com/v2-14c13f9f87b1b3082929b444072eebb6.jpg”; title = “U770bU7167U7247Uff0cU6211U5c31U77e5U9053U4f60U662fU540cU6027U604bUff0cU65afU5766U798fU5927U5b66U7684U4ebaU5de5U667aU80fdU8bf4”; type = 0; }, { “ga_prefix” = 090807; id = 9606837; image = “https://pic1.zhimg.com/v2-cceffc2e17185ae51b7b2d14b4414e84.jpg”; title = “U6211U8fd9U4e48U80d6Uff0cU5230U5e95U662fU56e0U4e3aU5403U5f97U592aU591aU8fd8U662fU52a8U5f97U592aU5c11Uff1f”; type = 0; }, ); }
三 ObjectMapper 簡單介紹以及使用
json得到了 接下來那就是json轉模型了
》ObjectMapper 是一個在 Swift 下數據轉模型的非常好用,并且很 Swift 的一個框架。以前我們在寫 OC 代碼的時候用 MJExtension 轉模型,到了 Swift 的時代趕緊將 ObjectMapper 使用起來吧。
為了支持映射,類或者結構體只需要實現Mappable協議。這個協議包含兩個方法 而且這兩個方法是必須實現的
class LLHomeModel: Mappable { var date: String? var stories: [StoryModel]? var top_stories: [StoryModel]? // 接下來的兩個方法是必須要實現的 required init?(map: Map) { } public func mapping(map: Map) { date 《- map[“date”] stories 《- map[“stories”] top_stories 《- map[“top_stories”] } }
一旦你的對象實現了 Mappable, ObjectMapper就可以讓你輕松的實現和 JSON 之間的轉換。
把 JSON 字符串轉成 model 對象:
let homeModel = LLHomeModel(JSONString: JSONString)
把一個 model 轉成 JSON 字符串:
let JSONString = homeModel.toJSONString(prettyPrint: true)
還有一些具體的基礎使用可以參考[ObjectMapper中文翻譯](https://github.com/SwiftOldDriver/ObjectMapper-CN-Guide)
四 RxSwift+Moya+ObjectMapper優雅的網絡請求及數據轉換
RxSwift結合MVVM 簡直的太合適不過了
我們將 網絡請求放在VM里邊
private let provider = RxMoyaProvider() // 請求數據 provider .request(.GetHomeList) .filterSuccessfulStatusCodes() .mapJSON().mapObject(type: LLHomeModel.self).subscribe(onNext: { (model) in self.modelObserable.value = model.stories! }, : { (error) in }).addDisposableTo(bag)
可以看到我們上邊代碼中 `provider
.request(.GetHomeList)
.filterSuccessfulStatusCodes()
.mapJSON()。` 這個方法本身應該得到 JSON的 但是我后邊跟了一個mapObject 的方法 這個方式可以直接根據json的格式轉換成模型 或者是模型數組 來看一下這個方法 我是單獨定義了一個json轉模型的類`LLToModelExtension.swift`
extension Observable{ func mapObject(type: T.Type) -》 Observable{ return self.map { response in guard let dict = response as? [String : Any] else{ throw RxSwiftMoyaError.ParseJS } return Mapper().map(JSON: dict)! } } func mapArray(type: T.Type) -》 Observable《[t]》 { return self.map { response in //if response is an array of dictionaries, then use ObjectMapper to map the dictionary //if not, throw an error guard let array = response as? [Any] else { throw RxSwiftMoyaError.ParseJS } guard let dicts = array as? [[String: Any]] else { throw RxSwiftMoyaError.ParseJS } return Mapper().mapArray(JSONArray: dicts) } } } enum RxSwiftMoyaError: String { case ParseJS case OtherError } extension RxSwiftMoyaError: Swift.Error { }
介紹一下上邊代碼中各個方法以及名詞
* 1 `mapObject` 方法是處理單個對象的 `mapArray` 處理對象數組
* 2 如果傳進來的數據 是一個`NSDictionary` 的話 那么就利用 `ObjectMapper` 的 `map` 方法映射這些數據,這個方法會調用你之前在 mapping 方法里面定義的邏輯。
* 3 如果 `response` 不是一個 `dictionary`, 那么就拋出一個錯誤。
* 4 在底部自定義了簡單的 Error,繼承了 Swift 的 Error 類,在實際應用過程中可以根據需要提供自己想要的 Error。
彩蛋
**可能會有人問 為什么請求回來的數據 要賦值給modelObserable.Value呢 而不是賦值給一個模型數組 然后reloadData呢**
這里我用的RXSwift里邊UItableView綁定數據的一個方法 再也不用寫一大串數據源方法了 這個也可以去[這里](http://www.jianshu.com/p/00ded20182d2)參考哦
var modelObserable = Variable《[storymodel]》 ([]) //MARK: Rx 綁定tableView數據 modelObserable.asObservable().bind(to: tableV.rx.items(cellIdentifier: cellID, cellType: LLHomeCell.self)){ row , model , cell in cell.titleLbl.text = model.title cell.imageV?.kf.setImage(with: URL.init(string: (model.images?.count)! 》 0 ? (model.images?.first)! : “”)) }.addDisposableTo(bag)
[Swift項目框架地址](https://github.com/liuniuliuniu/LLProgramFramework.Swift)
非常好我支持^.^
(0) 0%
不好我反對
(0) 0%