Designated Initializer编写规范

Designated Initializer翻译过来就是`指定初始化函数。先看一则关于UIViewController的小故事。

如何创建UIViewController

如何创建一个UIViewController呢?不懂?老老实实翻API去...

图中的Designated Initializer标志说明,系统推荐你使用initWithNibName:bundle:方法创建UIViewController及其子类,不要用其他什么乱七八糟的方法创建对象。因此通常你会这么写:

//MyViewController.h
//MyViewController.m is clean
@interface MyViewController : UIViewController
@end

//client
NSBundle *bundle = ...;
MyViewController *vc = [MyViewController alloc] initWithNibName:@"vcNib" bundle:bundle];

更高逼格

如果想逼格高一点,自己给MyViewController创建一个新的指定初始化函数可以吗?可以!比如在初始化时,把作者名字也传进去。那你得这么写:

//MyViewController.h
@interface MyViewController : UIViewController
@property (nonatomic, strong) NSString *author;
@end
- (instancetype)initWithNibName:(NSString *)nibName bundle:(NSBundle *)nibBundle author:(NSString *)author;

//MyViewController.m
@implementation MyViewController
- (instancetype)initWithNibName:(NSString *)nibName bundle:(NSBundle *)nibBundle author:(NSString *)author {
    if((self=[super initWithNibName:nibName bundle:nibBundle])) { //调用父类的Designated Initializer
        _author = author;
    }
    return self;
}

//自动继承父类的- (instancetype)initWithNibName: bundle:方法
@end

此时- (instancetype)initWithNibName:bundle:author:变成了:MyViewController的指定初始化函数。

- (instancetype)initWithNibName:bundle:则变成了MyViewController的便利初始化函数(Convenience Initializer/Secondary Initializer)。

也就是说,从此以后,我们应该使用- (instancetype)initWithNibName:bundle:author:来创建MyViewController对象。

手痒怎么办

虽然- (instancetype)initWithNibName:bundle:已经被降级为便利初始化函数。但如果你哪天手痒,仍然使用它来创建MyViewController,就会造成author属性没有值了!如果你在指定初始化函数中做了额外的操作,也没有机会得到调用了(比如初始化了一些私有变量)!

为了避免这样的问题,我们应该把指定初始化函数看做是初始化的统一出口。我们需要重写所有便利初始化函数,让便利初始化函数在内部转调指定初始化函数。

//MyViewController.m
@implementation MyViewController

//指定初始化函数
- (instancetype)initWithNibName:(NSString *)nibName bundle:(NSBundle *)nibBundle author:(NSString *)author {
    if((self=[super initWithNibName:nibName bundle:nibBundle])) { //调用父类的Designated Initializer
        _author = author;
        _address = @"Kings Road"; //额外操作,初始化私有变量
    }
    return self;
}

//重写从父类继承过来的便利初始化函数
- (instancetype)initWithNibName:(NSString *)nibName bundle:(NSBundle *)nibBundle {
    if((self=[self initWithNibName:nibName bundle:nibBundle author:@"anonymous"])) { //调用MyViewController的Designated Initializer
        _address = @"Kings Road"; //额外操作,初始化私有变量
    }
    return self;
}
@end

搞掂!此时即使你调用便利初始化函数,在内部也会转调指定初始化函数,确保初始化过程的完整性。以后我们只需保证指定初始化函数是正确的就行了。

自己创建一个便利初始化函数

//MyViewController.m
@implementation MyViewController
//指定初始化函数
...

//自己创建的便利初始化函数
//这次我们不要bundle了..真的好吗..只是举个栗子
- (instancetype)initWithNibName:(NSString *)nibName {
    if((self=[self initWithNibName:nibName bundle:nil author:nil])) { //调用MyViewController的Designated Initializer
        
    }
    return self;
}
@end

其实做法和之前的方式是完全一样的: 只要确保便利初始化函数在内部转调指定初始化函数就可以了。

只能有一个Designated Initializer吗?


这是API中关于initWithNibName:bundle:方法的讨论。高亮部分说到: 如果使用storyboard创建VC,则系统自动调用initWithCoder:创建VC,而不是使用initWithNibName:bundle:创建VC。

...这脸打得好疼。之前还说推荐使用initWithNibName:bundle:,为毛系统自己却用initWithCoder:创建VC。

公布答案: 这两个方法其实都是UIViewController的指定初始化函数,但隶属于不同的初始化数据源。initWithNibName:bundle:使用nibName的名字和bundle来创建VC。而initWithCoder:使用一个已被序列化的VC对象作为参数,并将VC对象反序列化。

科普: 序列化是指把一个对象实例转为二进制数据,然后保存硬盘文件中。反序列化则把一个二进制数据读取出来,重新解析为一个对象。这和平常直接用文本值初始化对象是不一样的。

在objc中,如果希望对象支持序列化和反序列化,则必须实现NSCoding接口,并实现其中的两个方法。

结论: 在同一个类中,我们可以拥有多个Designated Initializer, 每一个Designated Initializer负责使用一种类型的数据源进行初始化。

总结

  1. Designated Initializer表示指定初始化函数(唯一的初始化出口)。
  2. 如果需要创建新的指定初始化函数,则新的指定初始化函数在内部调用父类的指定初始化函数。而旧的指定初始化函数降级为便利初始化函数,你必须重写便利初始化函数,并在里面转调新的指定初始化函数。
  3. 如果需要自己创建便利初始化函数,则在里面必须转调指定初始化函数。(和第二点一样)
  4. 一个类可以拥有多个指定初始化函数。你需要根据初始化数据源选择其中一个指定初始化函数。(不建议为一种初始化数据源创建多个指定初始化函数)。

References

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,033评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,725评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,473评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,846评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,848评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,691评论 1 282
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,053评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,700评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,856评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,676评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,787评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,430评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,034评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,990评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,218评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,174评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,526评论 2 343

推荐阅读更多精彩内容