(Swift)iOS Apps with REST APIs(十

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

我们之前定义的需求是可以在公共列表、收藏列表和我的列表这三个不同的列表中进行切换。那么下面让我们看看如何在一个视图中完成这三个列表的切换。

分析你的需求看看需要哪些用户组件。通读本章，把本章作为一个处理多个返回相似列表调用的例子。这些相似的代码可以用来过滤或者搜索使用。

构建用户界面

调用这三种列表的API函数前面我们已经编写好了。我们现在就是想办法把它们与用户交互界面连接起来。其实在多个gists列表切换还是非常容易实现。其中UISegmentedControl控件就可以做到。在主故事板中把一个segmented control拖到MasterViewController的导航栏中：

然后将Segment修改为3:

将标题按顺序修改为"Public"、"Starred"和“My Gists”:

然后，我们需要将Segmented Control与代码建立关联，这样当切换时就可以收到相应的事件通知，并进行处理。因此我们在MasterViewController中增加一个IBOutlet:

class MasterViewController: UITableViewController { 
  
  ...
  
  @IBOutlet weak var gistSegmentedControl: UISegmentedControl! 
  ...
  
}

和一个IBAction:

@IBAction func segmentedControlValueChanged(sender: UISegmentedControl) { 

}

然后将它们与故事板建立关联：

复用完成处理函数

现在我们就可以进行数据加载了。我们需要先修改loadGists()函数，检查segmented control当前选中的是哪一个，然后再进行相应的数据加载。为了能够让这三个不同的数据加载函数能够复用完成处理函数，我们将它声明为一个变量：

func loadGists(urlToLoad: String?) {
  self.isLoading = false
  let completionHandler: (Result<[Gist], NSError>, String?) -> Void = 
  { (result, nextPage) in
    self.isLoading = false 
    self.nextPageURLString = nextPage
    
    // tell refresh control it can stop showing up now
    if self.refreshControl != nil && self.refreshControl!.refreshing { 
      self.refreshControl?.endRefreshing()
    }
    
    guard result.error == nil else { 
      print(result.error) 
      self.nextPageURLString = nil
      
      self.isLoading = false
      if let error = result.error {
        if error.domain == NSURLErrorDomain &&
          error.code == NSURLErrorUserAuthenticationRequired { 
          self.showOAuthLoginView()
        }
      }
      return
    }
    
    if let fetchedGists = result.value { 
      if urlToLoad != nil {
        self.gists += fetchedGists 
      } else {
        self.gists = fetchedGists 
      }
    }
    
    // update "last updated" title for refresh control
    let now = NSDate()
    let updateString = "Last Updated at " + self.dateFormatter.stringFromDate(now) 
    self.refreshControl?.attributedTitle = NSAttributedString(string: updateString)
    self.tableView.reloadData() 
  }
  
  switch gistSegmentedControl.selectedSegmentIndex { 
  case 0:
    GitHubAPIManager.sharedInstance.getPublicGists(urlToLoad, completionHandler:
      completionHandler)
  case 1:
    GitHubAPIManager.sharedInstance.getMyStarredGists(urlToLoad, completionHandler:
      completionHandler) 
  case 2:
    GitHubAPIManager.sharedInstance.getMyGists(urlToLoad, completionHandler:
      completionHandler)
  default:
    print("got an index that I didn't expect for selectedSegmentIndex")
  }
}

这里我们使用了Alamofire的Result，所以我们需要把它引入进来：

import UIKit
import PINRemoteImage
import SafariServices
import Alamofire

class MasterViewController: UITableViewController, LoginViewDelegate, SFSafariViewControllerDelegate {
 
  ...

}

为了将块声明为一个变量或常量，我们这里需要一个特殊的类型，以便可以让编译器知道它可以被使用。这就是接下来我们要做的：

let completionHandler: (Result<[Gist], NSError>, String?) -> Void = { ... }

我们这里将块命名为completionHandler。并且是一个常量，使用两个参数：一个是Result，包含了Gists数组或者一个错误；另一个参数是下一页的URL地址，类型为字符串。该函数不返回任何东西(Void)。也许你已经注意到到这种声明正好可以作为getPublicGists、getMyStarredGists和getMyGists的完成处理函数：

func getPublicGists(pageToLoad: String?, completionHandler: 
  (Result<[Gist], NSError>, String?) -> Void) {
  if let urlString = pageToLoad {
    getGists(GistRouter.GetAtPath(urlString), completionHandler: completionHandler) 
  } else {
    getGists(GistRouter.GetPublic(), completionHandler: completionHandler)
  }
}

func getMyStarredGists(pageToLoad: String?, completionHandler: 
  (Result<[Gist], NSError>, String?) -> Void) {
  if let urlString = pageToLoad {
    getGists(GistRouter.GetAtPath(urlString), completionHandler: completionHandler) 
  } else {
    getGists(GistRouter.GetMyStarred(), completionHandler: completionHandler)
  }
}
func getMyGists(pageToLoad: String?, completionHandler: 
  (Result<[Gist], NSError>, String?) -> Void) {
  if let urlString = pageToLoad {
    getGists(GistRouter.GetAtPath(urlString), completionHandler: completionHandler) 
  } else {
    getGists(GistRouter.GetMine(), completionHandler: completionHandler)
  }
}

在路由中我们需要增加GetMine。和我们之前所添加的GetMyStarred类似，需要验证后方可使用：

enum GistRouter: URLRequestConvertible {
  static let baseURLString:String = "https://api.github.com"
  
  case GetPublic() // GET https://api.github.com/gists/public 
  case GetMyStarred() // GET https://api.github.com/gists/starred 
  case GetMine() // GET https://api.github.com/gists
  case GetAtPath(String) // GET at given path
  
  var URLRequest: NSMutableURLRequest { 
    var method: Alamofire.Method {
      switch self { 
      case .GetPublic:
        return .GET
      case .GetMyStarred:
        return .GET
      case .GetMine: 
        return .GET
      case .GetAtPath: 
        return .GET
      }
    }
    
    let result: (path: String, parameters: [String: AnyObject]?) = { 
      switch self {
      case .GetPublic:
        return ("/gists/public", nil) 
      case .GetMyStarred:
        return ("/gists/starred", nil) 
      case .GetMine:
        return ("/gists", nil) 
      case .GetAtPath(let path):
        let URL = NSURL(string: path)
        let relativePath = URL!.relativePath! 
        return (relativePath, nil)
      }
    }()
    
    let URL = NSURL(string: GistRouter.baseURLString)!
    let URLRequest = NSMutableURLRequest(URL: URL.URLByAppendingPathComponent(result.path))
    
    // Set OAuth token if we have one
    if let token = GitHubAPIManager.sharedInstance.OAuthToken { 
      URLRequest.setValue("token \(token)", forHTTPHeaderField: "Authorization")
    }
    
    let encoding = Alamofire.ParameterEncoding.JSON
    let (encodedRequest, _) = encoding.encode(URLRequest, parameters: result.parameters)
    
    encodedRequest.HTTPMethod = method.rawValue
    return encodedRequest 
  }
}

我们还需要在API管理器中增加：

func getMyGists(pageToLoad: String?, completionHandler: 
  (Result<[Gist], NSError>, String?) -> Void) {
    if let urlString = pageToLoad {
      getGists(GistRouter.GetAtPath(urlString), completionHandler: completionHandler)
    } else {
      getGists(GistRouter.GetMine(), completionHandler: completionHandler)
    }
}

最后，我们还需要当用户切换时调用loadGists，这样用户就可以看到数据被更新了：

@IBAction func segmentedControlValueChanged(sender: UISegmentedControl) { 
  loadGists(nil)
}

小结

由于之前我们投入了很多时间来设计我们的API管理器，因此加入这个功能并没有耗费我们太大力气。保存并运行测试，然后在转入我们下一个功能创建详细页面。

你可以在这里lists下载到本章的全部代码。