我们知道，ViewController加载完成必调用viewDidLoad方法，在此方法里我们可以做一些加载完成之后的事情，但在团队开发中，每个人的思路都可能是不一样的，有的喜欢命名方法（或者叫函数）叫initXXXX()，也有的喜欢叫goXXXX()，有的甚至直接把一大段代码写到viewDidLoad中，且不说别人很难维护他的代码，过了一段时间后，估计连他自己也不明白当时写代码的思路了。所以，无规矩不成方圆，我们今天来制定一些Controller的规则，即方便自己，也方便你的队友。
完成封装后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
//需要对数据正确性进行判断，演示时我省略了这一步
//请求数据成功后调用
if self.action == LoadAction.loadNew {
self.dataList.removeAll()
}
for data in (price?.data?.deals)! {
self.dataList.append(data)
}
self.loadCompleted()
}
}
}
完成封装后效果图
首先在Library目录下新建一个Base的文件夹，然后拖进Xcode中，在其下面创建一个BaseViewController。
这里写图片描述
先对其添加一些简单的方法，后面我们在使用过程中可以根据自己的需要进行修改。
/// 通用ViewController类
class BaseViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
if checkParams() {
loadData()
}
}
override func didReceiveMemoryWarning() {
super.didReceiveMemoryWarning()
}
/**
检查调用本类必需传递的参数条件是否满足
默认返回true，在需要的类中重写此方法即可
- returns: true为满足
*/
func checkParams() -> Bool {
return true
}
/**
加载数据，请求接口或者读取本地
子类可不重写，默认调用初始化界面方法
*/
func loadData(){
initUI()
}
/**
初始化界面，在这里可以分为几个方法函数来调用
*/
func initUI(){}
}
再添加一个通用的BaseTableViewController，添加之前先到Podfile中增加XWSwiftRefresh的上下拉刷新：
pod 'XWSwiftRefresh' #上下拉刷新 https://github.com/boyXiong/XWSwiftRefresh
再创建一个BaseTableViewCell，在BaseTableViewController中会用到：
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
}
/**
设置展示内容
- 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 {
/// 默认的CellIdentifier
var identifier:String = "Cell"
/// 默认行高
var heightForRowAtIndexPath:CGFloat = 100
var tableView:UITableView!
/// 动作标识
var action:LoadAction = .loadNew
/// 当前页，如果后台是从0开始那这里就修改为0
var page:Int = 1
/// 每页加载多少条
var pageSize:Int = 10
/// 数据源集合
var dataList:[HMSerializable] = []
override func viewDidLoad() {
super.viewDidLoad()
//如果布局中没有tableView，则默认通过代码创建一个全屏的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
}
/**
执行刷新
*/
func loadRefresh(){
action = .loadNew
page = 1
loadData()
}
/**
执行加载更多
*/
func loadMore(){
action = .LoadMore
page++
loadData()
}
/**
加载完成
*/
func loadCompleted(){
if action == .loadNew {
tableView.headerView?.endRefreshing()
} else {
tableView.footerView?.endRefreshing()
}
tableView.reloadData()
}
}
现在我们写好了两个通用的Base类，如何使用呢？我们先演示一下BaseViewController。还记得之前写的HomeController吗？
这里写图片描述
修改HomeController继承自BaseViewController，我们应该明白，BaseViewController的执行顺序是 checkParams() -> loadData() -> initUI() ，这里我们不需要传递任何参数，checkParams的方法可以不用重写，那我们就来重写一下这个类：
现在看这个步骤，是不是清晰多了呢？我们再增加一个列表界面来演示BaseTableViewController：
创建一个PriceCell简单布局并连线：
通过API调试得到接口返回数据结构如下:
根据json编写模型实体类，实际开发中可以使用ESJsonFormat根据json自动生成对应字段，但现在我们演示只需要几个字段就可以：
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的实现：
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的实现：
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
//需要对数据正确性进行判断，演示时我省略了这一步
//请求数据成功后调用
if self.action == LoadAction.loadNew {
self.dataList.removeAll()
}
for data in (price?.data?.deals)! {
self.dataList.append(data)
}
self.loadCompleted()
}
}
}
运行看看效果：
这样，我们就达成了两个BaseController的封装，尤其是BaseTableViewController，我们只需要在VC中调用两个方法，initWithParams和loadData就可以达到自定义Cell及上下拉刷新加载等效果，是不是很酷呢？
Git地址：https://github.com/bxcx/sctong
本节分支：https://github.com/bxcx/sctong/tree/7th_BaseController
