重要说明: 这是一个系列教程，非本人原创，而是翻译国外的一个教程。本人也在学习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下载到本章的全部代码。
网友评论