一、过去这么干
我们在iOS开发中进行网络请求的时候,一般是获取到服务器返回的data后,再根据我们的需要转换成JSON,图像等信息:
let myURL = NSURL(string: "http://imgs.xkcd.com/comics/scrabble.png")!
let task = NSURLSession.sharedSession().dataTaskWithURL(myURL, completionHandler: { (data, response, error) -> Void in
let image = UIImage(data: data)
//use the image
})
但如果你的应用中存在各种类型的返回数据,那么你可能就要在各个网络请求的中进行重复的处理了。
二、在Swift-beta时代
下面,我们使用swift中的泛型和extension让你的数据解析工作更优雅。
首先我们建立一个protocol:
public protocol ResponseConvertible{
class func convertFromData(data:NSData!) -> (Self?,NSError?)
}
这个protocol负责把网络请求返回的NSData转化成我们想要的任何类型。
相信大家应该注意到了返回中的Self了,把返回定义为Self是因为这个接口本身是没有包含类型信息的,我们并不知道哪个类会实现这个接口,所以我们使用Self来指代将要实现这个接口的类。
接着,我们使用extension来为JSON(我使用的是SwiftJSON),UIImage,NSData这三个类实现我们的ResponseConvertible接口:
extension JSON:ResponseConvertible{
public static func convertFromData(data:NSData!) -> (JSON?, NSError?){
let value = JSON(data: data, options: NSJSONReadingOptions.MutableContainers, error: nil)
switch value.type{
case .Null:
return (value, value.error)
default:
return (value, nil)
}
}
}
extension NSData:ResponseConvertible{
public class func convertFromData(data: NSData!) -> (NSData?, NSError?) {
return (data,nil)
}
}
extension UIImage:ResponseConvertible{
public typealias Result = UIImage
public class func convertFromData(data: NSData!) -> (UIImage?, NSError?) {
return (UIImage(data: data),nil)
}
}
然后,我们再新建一个名为MyRequest的自定义的网络请求类:
class MyRequest < T:ResponseConvertible> {
var url:NSURL
init(url:NSURL) {
self.url = url
}
//这里用一个简单的请求进行说明,实际应用中可以构建一个最适合你的网络请求框架
func aSimpleRequest(completionHandler:(T?,NSError!) -> ()){
let session = NSURLSession.sharedSession()
let task = session.dataTaskWithURL(url, completionHandler: { (data, response, error) -> Void in
if error == nil{
//用ResponseConvertible接口进行数据转换
let(object, converError) = T.convertFromData(data)
completionHandler(object,converError)
}
})
task.resume()
}
}
好了,准备工作完成,我们终于可以使用优化后的请求方法了。请求时,< T:ResponseConvertible>接受一个实现了ResponseConvertible接口的类型,例如UIImage:
let myURL = NSURL(string: "http://imgs.xkcd.com/comics/scrabble.png")!
MyRequest< UIImage>(url: myURL).aSimpleRequest({image,error in
self.imageView.image = image
})
这样,我们只要在发起请求前定义好我们需要返回的类型,接口就会如愿地为你返回该类型的数据了。是不是比文章一开始的方法优雅多了?
三、现在应该这么干
不过,如果你现在把以上代码拷贝进你运行在Xcode6正式版的项目,你会发现Xcode会报错:
错误详情:
Protocol 'ResponseConvertible' requirement 'convertFromData' cannot be satisfied by a non-final class ('NSData') because it uses 'Self' in a non-parameter, non-result type position
而这些代码在Swift-beta时代是能正常运行的。看来苹果在Swift1.0中对Self的用法进行了修改。
根据错误的提示,我们需要把使用了Self的类定义为final,而这在自定义的类中的确有用:
final class MyClass: {
//...
}
但是对于UIImage,NSData这些系统的类就无能为力了。这个问题困扰了我好一会,stackoverflow无果,请教一些盆友都表示对Self的用法不熟或压根没动过Swift。
最后,还是在typealias的帮助下绕过了,typealias 可以为已经存在的类型和方法重新定义一个快捷名字,比如
typealias Result = UIImage
这里的Result就相当于UIImage类型了。
引入typealias后,以上的代码做如下修改,就能在新版本的Xcode下运行了:
public protocol ResponseConvertible{
typealias Result
class func convertFromData(data:NSData!) -> (Result?,NSError?)
}
extension JSON:ResponseConvertible{
public typealias Result = JSON
public static func convertFromData(data:NSData!) -> (Result?, NSError?){
let value = JSON(data: data, options: NSJSONReadingOptions.MutableContainers, error: nil)
switch value.type{
case .Null:
return (value, value.error)
default:
return (value, nil)
}
}
}
extension NSData:ResponseConvertible{
public typealias Result = NSData
public class func convertFromData(data: NSData!) -> (NSData?, NSError?) {
return (data,nil)
}
}
extension UIImage:ResponseConvertible{
public typealias Result = UIImage
public class func convertFromData(data: NSData!) -> (UIImage?, NSError?) {
return (UIImage(data: data),nil)
}
}
class MyRequest< T:ResponseConvertible> {
//这里用一个简单的请求说明,实际应用中可以构建一个最适合你的网络请求框架
var url:NSURL
init(url:NSURL) {
self.url = url
}
func aSimpleRequest(completionHandler:(T.Result?,NSError!) -> ()){
let session = NSURLSession.sharedSession()
let task = session.dataTaskWithURL(url, completionHandler: { (data, response, error) -> Void in
if error == nil{
let(object, converError) = T.convertFromData(data)
completionHandler(object,converError)
}
})
task.resume()
}
}
使用:
let myURL = NSURL(string: "http://imgs.xkcd.com/comics/scrabble.png")!
MyRequest< UIImage>(url: myURL).aSimpleRequest({image,error in
self.imageView.image = image
})