effective OC2.0 52阅读笔记（三 接口与API设计）

第三章:接口与API设计

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

总结：避免重名符号错误的唯一办法是变相实现命名空间。为所有符号都加上命名前缀。类和分类都应加三字前缀。注意类实现文件中的纯C函数及全局变量，是算作“顶级符号的”（不属于任何类？）。如果用第三方库编写自己的代码，并准备将其再发布为程序库供他人使用，尤其要注意符号问题，应该再加上引用的三方库加上自己的三字前缀。（若自己所开发的程序中用到了第三方库，则应为其中的名称加上前缀）

16 提供全能初始化方法

总结：只有在全能初始化方法中，才会存储内部数据，这样的话，当底层数据存储机制改变时，只需修改此方法的代码就好，无需改动其他初始化方法。有时候需要编写多个全能初始化方法，譬如某个对象的实例有两种完全不同的创建方式，必须分开处理，例如NSCoding，提供序列化机制，对象可以此指明其自身的编码和解码方式，UI框架就广泛运用此机制，NIB和试图(xml)对象之间的转换。在类中提供一个全能初始化方法，并于文档里指明其他初始化方法均应调用此方法。若全能初始化方法与超类不同，则需覆写超类中的对应方法。如果超类的初始化方法不适用于子类，那么应该覆写这个超类方法，并在其中抛出异常。

17 实现description方法

总结：想要在po的时候调试出来重写debugDescription方法。

18 尽量使用不可变对象

总结：当属性是即可读又可写的时候设计出来的类都是可变的。应尽量把对外公布出来的属性设为只读，而且只在确有必要时才将属性对外公布。@property (nonatomic, copy, readonly) NSString *identifier;这个时候不指定内存管理语义也可以，@property (nonatomic, readonly) NSString *identifier;但是此时在外边仍然能通过键值编码设置这些属性值setValue:forKey。不要在返回的对象上查询类型以确定其是否可变，不易从底层直接修改对象中的数据。尽量创建不可变对象。若某属性仅可于对象内部修改，则在分类中将其由readonly属性扩展为readwrite属性。不要把可变的collection作为属性公开，而应提供相关方法以此修改对象中的可变collection。

19 使用清晰而协调的命名方式

总结：驼峰式大小写命名法：方法和变量名，以小写字母开头，其后每个单词首字母大写。 如果方法的返回值是新创建的，那么方法名的首个词应是返回值的类型，除非前面还有修饰语，属性的存取方法不遵循这种命名方式，因为一般认为这些方法不会创建新对象，即使返回拷贝对象。方法名里不要使用缩略后的类型名称。

20 为私有方法名加前缀

总结：私有方法只在实现的时候声明。OC没有办法将方法标为私有，苹果用一个下划线作为私有方法的前缀。不能将方法限定于某个范围内，也许是OC的缺点，然后作为动态方法派发系统这个强大组件的一部分，次特性也带来了诸多好处。

21 理解OC错误模型

总结：OC对异常的处理方法是，只有在极罕见的情况下抛出异常，异常抛出之后无须考虑恢复问题，而且应用程序此时也应该退出。也就是说，不用再编写复杂的异常安全代码了。在出现不那么严重的错误时，令方法返回nil/0，或是使用NSError，以表明其中有错误发生。NSError的用法更加灵活，因为可以由此对象将错误的原因报告给调用者。两种用法，有错误发生时，当前对象会把错误信息经由协议中的某个方法传递给其委托对象- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error；或者经由方法的输出参数，返回给调用者- (BOOL)doSomething:(NSError * __autoreleasing*)error;此方法不仅能有普通的返回值，而且还能经由“输出参数”把NSError对象回传给调用者。

NSError *error = nil;

BOOL ret = [object doSomething:&error];表示该操作是成功了还是失败了

if(error){具体错误信息

}

*error = [NSError errorWithDomain:domain code:code userInfo:userInfo];

*error为error参数解引用，就是说error所指的那个指针现在要指向一个新的NSError对象了。在解引用之前必须先保证error参数不是nil，因为空指针解引用会导致“段错误”并使应用程序崩溃。调用者在不关心具体错误时，会给error参数传入Nil。

22 理解NSCopying协议

总结：没有专门深拷贝的协议，所以其具体执行方式由每个类来确定。我们只需决定自己所写的类是否要提供深拷贝方法即可。若想令自己缩写的对象具有拷贝功能，则需实现NSCopying协议。如果自定义的对象分为可变版本与不可变版本，那么就要同时实现NSCopying与NSMutableCopying协议。复制对象时需决定采用浅拷贝还是深拷贝，一般情况下应该尽量执行浅拷贝。如果你所写的对象需要深拷贝，那么可考虑新增 一个专门执行深拷贝的方法。

{

//    //非容器类对象 对于不可变对象的copy是浅复制，对于不可变对象的mutablecopy是深复制

NSString *string = @"origion";

NSString *stringCopy = [string copy];//得到的是不可变的拷贝

NSMutableString *mstringCopy = [string copy];//浅拷贝

NSMutableString *stringMCopy = [string mutableCopy];

NSMutableString *c = (NSMutableString *)string;//其实还是不可变的

//    //非容器类，对于可变对象的copy和mutablecopy都是深拷贝，但是copy返回的对象是不可变的

NSMutableString *string = [NSMutableString stringWithString: @"origion"];

NSString *stringCopy = [string copy];

NSMutableString *mstringCopy = [string copy];

NSMutableString *stringMCopy = [string mutableCopy];

NSLog(@"");

//    //系统容器类

//copy返回不可变对象，mutablecopy返回可变对象

NSArray *array = [NSArray arrayWithObjects:@"a",@"b",@"c",nil];

NSArray *arrayCopy1 = [array copy];//是和array同一个NSArray对象

//以上两个是指针复制

NSMutableArray *mArrayCopy1 = [array mutableCopy];//这个是对象复制，可以改变其内的元素，删除或添加，但，容器内的元素内容都是指针复制。

NSArray *mArray1 = [NSArray arrayWithObjects:[NSMutableString stringWithString:@"a"],@"b",@"c",nil];

NSArray *mArrayCopy2 = [mArray1 copy];

NSMutableArray *mArrayCopy1 = [mArray1 mutableCopy];

NSArray *deepCopyArray = [[NSArray alloc]initWithArray:mArray1 copyItems:YES];//也并不是真正意义上的深拷贝，对于其中可变元素是深拷贝，对于其中不可变元素还是指针复制，但官方文档已经将这个方法列为deepcopy，并添加了copy和mutablity的关系说明

NSArray *trueDeepCopyArray = [NSKeyedUnarchiver unarchiveObjectWithData:[NSKeyedArchiver archivedDataWithRootObject:mArray1]];//真正意义上的深拷贝

}