(Swift)iOS Apps with REST APIs(十

重要说明: 这是一个系列教程，非本人原创，而是翻译国外的一个教程。本人也在学习Swift，看到这个教程对开发一个实际的APP非常有帮助，所以翻译共享给大家。原教程非常长，我会陆续翻译并发布，欢迎交流与分享。

删除并不比收藏和取消收藏功能复杂。我们只需要检查开发文档，并从中找到需要调用的API接口，然后在GitHubAPIManager中实现，最后在用户界面中做相应处理即可。

和收藏和取消收藏一样，调用删除功能需要用户认证。因为，我们是无法删除其他用户的Gist。

调用删除API

删除Gist需要调用下面需要登录验证的API：

https://api.github.com/gists/*gistID*

我们可以GitHubAPIManager中实现该调用，并检查OAuth认证是否仍然有效：

func deleteGist(gistId: String, completionHandler: (NSError?) -> Void) { 
  alamofireManager.request(GistRouter.Delete(gistId))
    .response { (request, response, data, error) in
      if let urlResponse = response, authError = self.checkUnauthorized(urlResponse) {
        completionHandler(authError)
        return
      }
      if let error = error {
        print(error)
        return
      }
      completionHandler(error)
  }
}

然后修改路由器：

enum GistRouter: URLRequestConvertible {
  static let baseURLString:String = "https://api.github.com"
  
  ...
  case Delete(String) // DELETE https://api.github.com/gists/\(gistId)
  
  var URLRequest: NSMutableURLRequest { 
    var method: Alamofire.Method {
      switch self { 
      ...
      case .Delete:
        return .DELETE 
      }
    }
    
    let result: (path: String, parameters: [String: AnyObject]?) = { 
      switch self {
      ...
      case .Delete(let id):
        return ("/gists/\(id)", nil) 
      }
    }()
    
    ...
    
    return encodedRequest 
  }
}

注意：该功能真的会删除哦，不要删除你不想删除的。最好，你先建一些临时分支，来测试本功能。

如果你的APP中可以删除，那么参考上面的代码来完成。

界面处理：表视图的删除功能

表视图为删除功能构建了非常丰富的用户操作。对于用户来说滑动删除是当下非常流行的一种方式，所以我们也没有什么必要再实现另外一种删除方式。

为MasterViewController中的表视图增加删除功能只需要下面几个步骤。第一步，我们需要让表视图知道那些行是可以删除的。但这里我们只希望当我们在查看自己的Gist时才可以删除，在查看公共Gist或者收藏的Gist时是不可以删除的：

override func tableView(tableView: UITableView, canEditRowAtIndexPath indexPath: 
  NSIndexPath) -> Bool {
  // only allow editing my gists
  return gistSegmentedControl.selectedSegmentIndex == 2
}

我们还要增加一个编辑按钮，这样用户可以让切换到编辑模式删除多条。当用户切换到自己的Gist视图时我们添加该操作，当用户切换到公共或收藏视图时，移除该操作：

@IBAction func segmentedControlValueChanged(sender: UISegmentedControl) { 
  // only show add button for my gists
  if (gistSegmentedControl.selectedSegmentIndex == 2) {
    self.navigationItem.leftBarButtonItem = self.editButtonItem() 
  } else {
    self.navigationItem.leftBarButtonItem = nil 
  }
  loadGists(nil) 
}

还要先删除viewDidLoad中的代码，因为这里首先加载的是公共Gist，所以不用显示该操作：

override func viewDidLoad() {
  super.viewDidLoad()
  // Do any additional setup after loading the view, typically from a nib.
  // self.navigationItem.leftBarButtonItem = self.editButtonItem()

  let addButton = UIBarButtonItem(barButtonSystemItem: .Add, target: self,
    action: "insertNewObject:")
  self.navigationItem.rightBarButtonItem = addButton
  if let split = self.splitViewController {
    let controllers = split.viewControllers
    self.detailViewController = (controllers[controllers.count-1] as!
      UINavigationController).topViewController as? DetailViewController
  }
}

接下来我们还要告诉表视图当用户滑动并点击删除按钮时该如何做。这里可以分为3个动作：

1. 首先从Gist列表中移除所要删除的Gist
2. 从表视图中删除该行。这里我们可以使用tableView.deleteRowsAtIndexPaths方法，而不是重新加载表视图
3. 调用API删除相应的Gist

代码如下：

override func tableView(tableView: UITableView, commitEditingStyle editingStyle: 
  UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {
  if editingStyle == .Delete {
    gists.removeAtIndex(indexPath.row) 
    tableView.deleteRowsAtIndexPaths([indexPath], withRowAnimation: .Fade) 
    // delete from API
    if let id = gists[indexPath.row].id {
      GitHubAPIManager.sharedInstance.deleteGist(id, completionHandler: { 
        (error) in
        print(error)
      })
    }
  }
}

这里你或许会有点奇怪，我们在服务器真正删除该Gist之前就从表视图中移除了。这是因为为了给用户提供更好的用户交互体验：当用户点击删除时，他们会立即看到该Gist已删除，而不是经过漫长的服务器响应之后再删除。

但，如果API调用失败呢？很简单，把Gist放回去呗。当调用失败时，我们把所要删除的Gist重新添加到Gist列表和表视图中，同时我们还需要告诉用户发生了什么：

override func tableView(tableView: UITableView, commitEditingStyle editingStyle: 
  UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {
  if editingStyle == .Delete {
    let gistToDelete = gists.removeAtIndex(indexPath.row) 
    tableView.deleteRowsAtIndexPaths([indexPath], withRowAnimation: .Fade) 
    // delete from API
    if let id = gists[indexPath.row].id {
      GitHubAPIManager.sharedInstance.deleteGist(id, completionHandler: { 
        (error) in
        print(error)
        if let _ = error {
          // Put it back
          self.gists.insert(gistToDelete, atIndex: indexPath.row) 
          tableView.insertRowsAtIndexPaths([indexPath], withRowAnimation: .Right)
          
          // tell them it didn't work
          let alertController = UIAlertController(title: "Could not delete gist", 
            message: "Sorry, your gist couldn't be deleted. Maybe GitHub is "
            + "down or you don't have an internet connection.",
            preferredStyle: .Alert)
          // add ok button
          let okAction = UIAlertAction(title: "OK", style: .Default, handler: nil) 
          alertController.addAction(okAction)
          // show the alert
          self.presentViewController(alertController, animated:true, completion: nil)
        }
      })
    }
  }
}

利用表视图内建的删除功能整合你的APP中删除处理。

小结

这就是删除功能全部的代码。当你使用表视图时滑动删除和编辑模式下的删除都是非常容易实现的。

本章代码。