# 01 Networking

实际应用中封装网络请求库 Webserver，目前只讨论 HTTP 请求：1.URL 拼接请求参数 -> 2.发起请求 -> 3.解析返回数据 -> 4.回调处理

final class Webservice {
    var url1:String = "xxxx"
    var url2:String = "xxxx"
    
    func loadEpisodes(completion: ([Episode]?) -> ()) {
        // 发起请求+解析+回调处理
    }

    func loadMedia(episode: Episode, completion: (Media?) -> ()) {
        // 发起请求+解析+回调处理
    }
}

Webservice 类现在和业务紧密联系在了一起，且随着请求增加会越来越臃肿；造成这一现象的原因有两点：1.请求链接（这个无法避免） 2. 解析（可能我想将NSData解析成JSON 可能是其他）。现在我们将这部分提取出来，构造一个 Resource ———— 为了更加通用，我们采用泛型：

struct Resource {
    let url: URL
    let parse: (Data) -> A? 
}
let episodesResource = Resource(url: url, parse: { data in
    return data
})

Resource 和具体业务相关且独立，可复用，有点类似小时候游戏机的卡带，那么“小霸王”学习机加载口在哪里？

final class Webservice {
    func load(_ resource: Resource, completion: @escaping (A?) -> ()) {
        // 发起请求
        URLSession.shared.dataTask(with: resource.url as URL) { data, _, _ in
            let result = data.flatMap(resource.parse) 
            completion(result)
        }.resume()
    }
}

更多 flatMap 的使用，请见flatMap 温顾知新 —— 参照 Swift 源码实现讲解一文。

Data 返回数据，一般我们希望解析成JSON，XML，字典，甚至直接映射到某个类，例如：
// 1 Data -> Any

let resource1 = Resource(url: url, parse: { data in
     let json = try? JSONSerialization.jsonObject(with: data, options: [])
    return json
})

// 2 Data -> Dictionary

typealias JSONDictionary = [String: AnyObject]

let resource2 = Resource<[JSONDictionary]>(url: url, parse: { data in
    let json = try? JSONSerialization.jsonObject(with: data, options: [])
    return json as? [JSONDictionary]
})

// 3 Data -> [Episode]

struct Episode {
    let id: String
    let title: String
}

extension Episode {
    init?(dictionary: JSONDictionary) {
        guard let id = dictionary["id"] as? String,
            let title = dictionary["title"] as? String else { return nil }
        self.id = id
        self.title = title
    }
}

let episodesResource = Resource<[Episode]>(url: url, parse: { data in
    let json = try? JSONSerialization.jsonObject(with: data, options: [])
    guard let dictionaries = json as? [JSONDictionary] else { return nil }
    return dictionaries.flatMap(Episode.init)
})

对于 Resource 来说，输入为 Data 类型，而目的类型各式各样，如果让用户直接操作 Data 可能会不知所措，为此我们希望给相对友好点的类型 AnyObject，因此 Data->AnyObject 这一步转换我们会默认实现：

extension Resource {
    init(url: NSURL, parseJSON: AnyObject -> A?) {
        self.url = url
        // 默认解析闭包
        self.parse = { data in
            // json 类型为 AnyObject
            let json = try? NSJSONSerialization.JSONObjectWithData(data, options: [])
            
            return json.flatMap(parseJSON) // 注意这里parseJSON接受参数类型是 AnyObject
        }
    }
}

let episodesResource = Resource<[Episode]>(url: url, parseJSON: { json in
    guard let dictionaries = json as? [JSONDictionary] else { return nil }
    return dictionaries.flatMap(Episode.init)
})

Resource 是 Episode 的资源之一，所以定义在 Episode 中比较合适：

extension Episode {
    var media: Resource {
        let url = NSURL(string: "http://localhost:8000/episodes/\(id).json")!
        // TODO Return the resource ...
    }
}

欢迎关注我的微博：@Ninth_Day