接口与API设计
第15条:用前缀避免命名空间冲突
OC没有其他语言那种内置的命名空间。所以我们起名时要避免潜在的命名冲突,否则就容易重名,而引发命名冲突(
naming clash
)。Apple宣称其保留使用所有“两字母前缀”,所以我们一般还是三个字母开头比较好,选择与我们自己的公司、应用程序或二者皆有关联之名作为类名的前缀。
第16条:提供“全能初始化方法”
为对象提供必要信息以便其完成工作的初始化方法叫做“全能初始化方法”,也可以称为“指定初始化方法”。
例如UITableViewCell
中的初始化
- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(nullable NSString *)reuseIdentifier `
再看看 UISegmentedControl
和UINavigationItem
的初始化,就董了。
第17条:实现”description“方法
平常我们自定义的类中,如果我们直接打印我们的对象它会输出<Object:0x*****>
,并不是我们要的,这样并没有什么用,所以当我们重写description
的时候才可能满足我们调试的需求。
- (NSString *)description
{
return [NSString stringWithFormat:@"%@:%@,%@",[self class],self,@"你需要的属性"];
}
另外你也可以重写debugDescription
,再与”po
“命令一起使用配合调试。
第18条:尽量使用不可变对象
简单的说,我们设计出来的类里面属性,我们是不希望让别人改变的,一般设置为只读的(
read-only
),如果是可变的情况下,很容易改变set
的内部结构,从而失去了固有的意义。
第19条:使用清晰而协调的命名方式
遵从Objective-C命名规范,言简意赅,不使用缩略后的类型名称。
参照下 NSString 类的方法,你就懂了
- (BOOL)hasPrefix:(NSString *)str;
- (BOOL)hasSuffix:(NSString *)str;
- (NSString *)substringFromIndex:(NSUInteger)from;
- (NSString *)substringToIndex:(NSUInteger)to;
- (NSString *)substringWithRange:(NSRange)range;
- (void)insertString:(NSString *)aString atIndex:(NSUInteger)loc;
- (void)deleteCharactersInRange:(NSRange)range;
- (void)appendString:(NSString *)aString;
- (void)appendFormat:(NSString *)format, ... NS_FORMAT_FUNCTION(1,2);
- (void)setString:(NSString *)aString;
第20条:对私有方法名加前缀
这样的有助于调试,也很容易让我们将公共方法和私有方法区分开,另外便于修改方法名。但是要注意不要但用一个下滑线做私有方法的前缀,因为这中做法是预留给苹果公司的。
- (void)yp_setMyTestMethod
{
// y==我,p== private
}
- (void)_setSomeMethod
{
// 这种是苹果公司预留,不推荐
}
第21条:理解Objective-C错误类型
现在一般的语言都有异常处理机制,Objective-C也不例外。在OC中异常只用于处理严重错误(
fatal error
),出现”不那么严重的错误(nonfatal error
)“,它会是令方法返回nil
/0,或者使用NSError
,以表明有错误发生。 所以我们还是需要了解下NSError
。
第22条:理解NSCoping协议
在Objective-c中, 某个类遵守了NSCopying
协议就代表这个类支持[obj copy]
操作。在没有实现NSCopying
协议的情况下调用对象的copy
函数则会出现异常。NSCopying
协议只有一个函数,即copyWithZone
, 声明如下 :
@protocol NSCopying
- (id)copyWithZone:(nullable NSZone *)zone;
@end
@protocol NSMutableCopying
- (id)mutableCopyWithZone:(nullable NSZone *)zone;
@end
浅拷贝之后的内容与原始内容均指向相同对象;深拷贝之后的内容所指的对象是原始内容中相关对象的一份拷贝。用一句简单的话来说就是浅拷贝,只是对指针的拷贝,拷贝后两个指针指向同一个内存空间,深拷贝不但对指针进行拷贝,而且对指针指向的内容进行拷贝,经深拷贝后的指针是指向两个不同地址的指针。
- 若想令自己所写的对象具有拷贝功能,需要实现”
NSCopying
“协议。
- 如果自定义的对象分为可变与不可变版本,那么就要同时实现”
NSCopying
“与”NSMutableCopying
“协议。
协议和分类
第23条:通过委托和数据源协议进行对象间通信
简单的说,就是多用代理进行数据传递。可以参照
UITableView
的delegate
和data source
进行处理,当然也可以直接写一个Protocol
进行例如String
进行传递。
第24条:将类的实现代码分散到便于管理的数个分类中
这个就是我们需要有分类的思想,通过分类机制,可以把类代码中分成很多歌易于管理的小块,便于单独检查。
第25条:总是为第三方类的分类名称增加前缀
这个同理第15条,在我们向第三方类中添加分类时,总应给其名称和其中的方法加上你专有的前缀,达到易于区分,避免错误的目的。
第26条:勿在分类中申明属性
因为除了”Class-continuation分类“,其他分类无法向类中新增实例变量,这样就无法把实现属性所需要的实例变量合成出来。
第27条:使用”Class-continuation分类“隐藏细节
Class-continuation分类和普通的分类不同,它必须定义在其所接续的那个类的实现文件里。其重要之处,这是唯一能声明。一般我们单独建立一个自定义的
View
或NSObject
类中我们就常用到。
#import "TestPeople.h"
@interface TestPeople ()
// 写你所需要的私有变量或方法
@end
@implementation TestPeople
// 实现
@end
第28条:通过协议提供匿名对象
我们可以用协议把自己所写的API之中的实现细节隐藏起来,将返回的对象设计为遵从此协议的纯
id
类型。这样的话,想要隐藏的类名就不会出现在API之中啦。
因为有时候接口的背后有多个不同的实现类,而你又不想指明具体使用的类,那么就要考虑这个方法啦。