我們知道果善，ViewController加載完成必調(diào)用viewDidLoad方法，在此方法里我們可以做一些加載完成之后的事情嫡锌，但在團(tuán)隊(duì)開發(fā)中，每個(gè)人的思路都可能是不一樣的琳钉，有的喜歡命名方法（或者叫函數(shù)）叫initXXXX()势木，也有的喜歡叫g(shù)oXXXX()，有的甚至直接把一大段代碼寫到viewDidLoad中歌懒，且不說別人很難維護(hù)他的代碼啦桌，過了一段時(shí)間后，估計(jì)連他自己也不明白當(dāng)時(shí)寫代碼的思路了及皂。所以甫男，無規(guī)矩不成方圓，我們今天來制定一些Controller的規(guī)則验烧，即方便自己板驳，也方便你的隊(duì)友。
完成封裝后UITableViewController的編碼：
import UIKit
class PriceListController: BaseTableViewController {
override func viewDidLoad() {
super.viewDidLoad()
initWithParams("PriceCell", heightForRowAtIndexPath: 70, canLoadRefresh: true, canLoadMore: true)
}
override func loadData() {
//請求地址 借用百度糯米來演示一下
let url = "http://apis.baidu.com/baidunuomi/openapi/searchdeals"
var params:[String:AnyObject] = Dictionary()
params.updateValue("800010000", forKey: "city_id")//城市ID 成都
params.updateValue("\(page)", forKey: "page")
params.updateValue("\(pageSize)", forKey: "page_size")
HMRequest<PriceDomain>.get(url, params: params) { (price, error) -> () in
//需要對數(shù)據(jù)正確性進(jìn)行判斷碍拆，演示時(shí)我省略了這一步
//請求數(shù)據(jù)成功后調(diào)用
if self.action == LoadAction.loadNew {
self.dataList.removeAll()
}
for data in (price?.data?.deals)! {
self.dataList.append(data)
}
self.loadCompleted()
}
}
}
完成封裝后效果圖
首先在Library目錄下新建一個(gè)Base的文件夾若治，然后拖進(jìn)Xcode中慨蓝，在其下面創(chuàng)建一個(gè)BaseViewController。
這里寫圖片描述
先對其添加一些簡單的方法端幼，后面我們在使用過程中可以根據(jù)自己的需要進(jìn)行修改礼烈。
/// 通用ViewController類
class BaseViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
if checkParams() {
loadData()
}
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
/**
檢查調(diào)用本類必需傳遞的參數(shù)條件是否滿足
默認(rèn)返回true，在需要的類中重寫此方法即可
- returns: true為滿足
*/
func checkParams() -> Bool {
return true
}
/**
加載數(shù)據(jù)婆跑，請求接口或者讀取本地
子類可不重寫此熬，默認(rèn)調(diào)用初始化界面方法
*/
func loadData(){
initUI()
}
/**
初始化界面，在這里可以分為幾個(gè)方法函數(shù)來調(diào)用
*/
func initUI(){}
}
再添加一個(gè)通用的BaseTableViewController滑进，添加之前先到Podfile中增加XWSwiftRefresh的上下拉刷新：
pod 'XWSwiftRefresh' #上下拉刷新 https://github.com/boyXiong/XWSwiftRefresh
再創(chuàng)建一個(gè)BaseTableViewCell犀忱，在BaseTableViewController中會(huì)用到：
class BaseTableViewCell: UITableViewCell {
override func awakeFromNib() {
super.awakeFromNib()
// Initialization code
}
override func setSelected(selected: Bool, animated: Bool) {
super.setSelected(selected, animated: animated)
// Configure the view for the selected state
}
/**
設(shè)置展示內(nèi)容
- parameter tableView: tableView
- parameter indexPath: indexPath
- parameter dataList: dataList
*/
func setContent(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath, dataList:[HMSerializable] ){
//do something
}
}
下面是對BaseTableViewController的編碼：
import UIKit
import XWSwiftRefresh
enum LoadAction{
case loadNew
case LoadMore
}
class BaseTableViewController: BaseViewController,UITableViewDelegate,UITableViewDataSource {
/// 默認(rèn)的CellIdentifier
var identifier:String = "Cell"
/// 默認(rèn)行高
var heightForRowAtIndexPath:CGFloat = 100
var tableView:UITableView!
/// 動(dòng)作標(biāo)識(shí)
var action:LoadAction = .loadNew
/// 當(dāng)前頁，如果后臺(tái)是從0開始那這里就修改為0
var page:Int = 1
/// 每頁加載多少條
var pageSize:Int = 10
/// 數(shù)據(jù)源集合
var dataList:[HMSerializable] = []
override func viewDidLoad() {
super.viewDidLoad()
//如果布局中沒有tableView郊供，則默認(rèn)通過代碼創(chuàng)建一個(gè)全屏的tableView
if tableView == nil {
tableView = UITableView(frame: CGRect(x: 0, y: 0, width: self.view.frame.width, height: self.view.frame.height - (self.navigationController?.navigationBar.frame.height)! - UIApplication.sharedApplication().statusBarFrame.height), style: UITableViewStyle.Plain)
self.view.addSubview(tableView)
}
tableView.delegate = self
tableView.dataSource = self
}
/**
初始化TableView配置
- parameter nibName: 自定義Cell的文件名
- parameter heightForRowAtIndexPath: 行高
- parameter canLoadRefresh: 是否支持下拉刷新
- parameter canLoadMore: 是否支持上拉加載
*/
func initWithParams(nibName:String, heightForRowAtIndexPath:CGFloat, canLoadRefresh:Bool, canLoadMore:Bool){
tableView.registerNib(UINib(nibName: nibName, bundle: nil), forCellReuseIdentifier:identifier)
self.heightForRowAtIndexPath = heightForRowAtIndexPath
if canLoadRefresh {
//添加下拉刷新
tableView.headerView = XWRefreshNormalHeader(target: self, action: "loadRefresh")
}
if canLoadMore {
//添加上拉加載
tableView.footerView = XWRefreshAutoNormalFooter(target: self, action: "loadMore")
}
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
func numberOfSectionsInTableView(tableView: UITableView) -> Int {
return 1
}
func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
return dataList.count
}
func tableView(tableView: UITableView, heightForRowAtIndexPath indexPath: NSIndexPath) -> CGFloat {
return heightForRowAtIndexPath
}
func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
let cell = tableView.dequeueReusableCellWithIdentifier(identifier, forIndexPath: indexPath) as! BaseTableViewCell
cell.setContent(tableView, cellForRowAtIndexPath: indexPath, dataList: dataList)
return cell
}
/**
執(zhí)行刷新
*/
func loadRefresh(){
action = .loadNew
page = 1
loadData()
}
/**
執(zhí)行加載更多
*/
func loadMore(){
action = .LoadMore
page++
loadData()
}
/**
加載完成
*/
func loadCompleted(){
if action == .loadNew {
tableView.headerView?.endRefreshing()
} else {
tableView.footerView?.endRefreshing()
}
tableView.reloadData()
}
}
現(xiàn)在我們寫好了兩個(gè)通用的Base類峡碉，如何使用呢近哟？我們先演示一下BaseViewController驮审。還記得之前寫的HomeController嗎？
這里寫圖片描述
修改HomeController繼承自BaseViewController吉执，我們應(yīng)該明白疯淫，BaseViewController的執(zhí)行順序是 checkParams() -> loadData() -> initUI() ，這里我們不需要傳遞任何參數(shù)戳玫，checkParams的方法可以不用重寫熙掺，那我們就來重寫一下這個(gè)類：
現(xiàn)在看這個(gè)步驟，是不是清晰多了呢咕宿？我們再增加一個(gè)列表界面來演示BaseTableViewController：
創(chuàng)建一個(gè)PriceCell簡單布局并連線：
通過API調(diào)試得到接口返回?cái)?shù)據(jù)結(jié)構(gòu)如下:
根據(jù)json編寫模型實(shí)體類币绩，實(shí)際開發(fā)中可以使用ESJsonFormat根據(jù)json自動(dòng)生成對應(yīng)字段，但現(xiàn)在我們演示只需要幾個(gè)字段就可以：
struct PriceDomain: HMSerializable ,HMConvertible{
var error: Int = 0
var msg: Int = 0
var data: PriceData?
static func convertFromData(data: String!) -> (PriceDomain, NSError?) {
var hm : PriceDomain?
hm <-- data
return (hm!,nil)
}
init(data: [String: AnyObject]) {
error <-- data["error"]
msg <-- data["msg"]
self.data <-- data["data"]
}
struct PriceData: HMSerializable {
var total: String?
var deals: [PriceDeal]?
init(data: [String: AnyObject]) {
total <-- data["total"]
deals <-- data["deals"]
}
//可以只取我們需要的字段府阀，不需要全部解析
struct PriceDeal: HMSerializable {
var image: String?
var title: String?
var description: String?
init(data: [String: AnyObject]) {
image <-- data["image"]
title <-- data["title"]
description <-- data["description"]
}
}
}
}
接著是PriceCell的實(shí)現(xiàn)：
class PriceCell: BaseTableViewCell {
@IBOutlet weak var iv_Photo: UIImageView!
@IBOutlet weak var lbl_Title: UILabel!
@IBOutlet weak var lbl_Desc: UILabel!
override func setContent(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath, dataList:[HMSerializable] ){
let data = dataList[indexPath.row] as! PriceDomain.PriceData.PriceDeal
lbl_Title.text = data.title
lbl_Desc.text = data.description
iv_Photo.kf_setImageWithURL(NSURL(string: data.image!)!)
}
}
最后是PriceListController的實(shí)現(xiàn)：
class PriceListController: BaseTableViewController {
override func viewDidLoad() {
super.viewDidLoad()
initWithParams("PriceCell", heightForRowAtIndexPath: 70, canLoadRefresh: true, canLoadMore: true)
}
override func loadData() {
//請求地址 借用百度糯米來演示一下
let url = "http://apis.baidu.com/baidunuomi/openapi/searchdeals"
var params:[String:AnyObject] = Dictionary()
params.updateValue("800010000", forKey: "city_id")//城市ID 成都
params.updateValue("\(page)", forKey: "page")
params.updateValue("\(pageSize)", forKey: "page_size")
HMRequest<PriceDomain>.get(url, params: params) { (price, error) -> () in
//需要對數(shù)據(jù)正確性進(jìn)行判斷缆镣，演示時(shí)我省略了這一步
//請求數(shù)據(jù)成功后調(diào)用
if self.action == LoadAction.loadNew {
self.dataList.removeAll()
}
for data in (price?.data?.deals)! {
self.dataList.append(data)
}
self.loadCompleted()
}
}
}
運(yùn)行看看效果：
這樣，我們就達(dá)成了兩個(gè)BaseController的封裝试浙，尤其是BaseTableViewController董瞻，我們只需要在VC中調(diào)用兩個(gè)方法，initWithParams和loadData就可以達(dá)到自定義Cell及上下拉刷新加載等效果田巴，是不是很酷呢钠糊？
Git地址：https://github.com/bxcx/sctong
本節(jié)分支：https://github.com/bxcx/sctong/tree/7th_BaseController
