SwiftHTTP的使用(译)

SwiftHttp是是一种轻便型的NSURLSession网络请求封装,可以让你的HTTP请求更加简明快捷.

项目地址:https://github.com/daltoniam/SwiftHTTP

GET:

最基本的请求。默认情况下，将返回一个NSData对象的response。

do {
    let opt = try HTTP.GET("https://google.com")
    opt.start { response in
        if let err = response.error {
            print("error: \(err.localizedDescription)")
            return //also notify app of failure as needed
        }
        print("opt finished: \(response.description)")
        //print("data is: \(response.data)") access the response of the data with response.data
    }
} catch let error {
    print("got an error creating the request: \(error)")
}

我们还可以为其添加参数，他们会正确地序列化到各自的HTTP请求中。

do {
    //the url sent will be https://google.com?hello=world¶m2=value2
    let opt = try HTTP.GET("https://google.com", parameters: ["hello": "world", "param2": "value2"])
    opt.start { response in
        if let err = response.error {
            print("error: \(err.localizedDescription)")
            return //also notify app of failure as needed
        }
        print("opt finished: \(response.description)")
    }
} catch let error {
    print("got an error creating the request: \(error)")
}

HttpResponse包含了所有基本的HTTP响应数据，如response返回数据和response返回头。

Post

let params = ["param": "param1", "array": ["first array element","second","third"], "num": 23, "dict": ["someKey": "someVal"]]
do {
    let opt = try HTTP.POST("https://domain.com/new", parameters: params)
    opt.start { response in
    //do things...
    }
} catch let error {
    print("got an error creating the request: \(error)")
}

Json RequestSerializer

请求参数也可以被序列化为JSON类型。默认情况下，使用标准的HTTP请求序列化形式编码。

do {
    let opt = try HTTP.New("https://google.com", method: .GET, requestSerializer: JSONParameterSerializer())
    opt.onFinish = { response in
        if let err = response.error {
            print("error: \(err.localizedDescription)")
            return //also notify app of failure as needed
        }
        print("opt finished: \(response.description)")
    }
} catch let error {
    print("got an error creating the request: \(error)")
}

Operation Queue

SwiftHTTP也支持队列操作

let operationQueue = NSOperationQueue()
operationQueue.maxConcurrentOperationCount = 2
do {
    let opt = try HTTP.New("https://google.com", method: .GET)
    opt.onFinish = { response in
    //do stuff
    }
    operationQueue.addOperation(opt)
} catch let error {
    print("got an error creating the request: \(error)")
}

Cancel

如果你稍后想取消这个请求,那么你可以调用其取消方法

opt.cancel()

Progress

SwiftHTTP也可以监控一个请求的进度.

do {
    let opt = try HTTP.GET("https://domain.com/somefile")
    opt.progress = { progress in
        print("progress: \(progress)") //this will be between 0 and 1.
    }
    opt.start { response in
    //do stuff
    }
} catch let error {
    print("got an error creating the request: \(error)")
}

Global handlers

SwiftHTTP也可以进行全局处理，减少重复的HTTP请求修改，如确定的报头或设置NSMutableURLRequest性质如timeoutinterval(超时设置)。

//modify NSMutableURLRequest for any Factory method call (e.g. HTTP.GET, HTTP.POST, HTTP.New, etc).
HTTP.globalRequest { req in
    req.timeoutInterval = 5
}

//set a global SSL pinning setting
HTTP.globalSecurity(HTTPSecurity()) //see the SSL section for more info

//set global auth handler. See the Auth section for more info
HTTP.globalAuth { challenge in
    return NSURLCredential(user: "user", password: "passwd", persistence: .ForSession)
}

//

由于能力所限,就自己理解进行了翻译,有很多不周到之处请指正,文章中还有一部分是笔者尚未涉及到的内容,不敢贸然翻译,只当抛砖引玉.