编写高质量 iOS 与 OS X代码的 52 个有效方法(读书笔记)

  1. 了解 Objective-C 语言的起源

    • Objective-CC 语言添加了面向对象特性,是其超集。Objective-C 使用动态绑定的消息结构,也就是说,在运行时才会检查对象类型。接收一条信息之后,究竟应执行何种代码,由运行环境而非编译器来决定。
    • 理解 C 语言的核心概念有助于写好 Objective-C 程序。尤其要掌握内存模型与指针
  2. 在类的头文件中尽量少引入其他头文件

    • 除非确有必要,否则不要引入头文件。一般来说,应在某个类的头文件中使用向前声明来提及别的类,并在实现文件中引入那些类的头文件。这样做可以尽量降低类之间的耦合。
    • 有时无法使用向前声明,比如要声明某个类遵循一项协议。在这种情况下,尽量把“该类遵循某协议”的这条声明移至“class-continuation分类”中。如果不行的话,就把协议单独放在一个头文件中,然后将其引入。
    1
    2
    3
    4
    // .h
    @class ClassName
    // .m
    #import
  3. 多用字面量语法,少用与之等价的方法

    • 应该使用字面量语法来创建字符串、数值、数组、字典。与创建此类对象的常规方法相比,这么做更加简明扼要。
    • 应该通过取下标操作来访问数组下标或字典中的键所对应的元素。
    • 用字面量语法创建数组或字典时,若值中有 nil,则会抛出异常。因此,务必确保值里不含 nil
    1
    2
    3
    4
    5
    6
    NSString *someString = @"string";
    NSNumber *someNumber = @1;
    NSNumber *expressionNumber = @(x * y);
    NSArray *array = @[ob1, ob2, ob3];
    NSDictionary *personData = @{@"" : @""};
    NSMutableArray *mutable = [@[@1, @2] mutableCopy]
  4. 多用类型常量,少用 #define 预处理指令

    • 不要用预处理指令定义常量。这样定义出来的常量不含类型信息,编译器只是会在编译前据此执行查找与替换操作。即使有人重新定义了常量值,编译器也不会产生警告信息,这将导致应用程序中的常量值不一致。
    • 在实现文件中使用 static const 来定义“只在编译单元内可见的常量”。由于此类常量不在全局符号表中,所以无须为其名称加前缀。
    • 在头文件中使用extern来声明全局常量,并在相关实现文件中定义其值。这种常量要出现在全局符号表中,所以其名称应以区隔,通常用与之相关的类名做前缀
    1
    2
    3
    4
    5
    6
    7
    8
    static const NSTimeInterval kAnimationDuration = 0.3f;
    static const NSTimeInterval EOCViewClassAnimationDuration = 0.3f;

    // .h
    extern NSString *const EOCStringConstant;
    // .m
    NSString *const EOCStringConstant = @"VALUE";

  5. 用枚举表示状态、选项、状态码

    • 应该用枚举来表示状态机的状态、传递给方法的选项以及状态码等值,给这些值起个易懂的名字。
    • 如果把传递给某个方法的选项表示为枚举类型,而多个选项又可同时使用,那么就将各选项值定义为2的幂,以便通过按位或操作将其组合起来。
    • NS_ENUMNS_OPTIONS 宏来定义枚举类型,并指明其底层数据类型。这样做可以确保枚举是用开发者所选的底层数据类型实现出来的,而不会采用编译器所选的类型。
    • 在处理枚举类型的 switch 语句中不要实现 default 分支。这样的话,加入新枚举之后,编译器就会提示开发者:switch 语句并未处理所有枚举。
    1
    2
    3
    4
    5
    6
    7
    8
    typedef NS_ENUM(NSUInteger, EOCConnectionState) {
    EOCConnectionStateDisconnected,
    // ...
    };
    typedef NS_OPTIONS(NSUInteger, EOCPermittedDirection) {
    EOCPermittedDirectionUp = 1 << 0,
    // ...
    }
  6. 理解 “属性” 这一概念

    • 可以用 @property 语法来定义对象中所封装的数据。
    • 通过 “特质” 来指定存储数据所需的正确语义。
    • 在设置属性所对应的实例变量时,一定要遵从该属性所声明的语义。
    • 开发 iOS 程序时应该使用 nonatomic 属性,因为 atomic 属性会严重影响性能。
  7. 在对象内部尽量直接访问实例变量

    • 在对象内部读取数据时,应该直接通过实例变量来读,而写入数据时,则应通过属性来写。
    • 在初始化方法及 dealloc 方法中,总是应该直接通过实例变量来读写数据。
    • 有时会使用惰性初始化技术配置某份数据,这种情况下,需要通过属性来读取数据。
  8. 理解 “对象等同性” 这一概念

    • 若想检测对象的等同性,请提供 “isEqual:”hash 方法。
    • 相同的对象必须具有相同的哈希码,但是两个哈希码相同的对象却未必相同。
    • 不要盲目地逐个检测每条属性,而是应该依照具体需求来制定检测方案。
    • 编写 hash 方法时,应该使用计算速度快而且哈希码碰撞几率低的算法。
  9. “类族模式” 隐藏实现细节

    • 类族模式可以把实现细节隐藏在一套简单的公共接口后面。
    • 系统框架中经常使用类族。
    • 从类族的公共抽象基类中继承子类时要当心,若有开发文档,则应首先阅读。
  10. 在既有类中使用关联对象存放自定义数据

    • 可以通过 “关联对象” 机制来把两个对象连起来。
    • 定义关联对象时可指定内存管理语义,用以模仿定义属性时所采用的 “拥有关系”“非拥有关系”
    • 只有在其他做法不可行时才应选用关联对象,因为这种做法通常会引入难于查找的 bug
  11. 理解 objc_msgSend 的作用

    • 消息由接收者选择子参数构成。给某对象 “发送消息” 也就相当于在该对象上 “调用方法”
    • 发给某对象的全部消息都要由 “动态消息派发系统” 来处理,该系统会查出对应的方法,并执行其代码。
  12. 理解消息转发机制

    • 若对象无法响应某个选择子,则进入消息转发流程。
    • 通过运行期的动态方法解析功能,我们可以在需要用到某个方法时再将其加入类中。
    • 对象可以把其无法解读的某些选择子转交给其他对象来处理。
    • 经过上述两步之后,如果还是没有办法处理选择子,那就启动完整的消息转发机制。
  13. “方法调配技术” 调试 “黑盒方法”

    • 在运行期,可以向类中新增或替换选择子所对应的方法实现。
    • 使用另一份实现来替换原有的方法实现,这道工序叫做 “方法调配”,开发者常用此技术向原有实现中添加新功能。
    • 一般来说,只有调试程序的时候才需要在运行期修改方法实现,这种做法不宜滥用。
  14. 理解 “类对象” 的用意

    • 每个实例都有一个指向 Class 对象的指针,用已表明其类型,而这些 Class 对象则构成了类的继承体系。
    • 如果对象类型无法在编译期确定,那么就应该使用类型信息查询方法来探知。
    • 尽量使用类型信息查询方法来确定对象类型,而不要直接比较类对象,因为某些对象可能实现了消息转发功能。
  15. 用前缀避免命名空间冲突

    • 选择与你的公司、应用程序或二者皆有关联之名称作为类名的前缀,并在所有代码中均使用这一前缀。
    • 若自己所开发的程序库中用到了第三方库,则应为其中的名称加上前缀。
  16. 提供 “全能初始化方法”

    • 在类中提供一个全能初始化方法,并与文档里指明。其他初始化方法均应调用此方法。
    • 若全能初始化方法与超类不同,则需覆写超类中的对应方法。
    • 如果超类的初始化方法不适用于子类,那么应该覆写这个超类方法,并在其中抛出异常。
  17. 实现 description 方法

    • 实现 description 方法返回一个有意义的字符串,用以描述该实例。
    • 若想在调试时打印出更详尽的对象描述信息,则应实现 debugDescription 方法。
  18. 尽量使用不可变对象

    • 尽量创建不可变的对象。
    • 若某属性仅可与对象内部修改,则在 “class-continuation分类” 中将其由 readonly 属性扩展为 readwrite 属性。
    • 不要把可变的 collection 作为属性公开,而应提供相关方法,以此修改对象中的可变 collection
  19. 使用清晰而协调的命名方式

    • 起名时应遵从标准的 Objective-C 命名规范,这样创建出来的接口更容易为开发者所理解。
    • 方法名要言简意赅,从左至右读起来要像个日常用语中的句子才好。
    • 方法名里不要使用缩略后的类型名称。
    • 给方法起名时的第一要务就是确保其风格与你自己的代码或所要集成的框架相符。
  20. 为私有方法名加前缀

    • 给私有方法的名称加上前缀,这样可以很容易地将其同公共方法区分开。
    • 不要单用一个下划线做私有方法的前缀,因为这种做法是预留给苹果公司用的。
  21. 理解 Objective-C 错误模型

    • 只有发生了可使整个应用程序奔溃的严重错误时,才应使用异常。
    • 在错误不那么严重的情况下,可以指派 “委托方法” 来处理错误,也可以把错误的信息放在 NSError 对象里,经由 “输出参数” 返回给调用者。
  22. 理解 NSCopying 协议

    • 若想令自己所写的对象具有拷贝功能,则需要实现 NSCopying 协议。
    • 如果自定义的对象分为可变版本与不可变版本,那么就要同时实现 NSCopyingNSMutableCopying 协议。
    • 复制对象时需决定采用浅拷贝还是深拷贝,一般情况下应该尽量执行浅拷贝。
    • 如果你所写的对象需要深拷贝,那么可考虑新增一个专门执行深拷贝的方法。
  23. 通过委托与数据源协议进行对象间通信

    • 委托模式为对象提供了一套接口,使其可由此将相关事件告知其他对象。
    • 将委托对象应该支持的接口定义成协议,在协议中把可能需要处理的事件定义成方法。
    • 当某对象需要从另一个对象中获取数据时,可以使用委托模式。这种情境下,该模式亦称 “数据源协议”
    • 若有必要,可实现含有位段的结构体,将委托对象是否能响应相关协议方法这一信息缓存至其中。
  24. 将类的实现代码分散到便于管理的数个分类之中

    • 使用分类机制把类的实现代码划分成易于管理的小块。
    • 将应该视为 “私有” 的方法归入名叫 Private 的分类中,以隐藏实现细节。
  25. 总是为第三方类的分类名称加前缀

    • 向第三方类中添加分类时,总应给其名称加上你专用的前缀。
    • 向第三方类中添加分类时,总应给其中的方法名加上你专用的前缀。
  26. 勿在分类中声明属性

    • 把封装数据所用的全部属性都定义在主接口里。
    • “class-continuation分类” 之外的其他分类中,可以定义存取方法,但尽量不要定义属性。
  27. 使用 “class-continuation分类” 隐藏实现细节

    • 通过 “class-continuation分类” 向类中新增实例变量。
    • 如果某属性在主接口中声明为 “只读”,而类的内部又要用设置方法修改此属性,那么就在“class-continuation分类” 中将其扩展为 “可读写”
    • 把私有方法的原型声明在 “class-continuation分类” 里面。
    • 若想使类所遵循的协议不为人所知,则可于 “class-continuation分类” 中声明。
  28. 通过协议提供匿名对象

    • 协议可在某种程度上提供匿名类型。具体的对象类型可以淡化成遵从某协议的 id 类型,协议里规定了对象所应实现的方法。
    • 使用匿名对象来隐藏类型名称(或类名)。
    • 如果具体类型不重要,重要的是对象能够响应(定义在协议里的)特定方法,那么可使用匿名对象来表示。
  29. 理解引用计数

    • 引用计数机制通过可以递增递减的计数器来管理内存。对象创建好之后,其保留计数至少为1。若保留计数为正,则对象继续存活。当保留计数降为0时,对象就被销毁了。
    • 在对象生命期中,其余对象通过引用来保留或释放此对象。保留与释放操作分别会递增及递减保留计数。
  30. ARC 简化引用计数

    • ARC 之后,程序员就无须担心内存管理问题了。使用 ARC 来编程,可省去类中的许多 “样板代码”
    • ARC 管理对象生命期的办法基本上就是:在合适的地方插入 “保留”“释放” 操作。在ARC环境下,变量的内存管理语义可以通过修饰符指明,而原来则需要手工执行 “保留”“释放” 操作。
    • 由方法所返回的对象,其内存管理语义总是通过方法名来体现。ARC 将此确定为开发者必须遵守的规则。
    • ARC 只负责管理 Objective-C 对象的内存。尤其要注意:CoreFoundation 对象不归 ARC 管理,开发者必须适时调用 CFRetain/CFRelease
  31. 在dealloc方法中只释放引用并解除监听

    • 在dealloc方法里,应该做的事情就是释放指向其他对象的引用,并取消原来订阅的“键值观测”(KVO)或NSNotificationCenter等通知,不要做其他事情。
    • 如果对象持有文件描述符等系统资源,那么应该专门编写一个方法来释放此种资源。这样的类要和其使用者约定:用完资源后必须调用close方法。
    • 执行异步任务的方法不应该在dealloc里调用;只能在正常状态下执行的那些方法也不应在dealloc里调用,因为此时对象已处于正在回收的状态了。
  32. 编写“异常安全代码”时留意内存管理问题

    • 捕获异常时,一定要注意将try块内所创立的对象清理干净。
    • 在默认情况下,ARC不生成安全处理异常所需的清理代码。开启编译器标志后,可生成这种代码,不过会导致应用程序变大,而且会降低运行效率。
  33. 以弱引用避免保留环

    • 将某些引用设为weak,可避免出现“保留环”。
    • weak引用可以自动清空,也可以不自动清空。自动清空是随着ARC而引入的新特性,由运行期系统来实现。在具备自动清空功能的弱引用上,可以随意读取其数据,因为这种引用不会指向已经回收过的对象。
  34. 以“自动释放池块”降低内存峰值

    • 自动释放池排布在栈中,对象收到autorelease消息后,系统将其放入最顶端的池里。
    • 合理运用自动释放池,可降低应用程序的内存峰值。
    • @autoreleasepool这种新式写法能创建出更为轻便的字段释放池。
  35. 用“僵尸对象”调试内存管理问题

    • 系统在回收对象时,可以不将其真的回收,而是把它转化为僵尸对象。通过环境变量NSZombieEnabled可开启此功能。
    • 系统会修改对象的isa指针,令其指向特殊的僵尸类,从而使该对象变为僵尸对象。僵尸类能够响应所有的选择子,响应方式为:打印一条包含消息内容及其接收者的消息,然后终止应用程序。
  36. 不要使用retainCount

    • 对象的保留计数看似有用,实则不然,因为任何给定时间点上的“绝对保留计数”都无法反映对象生命期的全貌。
    • 引入ARC之后,retainCount方法就正式废止了,在ARC下调用该方法会导致编译器报错。
  37. 理解“块”这一慨念

    • 块是C、C++、Objective-C中的词法闭包。
    • 块可接受参数,也可返回值。
    • 块可以分配在栈或堆上,也可以是全局的。分配在栈上的块可拷贝到堆里,这样的话,就和标准的Objective-C对象一样,具备引用计数了。
  38. 为常用的块类型创建typedef

    • 以typedef重新定义块类型,可令块变量用起来更加简单。
    • 定义新类型时应遵从现有的命名习惯,勿使其名称与别的类型相冲突。
    • 不妨为同一个块签名定义多个类型别名。如果要重构的代码使用了块类型的某个别名,那么只需修改相应typedef中的块签名即可,无须改动其他typedef。
  39. 用handler块降低代码分散程度

    • 在创建对象时,可以使用内联的handler块将相关业务逻辑一并声明。
    • 在有多个实例需要监控时,如果采用委托模式,那么经常需要根据传入的对象来切换,而若改用handler块来实现,则可直接将块与相关对象放在一起。
    • 设计API时如果用到了handler块,那么可以增加一个参数,使调用者可通过此参数来决定应该把块安排在哪个队列上执行。
  40. 用块引用其所属对象时不要出现保留环

    • 如果块所捕获的对象直接或间接地保留了块本身,那么就得当心保留环问题。
    • 一定要找个适当的时机解除保留环,而不能把责任推给API的调用者。
  41. 多用派发队列,少用同步锁

    • 派发队列可用来表述同步语义,这种做法要比使用@synchronized块或NSLock对象更简单。
    • 将同步与异步派发结合起来,可以实现与普通加锁机制一样的同步行为,而这么做却不会阻塞执行异步派发的线程。
    • 使用同样队列及栅栏块,可以令同步行为更加高效。
  42. 多用GCD,少用performSelector系列方法

    • performSelector系列方法在内存管理方面容易有疏失。它无法确定将要执行的选择子具体是什么,因而ARC编译器也就无法插入适当的内存管理方法。
    • performSelector系列方法所能处理的选择子太过于局限了,选择子的返回值类型及发送给方法的参数个数都受到限制。
    • 如果想把任务放在另一个线程上执行,那么最好不要用performSelector系列方法,而是应该把任务封装到块里,然后调用大的中枢派发机制的相关方法来实现。
  43. 掌握GCD及操作队列的使用时机

    • 在解决多线程与任务管理问题时,派发队列并非唯一方案。
    • 操作队列提供了一套高层的Objective-C API,能实现纯GCD所具备的绝大部分功能,而且还能完成一些更为复杂的操作,那些操作若改用GCD来实现,则需另外编写代码。
  44. 通过Dispatch Group机制,根据系统资源状况来执行任务

    • 一系列任务可归入一个dispatch group之中。开发者可以在这组任务执行完毕时获得通知。
    • 通过dispatch group,可以在并发式派发队列里同时执行多项任务。此时GCD会根据系统资源状况来调度这些并发执行的任务。开发者若自己来实现此功能,则需编写大量代码。
  45. 使用dispatch_once来执行只需运行一次的线程安全代码

    • 经常需要编写“只需执行一次的线程安全代码”。通过GCD所提供的dispatch——once函数,很容易就能实现此功能。
    • 标记应该声明在static或global作用域中,这样的话,在把只需执行一次的块传给dispatch_once函数时,传进去的标记也是相同的。
  46. 不要使用dispatch_get_current_queue

    • dispatch_get_current_queue函数的行为常常与开发者所预期的不同。此函数已经废弃,只应做调试之用。
    • 由于派发队列是按层级来组织的,所以无法单用某个队列对象来描述“当前队列”这一概念。
    • dispatch_get_current_queue函数用于解决由不可重入的代码所引发的死锁,然而能用此函数解决的问题,通常也能改用“队列特定数据”来解决。
  47. 熟悉系统框架

    • 许多系统框架都可以直接使用。其中最重要的是Foundation与CoreFoundation,这两个框架提供了构建应用程序所需的许多核心功能。
    • 很多常见任务都能用框架来做,例如音频与视频处理、网络通信、数据管理等。
    • 请记住:用纯C写成的框架与用Objective-C写成的一样重要,若想成为优秀的Objective-C开发者,应该掌握C语言的核心概念。
  48. 多用块枚举,少用for循环

    • 遍历collection有四种方式。最基本的办法是for循环,其次是NSEnumerator遍历法及快速遍历法,最新、最先进的方式则是“块枚举法”。
    • “块枚举法”本身就能通过GCD来并发执行遍历操作,无须另行编写代码。而采用其他遍历方法则无法轻易实现这一点。
    • 若提前知道待遍历的collection含有何种对象,则应修改块签名,指出对象的具体类型。
  49. 对自定义其内存管理语义的collection使用无缝桥接

    • 通过无缝桥接技术,可以在Foundation框架中的Objective-C对象与CoreFoundation框架中的C语言数据结构之间来回转换。
    • 在CoreFoundation层面创建collection时,可以指定许多回调函数,这些函数表示此collection应如何处理其元素。然后,可运用无缝桥接技术,将其转换成具备特殊内存管理语义的Objective-C collection。
  50. 构建缓存时选用NSCache而非NSDictionary

    • 实现缓存时应选用NSCache而非NSDictionary对象。因为NSCache可以 提供优雅的自动删减功能,而且是“线程安全的”,此外,它与字典不同,并不会拷贝键。
    • 可以给NSCache对象设置上限,用以限制缓存中的对象总个数及“总成本”,而这些尺度则定义了缓存删减其中对象的时机。但是绝对不要把这些尺度当成可靠的“硬限制”,它们仅对NSCache起指导作用。
    • 将NSPurgeableData与NSCache搭配使用,可实现自动清除数据的功能,也就是说,当NSPurgeableData对象所占内存为系统所丢弃时,该对象自身也会从缓存中移除。
    • 如果缓存使用得当,那么应用程序的响应速度就能提高。只有那种“重新计算起来很费事的”数据,才值得放入缓存,比如那些需要从网络获取或从磁盘读取的数据。
  51. 精简initialize与load的实现代码

    • 在加载阶段,如果类实现了load方法,那么系统就会调用它。分类里也可以定义此方法,类的load方法要比分类中的先调用。与其他方法不同,load方法不参与覆写机制。
    • 首次使用某个类之前,系统会向其发送initialize消息。由于此方法遵从普通的覆写规则,所以通常应该在里面判断当前要初始化的是哪个类。
    • load与initialize方法都应该实现得精简一些,这有助于保持应用程序的响应能力,也能减少引入“依赖环”的几率。
    • 无法在编译器期设定的全局常量,可以放在initialize方法里初始化。
  52. 别忘了NSTimer会保留其目标对象

    • NSTimer对象会保留其目标,直到计时器本身失效为止,调用invalidate方法可令计时器失效,另外,一次性的计时器在触发完任务之后也会失效。
    • 反复执行任务的计时器,很容易引入保留环,如果这种计时器的目标对象又保留了计时器本身,那肯定会导致保留环。这种环状保留关系,可能是直接发送的,也可能是通过对象图里的其他对象间接发生的。
    • 可以扩充NSTimer的功能,用“块”来打破保留环。不过,除非NSTimer将来在公共接口提供此功能,否则必须创建分类,将相关实现代码加入其中。