协议与委托代理回调在之前的博客中也是经常提到和用到的在《Objective-C中的委托(代理)模式》和《iOS开发之窥探UICollectionViewController(四) --一款功能强大的自定义瀑布流》等博客内容中都用到的Delegate回调。说到协议,在Objective-C中也是有协议的,并且Swift中的协议和Objc中的协议使用起来也是大同小异的,在Java等现代面向对象编程语言中有接口(Interface)的概念,其实和Swift中或者Objc中的Protocol(协议)是一个东西。论Interface和Protocol的功能来说,两者也是大同小异的。
今天就结合两个实例来窥探一下Swift中的协议与Delegate回调(委托代理回调)。本篇先给出CocoaTouch中常用控件UITableView的常用回调,并以此来认识一下回调的使用方式。紧接着会给出如何去实现自己的Delegate回调,即在自定义控件中去实现委托代理回调。言归正传,开始今天的博客主题。
一.从UITableView中来窥探协议的委托代理回调
UITableView这个高级控件在iOS开发中的出镜率是比较高的,今天的重点不是介绍如何使用UITableView, 而是让通过UITableView的工作方式来直观的感受一下协议的使用场景,以及Delegate代理的工作方式。如果你对UITableView控件不熟的话,完全可以跳过这一部分,直接进入第二部分。如果你要更好的理解Delegate委托回调,还是很有必要看这一部分的。
下面就先以UITableView的UITableViewDatasource协议来看一下委托代理的使用方式。为了简化代码呢,下面的TableView的使用就没有实现UITableViewDelegate协议还是那句话,今天的重点是Protocol和Delegate, 而不是如何使用UITableView。下方的截图就是我们要使用UITableView和UITableViewDatasource来做的事情。当然下方的实例无论是代码还是布局方面还是灰常简单的,运行效果如下所示。
上面的Cell中就是一个ImageView和一个Label, 布局灰常简单啦,接下来就简单介绍一下在Swift中是如何实现(说白了,和Objc实现起来大同小异)。还是结合着Storyboard来做吧,毕竟使用Storyboard布局更为简单一些。
1. 使用Storyboard来布局控件,控件布局如下:
2. 给上述Cell绑定相应的Swift源码,并关联ImageView和Label, 相应Cell(BeautifulGrillCell)的代码如下所示。girlImageView即为做吧的图片,
girlNameLable为图片右边的文字。
1import UIKit 2 3class BeautifulGrillCell: UITableViewCell { 4 5@IBOutletvargirlImageView: UIImageView! 6 7@IBOutletvargirlNameLable: UILabel! 8 9override func awakeFromNib() {10 super.awakeFromNib()11// Initialization code12 }1314override func setSelected(selected: Bool, animated: Bool) {15 super.setSelected(selected, animated: animated)1617// Configure the view for the selected state18 }1920}
3.接下来就是要模拟我们在TableView上显示的数据了,在正常开放中这些数据往往来源于网络请求,而在本篇博客中就模拟数据源,来为我们的TableView提供显示的数据。数据源的格式是一个数组,而数组中存放的是多个字典,每个字典有两个键值对,一个键值对存储要显示图片的文件名,另一个键值对则存储美女的名字。为了使该数据的存储结构,请看下方结构图。
原理图有了,接下来就要使用代码来创建出上述结构的数据以供TableView的数据源使用,下面的方法就是实现上述结构的函数。
(1) 首先我们要在视图控制器相应的类中添加一个可变数组,用来存放数据,如下所示:
1privatevardataSource:Array>?
(2) 接着就是往上面这个数组中填充数据了,代码如下:
1//-----------创建Table要显示的数据-------------------------2 func createSourceData() {3self.dataSource = Array>();4for(vari =0; i<10; i++) {5let imageName:String ="00\(i).jpg"6let girlName:String ="美女\(i + 1)"7self.dataSource?.append([IMAGE_NAME:imageName, GIRL_NAME:girlName])8 }9}
4. 我们上面Storyboard中的视图控制器使用的是UIViewController而不是UITableViewController。 我们在UIViewController上贴了一层UITableView, 所以我们需要在相应的ViewController对应的Swift源码中进行UITableView的绑定,并实现UITableViewDatasource代理,并为UITableView指定该代理。下方的代码就是关联tableview并指定代理方法。代码如下:
1import UIKit 2 3class ViewController: UIViewController, UITableViewDataSource { 4 5@IBOutletvarmyTableView: UITableView! 6//life cycle 7override func viewDidLoad() { 8 super.viewDidLoad() 9 self.createSourceData()10self.myTableView.dataSource = self11 }12}
4. 对myTableView的dataSource(数据提供者)指定完代理对象后,接下来就是要实现UITableViewDataSource中的相应的方法了,ViewController通过这些协议委托回调的代理方法来为TableView提供数据。下方是UITableViewDataSource委托方法中返回TableView的Section个数的回调方法,如下所示:
1/**2 - parameter tableView: 当前要显示的TableView34 - returns: TableView中Section的个数5*/6func numberOfSectionsInTableView(tableView: UITableView) -> Int {7return18}
5.上面回调方法是返回Section个数的,紧接着下方就是返回每个Section中Cell个数的回调方法。Cell的个数就是数组dataSource中元素的个数。
1/** 2 返回每个Section中的Cell个数 3 4 - parameter tableView: 当前显示的TableView 5 - parameter section: 对应的Section 6 7 - returns: 对应Section中cell的个数 8*/ 9func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int{10return self.dataSource!.count
11}
6. 下面这个方法是比较重要的,下方的方法,就是返回每行的Cell的委托回调方法。通过Cell的重用标示符来创建Cell的实例对象,并对Cell上的一些属性赋值,并返回当前是Cell实例对象,代码如下所示。
1/** 2 返回要显示的Cell 3 4 - parameter tableView: cell要显示的TableView 5 - parameter indexPath: cell的索引信息 6 7 - returns: 返回要显示的Cell对象 8*/ 9func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {1011let cell:BeautifulGrillCell = self.myTableView.dequeueReusableCellWithIdentifier("BeautifulGrillCell", forIndexPath: indexPath)as! BeautifulGrillCell1213let tempItem:Dictionary? = self.dataSource![indexPath.row]1415iftempItem != nil {16let imageName:String = tempItem![IMAGE_NAME]!17cell.girlImageView.image = UIImage(named: imageName)1819let girlName:String = tempItem![GIRL_NAME]!20cell.girlNameLable.text = girlName21 }2223return cell24 }25}
经过上面这些步骤,你就可以去实现博客最上方截图中的效果了,上面主要用到的还是TableView的UITableViewDatasource委托代理, 使用方法如上。上面使用的委托回调主要是使用Swift中的协议(Protocol)来实现的。那么如何使用协议来实现你自己的委托回调呢?这将是下面将要介绍的内容。
二. 认识协议,并使用协议实现委托回调
接下来的内容就要介绍如何使用协议来定义属于你自己的委托代理回调(Delegate)了。第二部分还是以实例为准,在上面的Demo中加入我们自己定义的委托代理回调。我们需要做的就是,在上面界面中,我们点击任意Cell就可以Push(导航控制器展示视图控制器的一种方式,可以理解为视图控制器压栈的过程)到一个ViewController中,这个ViewController要做的事情就是输入美女的名字,点击返回后通过自己定义的委托回调,把你输入的值回调到上一个页面(TableView)中去,并修改相应Cell上的名字。说白了,就是对美女的名字做一个修改。
如果上面的文字让你迷惑的话,那么接下来看实例好了,该实例还算是简单的。下方是实例的操作步骤,如下所示:
上面实例的意思就是把下一个页面的值通过委托代理回调的形式传到上个页面中去,在前面的博客《窥探Swift之函数与闭包的应用实例》中也做了同样的事情,不过之前我们是使用闭包(Closure)回调来实现的。先在我们要通过Delegate来实现。接下来我们就定义协议,然后再协议的基础上实现委托代理回调。接下来了开始我扩充的部分。
1.实现编辑美女姓名的页面
(1) 在Storyboard上新添加一个视图控制器(UIViewController), 并命名为EditViewController,给视图控制器就是上方截图中绿色的那个视图控制器,主要用来对美女姓名 修改,并通过委托回调把值传给上个页面。该视图控制器的页面布局比较简单,具体如下所示:
(2)UI就如数所示,为EditViewController关联EditViewController.swift源文件后,再对其上面的使用到的控件进行关联即可。紧接着我们要实现一个协议,这个协议我们用来所委托回调使用。这个协议可以定义在EditViewController.swift源文件中。在协议定义之前,先对什么是协议简单的提上一嘴。先简单的理解,协议中的方法只有声明,没有实现,并且使用protocol关键自进行声明,下方的代码就是我们要使用的协议。协议中有一个fetchGirlName(name:String)的方法,用来回调出输入的数值。默认方法是必选的,你可以使用optional关键字使方法可选,在此就不做过多赘述了。
1protocol EditViewControllerDelegate: NSObjectProtocol{2 func fetchGirlName(name:String)3}
(3) 接着要实现EditViewController类中的东西了,代码如下。
成员变量var girlOldName:String?负责接收上个页面传过来的美女的姓名。weak var delegate: EditViewControllerDelegate? 这个声明为weak的delegate成员变量则是必须要实现EditViewControllerDelegate协议的委托代理者,使用weak修饰为了避免强引用循环。接着是girlNameTextField就是关联的输入框了,负责接收用户输入,把值交付给委托代理者。
在viewWillDisappear方法中,会将用户输入的值交付给委托代理者的fetchGirlName方法。deinit是析构函数,用来观察是否引起强引用循环,因为我们是使用的weak, 所以不会引起强引用循环,该deinit方法当返回时,是会被释放掉的。
1class EditViewController: UIViewController { 2 3vargirlOldName:String? 4weakvardelegate: EditViewControllerDelegate? 5@IBOutletvargirlNameTextField: UITextField! 6 7 8override func viewDidLoad() { 9 super.viewDidLoad()10ifself.girlOldName != nil {11self.girlNameTextField.text = self.girlOldName!12 }13 }1415override func viewWillDisappear(animated: Bool) {16let name:String! = self.girlNameTextField.text17ifname !="" {18ifdelegate!= nil {19delegate!.fetchGirlName(name)20 }21 }22 }2324override func didReceiveMemoryWarning() {25 super.didReceiveMemoryWarning()26 }2728 deinit {29print("释放")30 }31}
2.上面的代码是实现编辑页面并实现相应的委托协议,下方就是要从之前TableView中进行跳转。也就是点击TableView的每一行,然后跳转到编辑页面对其当前点击的cell进行编辑,编辑后返回通过代理进行值的修改。
(1)首先要解决的就是点击Cell跳转到EditViewController, 要执行这个事件,我们还必须实现TableView的另一个协议,就是UITableViewDelegate, 以为点击Cell的事件获取的方法就在TableViewDelegate中。所以我们要在TableView所在的ViewController中的viewDidLoad()中指定UITableViewDelegate的委托代理者。如下所示。同时该ViewContoller也要实现UITableViewDelegate协议。
1self.myTableView.delegate= self
(2) 实现UITableViewDelegate协议中点击Cell的方法,方法中的内容如下所示。在该方法中,首先我们要暂存一下点击的是哪个Cell, 也就是记录一下点击Cell的IndexPath, 然后就是获取点击的Cell对象,因为通过该Cell对象,可以获取相应Cell上的数据。具体的不多说了,请看代码中的注释。
1//-----------UITableViewDelegate------------------ 2 func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) { 3 4//记录当前点击的IndexPath 5self.selectIndexPath = indexPath 6 7//获取当前点击的Cell对象 8let currentSelectCell:BeautifulGrillCell? = self.myTableView.cellForRowAtIndexPath(indexPath)as? BeautifulGrillCell 910//从storyboard中实例化编辑视图控制器11let editViewController:EditViewController = UIStoryboard(name:"Main", bundle: NSBundle.mainBundle()).instantiateViewControllerWithIdentifier("EditViewController")as! EditViewController1213//指定编辑视图控制器委托代理对象14editViewController.delegate= self1516//把点击Cell上的值传递给编辑视图控制器17ifcurrentSelectCell != nil {18editViewController.girlOldName = currentSelectCell!.girlNameLable.text!19 }2021//push到编辑视图控制器22self.navigationController?.pushViewController(editViewController, animated:true)23}
(3)上面是跳转,接下来就是要实现EditViewControllerDelegate中的回调方法,来处理相应的回调参数了。下方就是在表视图中实现的回调方法,具体请看代码中的注释:
1//-----------EditViewControllerDelegate------------------ 2 3 func fetchGirlName(name: String) { 4 5ifselectIndexPath != nil { 6//获取当前点击Cell的索引 7let index = (selectIndexPath?.row)! 8 9//更新数据源中相应的数据10self.dataSource![index][GIRL_NAME] = name1112//重载TableView13 self.myTableView.reloadData()14 }1516}
经过上面的步骤,我们就可以去定义属于自己的协议,并在此协议上实现委托回调了。上面的场景在iOS开发中极为常见,使用场景也是比较广泛的。所以协议无论在Swift还是在iOS开发中都是极为重要的概念之一。好今天的博客内容也挺多的了,就到此为止,剩下的东西,会在以后的博客中继续更新。