《Effective Objective-C 2.0编写高质量i

作者: Mr_WangZz | 来源:发表于2019-01-28 09:26 被阅读0次

如果决定重用代码,那么我们在编写接口时,就会将其设计成易于复用的形式。这需要用到�Objective-C语言中常见的编程范式,同时还需要了解各种可能碰到的陷阱。

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

重名符号错误:duplicate symbol error

1). 选用的前缀应该是3个字母的,Apple保留了使用全部2个字母开头的权利。
如:

Apple: NSObject
项目中: WZZObject

2). 总是应该给C函数的命名也应加上前缀。如加上模块名、类名等。若出现问题,方便回溯。

要点总结:
  • 选择与你的公司、应用程序或二者都有关联的名称作为前缀,并在项目所有代码中使用这一前缀。
  • 若自己开发的应用程序用到了第三方库,则应为其中的名称加上前缀。

16. 提供 全能初始化方法

要点总结:
  • 在类中提供一个全能初始化方法,并与文档里指明。其它初始化方法均应调用此方法。
  • 若全能初始化方法 与超类不同,则应覆写超类中对应的方法。
  • 若超类的初始化方法不适用于子类,那么应该覆写这个超类中的方法,并抛出异常

17. 实现description

要想输出更为有用的信息,可以在定义的类中,覆写 description 方法,将描述此对象的字符串返回即可。

- (NSString *)description {
    
    return [NSString stringWithFormat:@"名字%@ _薪水%lu", self.name, (unsigned long)self.salary];
    
}

- (NSString *)debugDescription {
    return [NSString stringWithFormat:@"<%@: %p> 名字%@ _薪水%lu", [self class], self, self.name, (unsigned long)self.salary];
}

//输出:
NSLog: 名字Samara _薪水200
(lldb) po aEmployee
<EOCEmployeeDeveloper: 0x600000226640> 名字Samara _薪水200
要点总结:
  • 实现 description 方法返回一个有意义的字符串,来描述该实例。
  • 若想在调试时打印更详尽的信息,可以实现 debugDescription 方法。

18. 尽量使用不可变对象

//  EOCPerson.h

#import <Foundation/Foundation.h>

@interface EOCPerson : NSObject

@property (nonatomic, copy, readonly) NSString *firstName;

@property (nonatomic, copy, readonly) NSString *lastName;

@property (assign, readonly) NSUInteger age;

@property (nonatomic, strong, readonly) NSSet *friends;


- (id)initWithFirstName:(NSString *)firstName
               lastName:(NSString *)lastName;

@end




- (id)initWithFirstName:(NSString *)firstName
               lastName:(NSString *)lastName {

    if ((self = [super init])) {
        _firstName = firstName;
        _lastName = lastName;
    }
    return self;
}

/***********************/
//  EOCPerson.m

#import "EOCPerson.h"

@interface EOCPerson()

@property (nonatomic, copy, readwrite) NSString *firstName;

@property (nonatomic, copy, readwrite) NSString *lastName;

@end

@implementation EOCPerson {
    NSMutableSet *_mutableSet;
}

- (id)initWithFirstName:(NSString *)firstName
               lastName:(NSString *)lastName {

    if ((self = [super init])) {
        _firstName = firstName;
        _lastName = lastName;
        _mutableSet = [NSMutableSet new];
    }
    return self;
}

- (NSString *)firstName {
    return [_mutableSet copy];
}

- (void)addFriends:(NSSet *)objects {
    [_mutableSet addObject:objects];
}
- (void)removeFriends:(NSSet *)objects {
    if ([_mutableSet containsObject:objects]) {
        [_mutableSet removeObject:objects];
    }
}
@end
要点总结:
  • 尽量创建不可变的对象
  • 若某属性仅可用于对象内部修改,则在 “class-continuation分类” 中将由 readonly 改为 readwrite 属性。(见27条)
  • 不要把可变的collection作为属性公开,而应提供相应方法,以此来修改对象中的可变collection。

