How to handle Objective-C protocols that contain properties?

I've seen usage of Objective-C protocols get used in a fashion such as the following:

@protocol MyProtocol <NSObject>

@required

@property (readonly) NSString *title;

@optional

- (void) someMethod;

@end

I've seen this format used instead of writing a concrete superclass that subclasses extend. The question is, if you conform to this protocol, do you need to synthesize the properties yourself? If you're extending a superclass, the answer is obviously no, you do not need to. But how does one deal with properties that a protocol requires to conform to?

To my understanding, you still need to declare the instance variables in the header file of an object that conforms to a protocol that requires these properties. In that case, can we assume that they're just a guiding principle? CLearly the same isn't the case for a required method. The compiler will slap your wrist for excluding a required method that a protocol lists. What's the story behind properties though?

Here's an example that generates a compile error (Note: I've trimmed the code which doesn't reflect upon the problem at hand):

MyProtocol.h

@protocol MyProtocol <NSObject>

@required
@property (nonatomic, retain) id anObject;

@optional

TestProtocolsViewController.h

- (void)iDoCoolStuff;

@end

#import <MyProtocol.h>

@interface TestProtocolsViewController : UIViewController <MyProtocol> {

}

@end

TestProtocolsViewController.m

#import "TestProtocolsViewController.h"

@implementation TestProtocolsViewController
@synthesize anObject; // anObject doesn't exist, even though we conform to MyProtocol.

- (void)dealloc {
    [anObject release]; //anObject doesn't exist, even though we conform to MyProtocol.
    [super dealloc];
}

@end     

The protocol is just telling everyone that knows about your class through the protocol, that the property anObject will be there. Protocols are not real, they have no variables or methods themselves - they only describe a specific set of attributes that is true about your class so that objects holding references to them can use them in specific ways.

That means in your class that conforms to your protocol, you have to do everything to make sure anObject works.

@property and @synthesize are at heart two mechanisms that generate code for you. @property is just saying there will be a getter (and/or setter) method for that property name. These days @property alone is enough to also have methods and a storage variable created for you by the system (you used to have to add @sythesize). But you have to have something to access and store the variable.

Here's an example of mine that works perfectly, the protocol definition first of all:

@class ExampleClass;

@protocol ExampleProtocol

@required

// Properties
@property (nonatomic, retain) ExampleClass *item;

@end

Below is a working example of a class supporting this protocol:

#import <UIKit/UIKit.h>
#import "Protocols.h"

@class ExampleClass;

@interface MyObject : NSObject <ExampleProtocol> {

    // Property backing store
    ExampleClass        *item;

}


@implementation MyObject

// Synthesize properties
@synthesize item;

@end

all you have to do really is to drop a

@synthesize title;

in your implementation and you should be all set. it works the same way as just putting the property in your class interface.

Edit:

You may want to do this more specifically:

@synthesize title = _title;

This will fall in line with how xcode's automatic synthesis creates properties and ivars if you use auto-synthesis, so that way if your class has properties from a protocol and a class, some of your ivars won't have the different format which could impact readability.

Take a look at my article PROPERTY IN PROTOCOL

Suppose I have MyProtocol that declares a name property, and MyClass that conforms to this protocol

Things worth noted

1. The identifier property in MyClass declares and generates getter, setter and backing _identifier variable
2. The name property only declares that MyClass has a getter, setter in the header. It does not generate getter, setter implementation and backing variable.

3. I can’t redeclare this name property, as it already declared by the protocol. Do this will yell an error

   @interface MyClass () // Class extension
   
   @property (nonatomic, strong) NSString *name;
   
   @end
   

How to use property in protocol

So to use MyClass with that name property, we have to do either

1. Declare the property again (AppDelegate.h does this way)

   @interface MyClass : NSObject <MyProtocol>
   
   @property (nonatomic, strong) NSString *name;
   
   @property (nonatomic, strong) NSString *identifier;
   
   @end
   

2. Synthesize ourself

   @implementation MyClass
   
   @synthesize name;
   
   @end