[译] 有关用 Swift 访问后端服务器的 API 文档

泡在网上的日子 / 文 发表于2016-08-31 12:36 次阅读 Swift

我最近开始开发一个全新的项目,并且我正尝试一些新的设计模式,因为我开始投身于 Swift 3。我正使用的一个模式是“请求和响应模型”。这个“酷炫”的名字是我为记录这个后台 API 文档中的 Struct (结构体)。让我们来看一个例子:

import Alamofire

protocol Request {
    var path : String { get }
    var method : Method { get }
    func parameters() -> [String : AnyObject]
}

struct AuthRequest : Request {
    let path = "auth"
    let method = Method.POST

    var password : String
    var password_verify : String
    var name : String
    var email : String

    func parameters() -> [String : AnyObject] {
        return ["password" : password, "password_verify" : password_verify, "name" : name, "email" : email]
    }
}

我们申明了一个 Request 协议,关于你所需要知道发起一个 API 请求的所有内容,它基本上都明确指出来了。

  • 需要添加进基本地址 (URL) 的路径(本例中是 auth )

  • HTTP 方法(GET, POST, PUT, DELETE 等等)

  • 端点所要求的参数

为了需要的信息,你可以扩展这个协议,例如某个指定的 ContentType 或者其他 HTTP 报头。你能想象到增加一些验证规则,(请求)完成处理方法,或者与这个协议网络请求有关的任何东西。

所有这些结构体现在应该看上去像一个简明扼要的 API 文档,并且为你的网络操作提供了一些框架结构和类型安全验证。你可以把这些请求的结构体转变成你最喜欢的网络客户端。我有一个例子 Alamofire

class Client {
    var baseURL = "http://dev.whatever.com/"

    func execute(request : Request, completionHandler: (Response<AnyObject, NSError="">) -> Void){
        Alamofire.request(request.method, baseURL + request.path, parameters: request.parameters())
            .responseJSON { response in
                completionHandler(response)
        }
    }
}

Client().execute(request: AuthRequest(/*Insert parameters here*/), completionHandler: { response in } )

我们把 AuthRequest 对象传递给 Alamofire,它需要一个通用的对象去确认Request 协议。它使用来自协议中规定的属性/方法来构造并执行一个网络请求。

现在我们已经定义了这个请求的结构体,并且使用它简单的访问服务器。我们现在需要处理响应。我们的 AuthRequest 返回一个不太大的用户 JSON 对象,我们需要把它序列化成一个 Swift 对象。

struct UserResponse {
    var _id : String
    var first_name : String
    var last_name : String

    init(JSON: [String : AnyObject]) {
        _id = JSON["_id"] as! String
        first_name = JSON["first_name"] as! String
        last_name = JSON["last_name"] as! String
    }
}

/* Inside our completion handler */
var user = UserResponse(JSON: response.result.value as! [String : AnyObject])

这个实现不太花哨,但是仍然记录了响应对象的属性。你能创建一个协议,它用来定义一个 JSON 初始器,但是使用简单的结构体目前对我来说已经足够了。

你发现这个实现有任何问题么? 有什么方法能让我更高效地使用协议/扩展来组成我的网络请求代码么?请让我知道!@iAmChrisTruman


收藏 赞 (0) 踩 (0)
上一篇:[译] iOS 开发,该如何解决弹窗的设计问题?
原文链接: Preventing Popovers on Popovers 译文出自: 掘金翻译计划 译者: llp0574 校对者: yifili09 , Graning iOS 9 的页面用了一种我们不能复现的方式去展示一个活动视图控制器,并且当从内部表单和弹窗呈现操作列表和活动视图控制器时 UIKit 的行为一开
下一篇:不服跑个分 - 顶级 Swift 服务端框架对决 Node.js
原文地址: Benchmarks for the Top Server-Side Swift Frameworks vs. Node.js 译文出自: 掘金翻译计划 译者: Tuccuay 校对者: 鳗鱼鱼 , Nicolas(Yifei) Li 前言 最近我在做服务端 Swift 工作时,我被问到这样的问题: 「在服务端 Swift 能否击败 Node.j