It’s a key concept to understand conceptually so getting your head around how to think about it ahead of the technical details is important. Simply put, a delegate is a callback.
Two main scenarios to use delegates:
- A class or control wants to abstract out the details on how to do work (like retrieve data).
- Allow others to hook code into a pipeline.
Examples:
UITableView – a table view is just a control that knows how to render a list of cells. It handles all the heavy lifting of rendering, scrolling, etc… But, it has no idea how to load your data. So you implement a datasource delegate which has methods to get the cell data for a given row etc… That makes it easy on you. You just use the control and plug in the specifics for your data. The UITableView will do everything for you … just answer a few specific questions for. A delegate answers those few specific questions.
A text control – you add a text control to your view and voila! you can type in it and alls good. But what if you want to do something when they start typing or when they’re done typing? Well, the text control offers a delegate with methods that allow you to hook into the execution pipeline of the text control. It allows the text control to do everything for you and allows you to interject code where you need it. Many times, there’s way to interject code to make a decision on whether something is allowed. The control will call back and ask, should I be able to do x? You can interject code and influence the behavior.
If you’re creating a control or class, you can create your own protocol, datasource delegates etc… so your control can focus on doing what’s advertised. For example, let’s say you wanted to create a task control. You could:
First, create a contract. Hey, if you’re going to provide data for my control, these are the questions I’m going to ask you. I’ll take it from there… In this case, I’m going to ask you the number of tasks and I’m going to have you give me a task given the row number.
@protocol XXTaskBoardDelegate <NSObject>
-(NSInteger*)getTaskCount;
-(XXTask*)getTaskForRow:(NSInteger*)rowNumber;
@end
In the control or class, give the consumer a way to give us the delegate datasource class that will answer the questions the control will ask. At this point, the control is a pure control. It knows nothing about how you get your data. It’s asking for an object (id) that implements a contract/protocol. id
@implementation XXTaskBoard
- (void)setDelegate:(id<XXTaskBoardDelegate>)newDelegate
{
// the control stores the delegate so it can callback and ask you questions.
}
Then, for the delegate class, in the header declare you implement that formal protocol
and in the implementation m file you provide the code.
@interface AppController : NSObject<XXTaskBoardDelegate>
{
//...
}
then, implement it in the implementation
@implementation AppController
- (NSInteger*)getTaskCount
{
return [model queryTaskCount];
}
- (XXTask*)getTaskForRow:(NSInteger*)rowNumber
{
return [[model tasks] getItem:(NSInteger*)rowNumber];
}