如何在 Swift 中使用 Alamofire 进行网络编程

2014 年 6 月 Apple 发布 Swift 以来，如何在 Swift 中进行网络编程一直成为程序猿们关注的焦点。甚至，Chris Lattner，Swift 的作者之一，也发推说过，在 Swift 中解析 JSON 还有很长的路要走。因此，许多人开始寻求替代方案。尽管，在 Swift 中也有处理 JSON 解析的内建类，但是对开发者来说并不是很友好。幸运的是，Alamofire 出现了。Alamofire 是一个可以帮助我们解析 JSON 的强有力网络库，它由 Objective-C 中同类网络库 AFNetworking 的作者编写。

在这个又臭又长、近乎 3500 多词（译者注：in English）的教程中，我们将探讨一系列广泛的网络基本话题，并建立一个假日待办应用。

同时，你会从本教程中学到：如何使用和解析 JSON，如何自定义服务器端，如何使用 Heroku 和 MongoLab 等工具，HTTP 的工作原理（包括 GET，POST 和 DELETE 请求），如何使用 git 和终端（terminal）以及如何使用 Cocoapods。如果你觉得上面提到的内容太多了，那就对了，拿一杯咖啡，就让我们开始吧。

哦，AppCoda 的所有作者祝大家节日开心！:blush:

注意：本教程是一个进阶教程，涵盖了很多东西。而且，我假设你已经对 iOS 和 Swift 有了很坚实的了解。文章中诸如 tableviews， autolayout，delegate 等话题都不会深入的解释原理。你如果记不清这些内容，可以先去学习我们推出的 优秀课程 ，然后再回来看本教程。

开始

为了实现本教程要实现的功能，我已用 Node.js 写了一个服务器后端。这里需要给那些对它不熟悉的人解释一下，Node.js 是一个基于 Javascript、运行在 Google Chrome 的 V8 引擎中的运行时环境。长话短说，总之它是一个特别可靠，速度特别快，特别厉害的东西，哈哈。

为了搞定这个后端，我同时也使用了 Restify 和 MongoDB。MongoDB 是在 Web 开发人员中很流行的一个 no-SQL 数据库。我们可以使用 MongoDB 存储所有我们相关的数据。

当我刚开始使用 Node 的时候，我不知道这些东西都是怎么运行的，其他我所浏览的一些博客也从没有解释 Node 到底是怎么工作的。因此，尽管这是个 iOS 的博客，但我还是要介绍一下 Javascript 和 Node 服务器的工作原理。

我搜遍了网络，都没有一个详细的教程引导你创建一个 API 与 iOS 应用程序交互的步骤，从现在开始就有了。

遇见 Node.js

像我之前提到的一样，Node.js 是一个很强大的服务器端开发技术，它建立在 Chrome 的运行时环境上。因此，它是高度异步的和非阻塞的（如果你不知道我说的是什么意思，其实很简单，大概就是：使用主线程或者应用的主要部分不会被阻塞）。多线程是一种可以防止延迟且能提高项目效率的编程技术。你把应用想象成一条高速公路，如果只有一条通道，却有 20 辆车要通过，那么他们就很有可能会堵车。如果一条高速公路有三条都有出入口的通道，那么堵车的机会就很小。多线程就可以这样来理解。在一个多线程的环境里，代码执行在不同的线程就可以避免应用阻塞，从而防止程序奔溃。

Node 是由 Joyent 开发并维持的，Joyent 是一家位于旧金山的云计算公司。

如果你仍然不清楚所有这些是怎么运行的，想想后端具体干了些什么吧。下面列出来一些：

1. 后端是一个为你传送 API 的地方（我们现在正在为当前的应用构建 API，就和网络上其他的 API 一样，其中包括了我们在之前的 tvOS 教程 中使用的 forecast.io API）。
2. MongoDB 提供了一个保存所有数据的地方。当你想要 POST 一条新的消息，我们需要有个地方可以存储这条消息。在本教程中，我们将把这些数据存储到 MongoDB 数据库中。
3. 创建一个功能完整的 REST API，它遵循 REST 协议。

