[Note] Effective OC - Item 19~22

Chapter 3. Interface and API Design

<br />


Item 19: Use Clear and Consistent Naming

<br />
这一节讲的是编程三大难题之一:变量与函数的命名。
其实并没有讲变量的命名...大概是因为变量都是名词,只有我们这种非母语的人才会纠结吧_(:з」∠)_ 这一节内容在文档Coding Guidelines for Cocoa。
OC的方法格式看习惯了还挺喜欢的。非常有人文关怀。长是长了,一看就明白,第一次见也不用查方法是要做什么,各个参数代表什么,这就是我们常说的牺牲空间换时间(误)。文中实力嘲讽了C++和java的方法命名,对比展示OC命名优越性。
具体说来有以下几个注意:

  • 不使用简称。
  • 不要滥用“get”。然而这一点文中的叙述我并不是特别明白…
  • 关于长句子的方法名,有返回值的,返回值所表示的名词放在最前面,后面每个参数,类型声明之前都应该是这个参数代表的名词。不需要写and。动词和介词放在中间。
  • init和工厂方法仿照官方来写,基本上是加with。
  • 代理方法尽量以本类作为开头。
  • 类和代理名都要加前缀,代理名就用类名+delegate。

说起来,命名这种事情,和语言一样,还是得文档看得多了才能比较有感觉吧。
<br />


Item 20: Prefix Private Method Names

<br />
这一节很短,说的是为private method加前缀。
表示惊吓( ⊙ o ⊙ )。我从来没给private method加过前缀…
好处有二:

  • 一是在调试中可以清楚地看清哪些方法是private,哪些方法是public。
  • 二是知道了是private就明白不会影响外界API,方便改动。而其余的public method改动起来就要更三思。

我觉得这两条其实说的是一回事。
具体添加什么前缀呢。并不是类名那种三个字母的前缀。文中推荐的是子母+下划线的形式,比如’p_’。不要只用一个下划线,以免和官方的方法名相冲突。
<br />


Item 21: Understand the Objective-C Error Model

<br />
这一节主要讲NSError的使用。
开头先说了NSException。NSException是遇到fatal error时才会使用的,抛出异常以后程序也应该直接终止,这样就不用再关心因为抛出异常而无法执行后面释放资源的代码,使得内存泄露的问题了。但如果是比较小的错误,并不希望程序因此退出,所以如果能用NSError处理就不要使用它。
NSError的详细使用参照Error Handling Programming Guide。
常用到的三个属性是code,domain和userInfo,因为初始化方法需要确定的就是这三个参数。三个属性都是readonly的。
domain -> code -> user info 按顺序对错误提供越来越详细的描述。domain可以看到是哪个系统出错,code可以看到错误的具体名字,一般采用enum来定义,看到code已经可以明白是什么错了,或者已经可以复制到搜索栏了...user info是一个字典,里面的信息更加详细。
文中列举了两个常见的使用场景。
一种是作为待处理的传入参数,像这样:

- (void)connection:(NSURLConnection *)connection didFailWithError: (NSError *)error

这种在网络传输相关的函数和block里都很常见。
第二种我还没见过,是作为输出参数回调,像这样:

- (BOOL)doSomethig:(NSError **)error

回调以后的用法:

NSError *error = nil;
BOOL ret = [object doSomething: &error];
if (error){
    \\
}

也就是说,方法调用的时候传递的是error的指针,调用完成后通过这个指针就直接能得到error对象和里面的信息了,虽然是作为参数传进去的,作用却类似于返回值。并且,在方法执行完毕后,系统会保证这个error对象可以自动释放。
<br />


Item 22: Understand the NSCopying Protocol

<br />
这一节讲应该怎样为自定义类实现NSCopying协议。
NSCopying协议是针对可以允许copy操作的类。实现这个协议,如果是普通的类,只需要实现一个方法:

- (id)copyWithZone: (NSZone *)zone

而如果是有immutable和mutable两个版本的类,则需要实现两个方法:

- (id)copyWithZone:(NSZone *)zone
- (id)mutableCopyWithZone:(NSZone *)zone

也就是说,当我们调用[someObject copy];[someObject mutableCopy]时,背后调用的就是这两个方法。这里的zone参数编程的时候都不用去管它,交给系统自动完成。
默认习惯是,copy返回的是immutable对象,mutableCopy返回的是mutable对象,不管原对象可变与否,copy出来的新对象都是这个规律。
就方法的具体写法来说,就是创建一个新的对象,把需要copy的值赋值给这个新的对象,然后返回即可。文中有一个EOCPerson的例子,很清晰。
系统的所有collection默认情况下执行的是shallow copy,所以一般我们也是这么做。如果非常想做deepCopy,也可以专门再写一个deepCopy方法,比如系统的NSSet就有专门的深拷贝init方法,在写deepCopy时可以对所需copy的属性调用这个方法,就可以实现整个类的deep copy了。

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

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,596评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,577评论 18 399
  • 写在最前面: 这是我读这本书的第一遍,目前暂定为1.0版本吧。很多地方都还没有很好的理解透彻,只是理解到了一点皮毛...
    LaiYoung_阅读 1,805评论 4 18
  • 事情是这样的,就跟大多数穿越网文的主角一样,我们的主角张启是个屌丝。 不过与众不同的是,张启是个爱看网...
    狗子是只怂猫阅读 1,077评论 5 13
  • 很小的时候,就有人告诉我,生活充满了酸甜苦辣各种味道。我似懂非懂地点点头,内心却并没有真正体会到。现在想来,原来生...
    沂河生阅读 378评论 2 1