您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

自己動手寫一個 iOS 網絡請求庫(二):封裝出好用的接口

編輯:iOS 開發基礎

系列前文:自己動手寫一個 iOS 網絡請求庫(一)NSURLSession 初探。

代碼示例:https://github.com/johnlui/Swift-On-iOS/blob/master/BuildYourHTTPRequestLibrary

開源項目:Pitaya,適合大文件上傳的 HTTP 請求庫:https://github.com/johnlui/Pitaya

這一篇的目標:用一個類把之前的代碼封裝起來,加入動態傳參(params)的能力,最終收斂成一個強大的調用接口。

最基礎的封裝

新建 Swift 文件 Network.swift,寫一個 Network 類和一個靜態方法 request():

class Network {
    static func request() {
        let session = NSURLSession.sharedSession()
        let request = NSURLRequest(URL: NSURL(string: "https://baidu.com")!)
        let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
            println("just wait for 5 seconds!")
            sleep(5)
            let string = NSString(data: data, encoding: NSUTF8StringEncoding)
            println(string)
        })
        task.resume()
    }
}

ViewController 中的按鈕方法相應改為:

@IBAction func mainButtonBeTapped(sender: AnyObject) {
    Network.request()
}

運行、點擊按鈕,效果與之前一致。

自定義 HTTP 方法與 URL

static func request(method: String, url: String) {
    let session = NSURLSession.sharedSession()
    let request = NSMutableURLRequest(URL: NSURL(string: url)!)
    request.HTTPMethod = method
    let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
        println("just wait for 5 seconds!")
        sleep(5)
        let string = NSString(data: data, encoding: NSUTF8StringEncoding)
        println(string)
    })
    task.resume()
}

調用處改為:

@IBAction func mainButtonBeTapped(sender: AnyObject) {
    Network.request("GET", url: "https://baidu.com")
}

用閉包處理請求結果

函數在 Swift 中是一等公民,閉包既能作參數也能作返回值。把一個回調閉包傳進 request():

static func request(method: String, url: String, callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let session = NSURLSession.sharedSession()
    let request = NSMutableURLRequest(URL: NSURL(string: url)!)
    request.HTTPMethod = method
    let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
        callback(data: data, response: response, error: error)
    })
    task.resume()
}

調用處傳入閉包:

@IBAction func mainButtonBeTapped(sender: AnyObject) {
    Network.request("GET", url: "https://baidu.com") {(data, response, error) -> Void in
        println("just wait for 5 seconds!")
        sleep(5)
        let string = NSString(data: data, encoding: NSUTF8StringEncoding)
        println(string)
    }
}

動態增加 Params

GET 方法

GET 下,params 經過 url encode 之後直接附加在 URL 末尾。給 request() 加上一個参數字典:

static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    ...
}

params 的處理函數直接從 Alamofire 借來。完整代碼:

class Network {
    static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
        let session = NSURLSession.sharedSession()

        var newURL = url
        if method == "GET" {
            newURL += "?" + Network().buildParams(params)
        }

        let request = NSMutableURLRequest(URL: NSURL(string: newURL)!)
        request.HTTPMethod = method

        let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
            callback(data: data, response: response, error: error)
        })
        task.resume()
    }

    // 從 Alamofire 借來的三個函數
    func buildParams(parameters: [String: AnyObject]) -> String {
        var components: [(String, String)] = []
        for key in sorted(Array(parameters.keys), <) {
            let value: AnyObject? = parameters[key]
            components += queryComponents(key, value)
        }
        return join("&", components.map({"\($0.0)=\($0.1)"}))
    }

    func queryComponents(key: String, _ value: AnyObject?) -> [(String, String)] {
        var components: [(String, String)] = []
        if let dictionary = value as? [String: AnyObject] {
            for (nestedKey, value) in dictionary {
                components += queryComponents("\(key)[\(nestedKey)]", value)
            }
        } else if let array = value as? [AnyObject] {
            for value in array {
                components += queryComponents("\(key)", value)
            }
        } else {
            components.extend([(escape(key), escape("\(value)"))])
        }
        return components
    }

    func escape(string: String) -> String {
        let legalURLCharactersToBeEscaped: CFStringRef = ":&=;+!@#$()',*"
        return CFURLCreateStringByAddingPercentEscapes(nil, string, nil, legalURLCharactersToBeEscaped, CFStringBuiltInEncodings.UTF8.rawValue) as String
    }
}

調用處:

@IBAction func mainButtonBeTapped(sender: AnyObject) {
    Network.request("GET", url: "https://pitayaswift.sinaapp.com/pitaya.php", params: ["get": "Network"]) {(data, response, error) -> Void in
        let string = NSString(data: data, encoding: NSUTF8StringEncoding)
        println(string)
    }
}

這個測試服務端會直接返回 ?get=ooxx 中的 ooxx。

POST 方法

POST 有多種協議可選,這裡沒有文件上傳需求,採用最簡單的 application/x-www-form-urlencoded。request() 再補一段:

static func request(method: String, url: String, params: Dictionary = Dictionary(), callback: (data: NSData!, response: NSURLResponse!, error: NSError!) -> Void) {
    let session = NSURLSession.sharedSession()

    var newURL = url
    if method == "GET" {
        newURL += "?" + Network().buildParams(params)
    }

    let request = NSMutableURLRequest(URL: NSURL(string: newURL)!)
    request.HTTPMethod = method

    if method == "POST" {
        request.addValue("application/x-www-form-urlencoded", forHTTPHeaderField: "Content-Type")
        request.HTTPBody = Network().buildParams(params).dataUsingEncoding(NSUTF8StringEncoding)
    }

    let task = session.dataTaskWithRequest(request, completionHandler: {(data, response, error) -> Void in
        callback(data: data, response: response, error: error)
    })
    task.resume()
}

調用處:

@IBAction func mainButtonBeTapped(sender: AnyObject) {
    Network.request("POST", url: "https://pitayaswift.sinaapp.com/pitaya.php", params: ["post": "Network"]) {(data, response, error) -> Void in
        let string = NSString(data: data, encoding: NSUTF8StringEncoding)
        println(string)
    }
}

服務端會返回 key 為 post 的 value,結果與 GET 一致。至此,接口封裝完成。

下一篇:自己動手寫一個 iOS 網絡請求庫(三)降低耦合。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved