[譯] 通過檢視控制器容器和子檢視控制器避免龐大的檢視控制器

淚已無痕發表於2018-12-29

原文地址：Avoiding Massive View Controller using Containment & Child View Controller

通過檢視控制器容器和子檢視控制器避免龐大的檢視控制器

檢視控制器容器和子檢視控制器圖解

View Controller 是一個提供基本構建塊的元件，在 iOS 開發中我們以它為基礎構建應用。在 Apple MVC 世界中，它作為 View 和 Model 的中間人，在兩者之間充當協調者的角色。它以觀察者控制器開始，響應模型更改、更新檢視、使用目標操作從檢視中接受使用者互動、然後更新模型。

Apple MVC 圖解（Apple 公司提供）

作為一名 iOS 開發者，很多次我們將面臨處理龐大的 View Controller 問題，即便我們使用了像 MVVM、MVP 或 VIPER 這樣的架構。某些時刻，View Controller 在一個螢幕上承擔了太多職責。這違反了 SRP（單一職責原則），在模組之間形成了強度耦合，並使得重用和測試每個元件變得異常困難。

我們可以將下面的應用截圖作為示例。你可以看到在一個螢幕上至少存在 3 種職責：

顯示電影列表；
顯示可以選擇應用於電影列表的過濾列表；
清除所選過濾器的選項。

如果我們準備使用單一的 View Controller 來構建此螢幕，由於它在一個 view controller 中承擔了過多職責，因此可以保證這個 view controller 將變得非常龐大和臃腫。

我們如何解決這個問題呢？其中一個解決方案是使用 View Controller 容器和子 View Controller。以下是使用該方案的好處：

將電影列表封裝到 MovieListViewController 中，它只負責顯示電影列表並對 Movie 模型中的更改做出響應。如果我們只想顯示沒有過濾器的電影列表，我們也可以在另一個螢幕中重用它。
將過濾器中的列表和選擇邏輯封裝到 FilterListViewController 中，它單獨負責顯示和過濾器的選擇。當使用者選擇和取消選擇時，我們可以使用委託與父 View Controller 進行通訊。
將主 View Controller 縮減為一個 ContainerViewController，它只負責將選中的過濾器從過濾列表應用到 MovieListViewController 中的 Movie 模型。它還設定佈局並將子 view controller 新增到容器檢視中。

你可以在下面的 GitHub 程式碼倉庫中檢視完整的專案原始碼。

alfianlosari/Filter-MVC-iOS

使用 Storyboard 來佈置 View Controller

ContainerViewController：View Controller 容器提供了 2 個容器檢視，用於將子 View Controller 嵌入到水平 UIStackView 中。它還提供了單個 UIButton 來清空所選的過濾器。它還嵌入在充當初始 View Controller 的 UINavigationController 中。
FilterListMovieController：它是 UITableViewController 的子類，具有分類樣式和一個用來顯示過濾器名稱的標準單元格。它還分配了 Storyboard ID，因此可以通過程式設計的方式在 ContainerViewController 中對它進行例項化。
MovieListViewController：它是 UITableViewController 的子類，具有 Plain 樣式和一個用來顯示 Movie 屬性的小標題單元格。它還跟 FilterListViewController 一樣分配了 Storyboard ID。

電影列表 View Controller

此 view controller 負責顯示作為例項公開屬性的 Movie 模型列表。我們使用 Swift 的 didSet 屬性觀察器來響應模型的更改，然後重新載入 UITableView。單元格使用預設小標題樣式 UITableViewCellStyle 來顯示電影的標題、持續時間、評級和流派。

import UIKit

struct Movie {

    let title: String
    let genre: String
    let duration: TimeInterval
    let rating: Float

}

class MovieListViewController: UITableViewController {

    var movies = [Movie]() {
        didSet {
            tableView.reloadData()
        }
    }

    let formatter: DateComponentsFormatter = {
        let formatter = DateComponentsFormatter()
        formatter.allowedUnits = [.hour, .minute]
        formatter.unitsStyle = .abbreviated
        formatter.maximumUnitCount = 1
        return formatter
    }()

    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return movies.count
    }

    override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        tableView.deselectRow(at: indexPath, animated: true)
    }

    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)

        let movie = movies[indexPath.row]
        cell.textLabel?.text = movie.title
        cell.detailTextLabel?.text = "\(formatter.string(from: movie.duration) ?? ""), \(movie.genre.capitalized), rating: \(movie.rating)"
        return cell
    }

}
複製程式碼

過濾器列表 View Controller

過濾器列表在 3 個單獨的部分中顯示 MovieFilter 列舉：流派、評級和持續時間。MovieFilter 列舉本身符合 Hashable 協議，因此可以使用每個列舉及其屬性的雜湊值儲存在唯一集合中。過濾器的選擇儲存在包含 MovieFilter 的 Set 的例項屬性下。

要與其他物件通訊，通過 FilterListControllerDelegate 使用委託模式，委託有三個方法需要實現：

選擇一個過濾器。
取消選擇一個過濾器。
清空所有已選擇過濾器。

import UIKit

enum MovieFilter: Hashable {

    case genre(code: String, name: String)
    case duration(duration: TimeInterval, name: String)
    case rating(value: Float, name: String)

    var hashValue: Int {

        switch self {
        case .genre(let code, let name):
            return "\(code)-\(name)".hashValue

        case .rating(let value, let name):
            return "\(value)-\(name)".hashValue

        case .duration(let duration, let name):
            return "\(duration)-\(name)".hashValue

        }
    }

}

protocol FilterListViewControllerDelegate: class {

    func filterListViewController(_ controller: FilterListViewController, didSelect filter: MovieFilter)
    func filterListViewController(_ controller: FilterListViewController, didDeselect filter: MovieFilter)
    func filterListViewControllerDidClearFilters(controller: FilterListViewController)

}

class FilterListViewController: UITableViewController {

    let filters = MovieFilter.defaultFilters
    weak var delegate: FilterListViewControllerDelegate?
    var selectedFilters: Set<MovieFilter> = []

    override func viewDidLoad() {
        super.viewDidLoad()
    }

    func clearFilter() {
        selectedFilters.removeAll()
        delegate?.filterListViewControllerDidClearFilters(controller: self)

        tableView.reloadData()
    }

    override func numberOfSections(in tableView: UITableView) -> Int {
        return filters.count
    }

    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return filters[section].filters.count
    }

    override func tableView(_ tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
        return filters[section].title
    }

    override func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
        tableView.deselectRow(at: indexPath, animated: true)
        let filter = filters[indexPath.section].filters[indexPath.row]
        if selectedFilters.contains(filter) {
            selectedFilters.remove(filter)
            delegate?.filterListViewController(self, didDeselect: filter)
        } else {
            selectedFilters.insert(filter)
            delegate?.filterListViewController(self, didSelect: filter)
        }
        tableView.reloadRows(at: [indexPath], with: .automatic)
    }

    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
        let filter = filters[indexPath.section].filters[indexPath.row]

        switch filter {
        case .genre(_, let name):
            cell.textLabel?.text = name

        case .rating(_, let name):
            cell.textLabel?.text = name

        case .duration(_, let name):
            cell.textLabel?.text = name

        }

        if selectedFilters.contains(filter) {
            cell.accessoryType = .checkmark
        } else {
            cell.accessoryType = .none
        }

        return cell
    }

}
複製程式碼

在容器 View Controller 中整合

在 ContainerViewController 中，我們有以下幾個例項屬性：

FilterListContainerView 和 MovieListContainerView：用於新增子 view controller 的容器檢視。
FilterListViewController 和 MovieListViewController：使用 Storyboard ID 例項化的影片列表和篩選器列表 view controller 的引用。
movie：使用預設硬編碼的電影例項的 Movie 陣列。

當 viewDidLoad 被呼叫時，我們呼叫該方法來設定子 View Controller。以下是它要執行的幾項任務：

使用 Storyboard ID 例項化 FilterListViewController 和 MovieListViewController；
將它們分配給例項屬性；
將 MovieListViewController 分配給 movies 陣列；
將 ContainerViewController 指定為 FilterListViewController 的委託，以便它可以響應過濾器選擇；
設定子檢視框架並使用擴充套件幫助方法將它們新增為子 View Controller。

對於 FilterListViewControllerDelegate 的實現，當選擇或取消選擇過濾器時，將針對每個型別、評級和持續時間過濾預設的電影資料。然後，過濾器的結果將分配給 MovieListViewController 的 movies 屬性。要取消選擇所有過濾器，它只會分配預設的電影資料。

import UIKit

class ContainerViewController: UIViewController {

    @IBOutlet weak var filterListContainerView: UIView!
    @IBOutlet weak var movieListContainerView: UIView!

    var filterListVC: FilterListViewController!
    var movieListVC: MovieListViewController!

    let movies = Movie.defaultMovies

    override func viewDidLoad() {
        super.viewDidLoad()
        setupChildViewControllers()
    }

    private func setupChildViewControllers() {
        let storyboard = UIStoryboard(name: "Main", bundle: nil)

        let filterListVC = storyboard.instantiateViewController(withIdentifier: "FilterListViewController") as! FilterListViewController
        addChild(childController: filterListVC, to: filterListContainerView)
        self.filterListVC = filterListVC
        self.filterListVC.delegate = self

        let movieListVC = storyboard.instantiateViewController(withIdentifier: "MovieListViewController") as! MovieListViewController
        movieListVC.movies = movies
        addChild(childController: movieListVC, to: movieListContainerView)
        self.movieListVC = movieListVC
    }

    @IBAction func clearFilterTapped(_ sender: Any) {
        filterListVC.clearFilter()
    }

    private func filterMovies(moviesFilter: [MovieFilter]) {
        movieListVC.movies = movies
            .filter(with: moviesFilter.genreFilters)
            .filter(with: moviesFilter.ratingFilters)
            .filter(with: moviesFilter.durationFilters)
    }

}

extension ContainerViewController: FilterListViewControllerDelegate {

    func filterListViewController(_ controller: FilterListViewController, didSelect filter: MovieFilter) {
        filterMovies(moviesFilter: Array(controller.selectedFilters))
    }

    func filterListViewController(_ controller: FilterListViewController, didDeselect filter: MovieFilter) {
        filterMovies(moviesFilter: Array(controller.selectedFilters))
    }

    func filterListViewControllerDidClearFilters(controller: FilterListViewController) {
        movieListVC.movies = Movie.defaultMovies
    }

}
複製程式碼

結論

通過研究示例專案。我們可以看到在我們的應用中使用 View Controller 容器和子 View Controller 的好處。我們可以將單個 View Controller 的職責劃分為單獨的 View Controller，它們只具有單一職責（SRP）。我們還需要確保子 View Controller 對其父級沒有任何依賴。為了讓子 View Controller 與父級進行通訊，我們可以使用委託模式。

該方法還提供了模組鬆耦合的優點，這可以為每個元件帶來更好的可重用性和可測試性。隨著我們的應用變得更大、更復雜，該方法確實有助於我們擴充套件它。讓我們繼續學習?，祝你聖誕快樂?，新年快樂?！繼續使用 Swift 和 Cocoa ！！?

在社交平臺上關注我們：

檢視控制器
2018-07-04
模態檢視控制器：GCTUIModalPresentationViewController
2018-05-16
GCUIViewController
iOS開發-檢視與檢視控制器生命週期
2024-06-30
iOS
【asp.net core 系列】3 檢視以及檢視與控制器
2020-06-02
ASP.NET
iOS 檢視控制器的生命週期
2018-12-19
iOS
React研習之旅（二）：檢視控制器-路由
2018-12-23
React路由
Laravel 8 控制器可以直接返回物件給檢視嗎？
2022-11-22
Laravel物件
SpringBoot(3)-MVC自動配置及自定義檢視控制器
2020-09-26
Spring BootMVC
Yii框架之框架部署、控制器、檢視的呼叫、頁面的整合
2018-05-31
框架
iOS開發-檢視控制器UINavigationController的介紹與基本使用
2024-06-30
iOSUINavigationController
[Django REST framework - 檢視元件之檢視基類、檢視擴充套件類、檢視子類、檢視集]
2021-07-04
DjangoRESTFramework元件套件
drf : 通用檢視類和(GenericAPIView)5個檢視擴充套件類，九個檢視子類，檢視集。
2024-03-25
APIView套件
Asp.Net MVC控制器獲取檢視傳值幾種方式
2020-12-28
ASP.NETMVC
Laravel 控制器 Controller 傳值到檢視 View 的幾種方法總結
2018-10-16
LaravelControllerView
SAP UI5 檢視控制器 View Controller 的生命週期方法 - Lifecycle methods
2021-10-11
UIViewController
11 UML中的邏輯檢視、程序檢視、實現檢視、部署檢視
2024-09-20
Oracle普通檢視和物化檢視的區別
2018-07-17
Oracle
檢視過濾
2024-05-15
系統學習iOS動畫之四：檢視控制器的轉場動畫
2018-12-27
iOS動畫
集合檢視子類
2018-06-12
django 的類檢視和函式檢視-雜談
2020-01-07
Django函式
ASP.NET Core 5.0 MVC中的檢視分類——佈局檢視、啟動檢視、具體檢視、分部檢視
2021-01-31
ASP.NETMVC
docker 容器的使用與檢視
2020-11-20
Docker
檢視Docker容器的資訊
2022-05-25
Docker
docker檢視容器IP地址
2018-07-19
Docker
Django檢視之檢視類和中介軟體
2020-10-12
Django
day04-檢視和檢視解析器
2023-02-07
SAP UI5 初學者教程之五：檢視控制器初探試讀版
2021-10-10
UI
Win10系統下怎麼通過事件檢視器中檢視硬碟檢查結果
2019-05-26
Win10事件硬碟
通過Python檢視Azure VM的狀態
2018-03-05
Python
【MySQL】檢視&子查詢
2020-12-20
MySql
angularjs中控制檢視的控制器的兩種注入依賴項及服務的寫法
2024-09-28
AngularJS
docker檢視容器日誌命令
2019-12-24
Docker
Django的檢視和模板
2019-12-17
Django
七個子類檢視 LL
2024-03-13
odoo檢視入門學習- tree檢視的使用
2021-04-15
Odoo
MYSQL 檢視
2018-10-24
MySql
檢視助手
2019-01-19