接口与 API

第 3 章 接口与 API 设计

第 15 条：用前缀避免命名空间冲突

Apple 宣称其保留使用所有“两字母前缀”的权利，所以你自己选用的前缀应该是三个字母的。

第 16 条：提供“全能初始化方法”
可以为对象提供必要信息以便其完成工作的初始化方法叫做“全能初始化方法”。

第 17 条：实现 description 方法

第 18 条：尽量使用不可变对象
尽量创建不可变对象
若某属性仅可于对象内部修改，则在“class-continuation 分类”中将其由 readonly 属性扩展为 readwrite 属性
不要把可变的 collection 作为属性公开，而应提供相关方法，以此修改对象中得可变 collection.

第 19 条：使用清晰而协调的命名方式
第 20 条：为私有方法名加前缀

• (void)p_privateMethod { }

• 给私有方法的名称加上前缀，这样可以很容易地将其同公共方法区分开。
• 不要单用一个下划线做私有方法的前缀，因为这种做法是预留给苹果公司用的。

第 21 条：理解 Objective-C 错误模型

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

• （id）copyWithZone:(NSZone*)zone

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