注意readonly 可以使用KVC(键值编码)修改这些值;
直接用类型信息查询功能查出属性所对应的实例变量在内存中的偏移量。

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

方法的命名规则总结

  • 如果 方法的返回值新创建的,那么方法的 首个单词 应该是返回值的类型,除非前面还有修饰语,例如 localizedString

    注意,属性的存取方法 不遵循 这种命名方式,因为一般认为这些方法不会创建新对象。即使有时返回内部对象的一份拷贝,我们也认为那相当于原有的对象。这些方法应该按照其所对应的属性来命名。

  • 应该把表示参数类型的名词放 参数 前面。

  • 如果方法要在当前对象上执行操作,那么就应该包含动词;若执行操作时还需要参数,则需要在动词后加入一个或多个名词。

  • 不要使用 str 这种简称,应该使用 string 这样的全称。

  • Boolean 属性应该加上 is 前缀,如果某方法返回非属性的 Boolean 值,应该根据其功能 采用 hasis

如:-(NSString *)hasPrefix:(NSString *)string;
  • get 这个前缀保留给那些借由 “输出参数” 来保存返回值的方法。

    把返回值填充到“C语言数组”(C-style array)里的那种方法就可以使用这个前缀。

要点总结:

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

20. 为私有方法名加上前缀

/** 公开方法 */
- (void)publicMethod {}
/** 私有方法 “p_”开头 */
- (void)p_privateMethod {}
要点总结:
  • 给(.m文件中的)私有方法加上前缀,这样可以很容易的将其同公共方法区分开。
  • 不要单用一个下划线( _ ) 作私有方法的前缀,因为这种方法是预留给苹果公司用的。

21. 理解Objective-C错误模型

/** 定义错误组件 */
//.h
//专用的“错误范围”字符串
extern NSString *const EOCErrorDomain;

//错误码
typedef NS_ENUM(NSUInteger, EOCErrorCode) {
    EOCErrorUnkown                  = -1,
    EOCErrorInternalInconsistency   = 100,
    EOCErrorGeneralFault            = 105,
    EOCErrorBadInput                = 500,
};

//.m
NSString *const EOCErrorDomain = @"EOCErrorDomain";

//例如
- (void)doSomething:(EOCError* *)error;
要点总结:
  • 只有发生了可使整个应用程序发生崩溃时,才应使用 异常 NSException。抛出异常如下
@throw [NSException exceptionWithName:@"Error" reason:@"can not init" userInfo:nil];
  • 在错误不那么严重的情况下,可以采用 “委托方法” (delegate method) 来处理错误,也可以把错误信息放在 NSError 对象里,经由 “输出参数” 反给回调者。

22. 理解 NSCopying 协议

要点总结

需求是:使用对象时经常需要拷贝它。

  • 若想令自己的所写对象具有拷贝功能,则需实现 NSCopying 协议。
//浅拷贝
- (id)copyWithZone:(NSZone *)zone {
    
    EOCPerson *copy = [[[self class] allocWithZone:zone] initWithFirstName:_firstName lastName:_lastName];
    copy->_mutableSet = [_friends mutableCopy];
    return copy;
}

  • 如果自定义的对象分为可变版本不可变版本,需要同时实现 NSCopyingNSMutableCopying 协议。
  • 复制对象时要采用浅拷贝还是深拷贝,一般情况下应该尽量执行浅拷贝
  • 如果你所写的对象需要执行深拷贝,那么考虑新增一个专门执行深拷贝的方法。
//执行深拷贝
- (id)deepCopy {
    
    EOCPerson *copy = [[[self class] alloc] initWithFirstName:_firstName lastName:_lastName];
    
    copy->_mutableSet = [[NSMutableSet alloc] initWithSet:_friends copyItems:YES];
    
    return copy;
}

系列文章

相关文章

网友评论

    本文标题:《Effective Objective-C 2.0编写高质量i

    本文链接:https://www.haomeiwen.com/subject/mhwojqtx.html