我们的 MongoDB 放在 MongoLab 的主机上，Node 服务器放在 Heroku 上。Heroku 由 Salesforce 提供支持，可以作为 Node，Rails，Python等应用的主机服务商。MongoLab 也是一家可以当 MongoDB 主机的服务商。

HTTP 请求介绍

在我们开始写代码之前，你应该了解 HTTP 请求以及如何在我们的应用里使用。

• GET 请求 - GET 请求会查询我们的数据库，然后获取内容。GET 请求可以被限制，使得其只能获取一个、多个或全部的内容。事实上，每次你访问 google.com 或浏览你的 非死book/推ter 主页，你都会发起 GET 请求（可能你之前都不知道这个东西）！

• POST 请求 - POST 请求会发送数据到服务器，然后保存这个数据。举个例子，当你在 非死book 或 推ter 上写好文字，然后按 Post/Tweet 按钮的时候，你就发起了 POST 请求。

• UPDATE 请求 - UPDATE 请求可以让你修改已经存在的内容。当你编辑一条 非死book 消息时，其实使用到了 UPDATE 请求。

• DELETE 请求 - DELETE 请求会删除对应的内容。当你按了删除按钮删除 非死book 或 推ter 消息的时候，其实是调用了 DELETE 请求。

以上这四个请求类型是基于 REST 协议的。Internet 能运行就是由这些请求组成的。你可能也听说过 CRUD 这个缩写词，CRUD 是由 C reate， R ead， U pdate 和 D elete 的首字母组成的。很显然，这些单词就和 POST，GET，UPDATE 和 DELETE 是一一对应的。

帅气！现在我们已经对 HTTP 协议有一定的理解了，我们可以进入到这次教程的核心部分了。

配置必要的工具

在我们使用 MongoLab 或 Heroku 之前，我们应该要确保 Node.js 能正常使用。

打开 Node.js官网 ，根据简单的引导下载 Node 到你的电脑上。

然后，到 npm 官网 下载 npm。

为了正确配置我们的后端，我们需要分别在 Heroku 和 MongoLab 上注册帐号。我们先从 MongoLab 开始吧，去 MongoLab 官网 注册帐号。

确保选择的是 single-node（免费），填上你数据库的名字。我这边取名为 alamofire-db （以 db 为后缀表示是一个数据库，这是比较普遍的命名规范）。

接下来，登录你的数据库，定位好 MongoDB 数据库的 URI。

马上就让你添加一个新的数据库帐号，输入用户名和密码。不要忘记密码。

现在返回到你设置 URI 的页面，修改成新的地址。比如：

mongodb://<dbuser>:<dbpassword>@ds057954.mongolab.com:57954/alamofire-db

mongodb://gregg:test@ds057954.mongolab.com:57954/alamofire-db

git init  git add .  git commit -m "First Commit"

var express = require('express'); // 1  var app = express(); // 2  // 当一个 GET 请求访问主页的时候，会返回 hello world  app.get('/', function(req, res) { // 3    res.send('hello world'); // 4  });

var mongoose = require('mongoose'),      Schema = mongoose.Schema;     var TodoSchema  = new Schema(      {    name: String  });     mongoose.model('employees', TodoSchema);

var emp = new Todo(req.body);         emp.save(function(err){          if (err) {              res.send('Error occurred');              return console.log(err);          }          res.send(emp);  });

curl -i -H "Accept: application/json" "https://rocky-meadow-1164.herokuapp.com/todo"

curl -H "Content-Type: application/json" -X POST -d '{"name":"Buy Presents"}' https://rocky-meadow-1164.herokuapp.com/todo

curl -X DELETE 'https://rocky-meadow-1164.herokuapp.com/todo/5657901fee93910900cc54ed'

$ gem install cocoapods

vim Podfile

source 'https://github.com/CocoaPods/Specs.git'     platform :ios, '8.0'     use_frameworks!     pod 'Alamofire', '~> 3.0'

