读“编写高质量iOS与OSX代码的52个有效方法”笔记(02)

接口与API设计

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

OC没有其他语言那种内置的命名空间。所以我们起名时要避免潜在的命名冲突,否则就容易重名,而引发命名冲突(naming clash)。Apple宣称其保留使用所有“两字母前缀”,所以我们一般还是三个字母开头比较好,选择与我们自己的公司、应用程序或二者皆有关联之名作为类名的前缀。

第16条:提供“全能初始化方法”

为对象提供必要信息以便其完成工作的初始化方法叫做“全能初始化方法”,也可以称为“指定初始化方法”。

例如UITableViewCell中的初始化

- (instancetype)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(nullable NSString *)reuseIdentifier `

再看看 UISegmentedControlUINavigationItem的初始化,就董了。

第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条:通过委托和数据源协议进行对象间通信

简单的说,就是多用代理进行数据传递。可以参照UITableViewdelegatedata source进行处理,当然也可以直接写一个Protocol进行例如String进行传递。

第24条:将类的实现代码分散到便于管理的数个分类中

这个就是我们需要有分类的思想,通过分类机制,可以把类代码中分成很多歌易于管理的小块,便于单独检查。

第25条:总是为第三方类的分类名称增加前缀

这个同理第15条,在我们向第三方类中添加分类时,总应给其名称和其中的方法加上你专有的前缀,达到易于区分,避免错误的目的。

第26条:勿在分类中申明属性

因为除了”Class-continuation分类“,其他分类无法向类中新增实例变量,这样就无法把实现属性所需要的实例变量合成出来。

无法生成的实例变量
第27条:使用”Class-continuation分类“隐藏细节

Class-continuation分类和普通的分类不同,它必须定义在其所接续的那个类的实现文件里。其重要之处,这是唯一能声明。一般我们单独建立一个自定义的ViewNSObject类中我们就常用到。

#import "TestPeople.h"

@interface TestPeople ()
// 写你所需要的私有变量或方法
@end

@implementation TestPeople
// 实现
@end
第28条:通过协议提供匿名对象

我们可以用协议把自己所写的API之中的实现细节隐藏起来,将返回的对象设计为遵从此协议的纯id类型。这样的话,想要隐藏的类名就不会出现在API之中啦。
因为有时候接口的背后有多个不同的实现类,而你又不想指明具体使用的类,那么就要考虑这个方法啦。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容