实际应用中封装网络请求库 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<A> {
let url: URL
let parse: (Data) -> A?
}
let episodesResource = Resource<Data>(url: url, parse: { data in
return data
})
Resource
和具体业务相关且独立,可复用,有点类似小时候游戏机的卡带,那么“小霸王”学习机加载口在哪里?
final class Webservice {
func load<A>(_ resource: Resource<A>, 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<Any>(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<Media> {
let url = NSURL(string: "http://localhost:8000/episodes/\(id).json")!
// TODO Return the resource ...
}
}
欢迎关注我的微博:@Ninth_Day