pod install

open .

import Alamofire

Alamofire.request(.GET, "https://rocky-meadow-1164.herokuapp.com/todo") .responseJSON { response in // 1        print(response.request)  // original URL request        print(response.response) // URL response        print(response.data)     // server data        print(response.result)   // result of response serialization          if let JSON = response.result.value {           print("JSON: \(JSON)")          }  }

import UIKit  import Alamofire  class ViewController: UIViewController {         @IBOutlet weak var tableView: UITableView!      var jsonArray:NSMutableArray?      var newArray: Array<String> = []         override func viewDidLoad() {          super.viewDidLoad()                    Alamofire.request(.GET, "https://rocky-meadow-1164.herokuapp.com/todo") .responseJSON { response in                  print(response.request)  // original URL request                  print(response.response) // URL response                  print(response.data)     // server data                  print(response.result)   // result of response serialization                    if let JSON = response.result.value {                      self.jsonArray = JSON as? NSMutableArray                      for item in self.jsonArray! {                          print(item["name"]!)                          let string = item["name"]!                          print("String is \(string!)")                            self.newArray.append(string! as! String)                      }                        print("New array is \(self.newArray)")                        self.tableView.reloadData()                  }          }                // Do any additional setup after loading the view, typically from a nib.      }  }

Alamofire.request(.GET, "https://rocky-meadow-1164.herokuapp.com/todo").responseJSON { response in debugPrint(response) }

self.tableView.dataSource = self  self.tableView.delegate = self

func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {      return self.newArray.count  }    func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {      let cell = tableView.dequeueReusableCellWithIdentifier("Cell", forIndexPath: indexPath) as UITableViewCell        cell.textLabel?.text = self.newArray[indexPath.row]      return cell  }    override func didReceiveMemoryWarning() {      super.didReceiveMemoryWarning()      // Dispose of any resources that can be recreated.  }

Alamofire.request(.POST, "https://rocky-meadow-1164.herokuapp.com/todo", parameters: ["name": self.textView.text!])    self.navigationController!.popViewControllerAnimated(true)

func downloadAndUpdate() {          Alamofire.request(.GET, "https://rocky-meadow-1164.herokuapp.com/todo") .responseJSON { response in              print(response.request)  // original URL request              print(response.response) // URL response              print(response.data)     // server data              print(response.result)   // result of response serialization                if let JSON = response.result.value {                  self.jsonArray = JSON as? NSMutableArray                  for item in self.jsonArray! {                      print(item["name"]!)                      let string = item["name"]!                      print("String is \(string!)")                        self.newArray.append(string! as! String)                  }                  print("New array is \(self.newArray)")                  self.tableView.reloadData()              }          }        }

override func viewWillAppear(animated: Bool) {     self.downloadAndUpdate()  }

var IDArray: Array<String> = []

self.newArray.removeAll() // NEW  self.IDArray.removeAll() // NEW    Alamofire.request(.GET, "https://rocky-meadow-1164.herokuapp.com/todo") .responseJSON { response in              print(response.request)  // original URL request              print(response.response) // URL response              print(response.data)     // server data              print(response.result)   // result of response serialization                if let JSON = response.result.value {                  self.jsonArray = JSON as? NSMutableArray                  for item in self.jsonArray! {                      print(item["name"]!)                      let string = item["name"]!                      let ID = item["_id"]! // NEW                        self.newArray.append(string! as! String)                      self.IDArray.append(ID! as! String) // NEW                  }                  print("New array is \(self.newArray)")                  self.tableView.reloadData()              }          }

func tableView(tableView: UITableView, commitEditingStyle editingStyle: UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {          if editingStyle == .Delete {              print("ID is \(self.IDArray[indexPath.row])")                Alamofire.request(.DELETE, "https://rocky-meadow-1164.herokuapp.com/todo/\(self.IDArray[indexPath.row])")              self.downloadAndUpdate()                        } else if editingStyle == .Insert {              // Create a new instance of the appropriate class, insert it into the array, and add a new row to the table view          }      }