OC没有其他语言那种内置的命名空间机制。因此,我们在起名时要设法避免潜在的命名冲突,否则很容易就重名了。若是发生重名冲突,那么应用程序相应的链接过程就会出错。例如:
错误原因在于,应用程序中的两段代码都各自实现了名为EOCTheClass的类,会导致该类所对应的类符号和“元类”符号各定义了两次。
你可能是把两个相互独立的程序库都导入到当前项目,而它们又恰好有重名的类。
避免此问题的唯一办法就是变相实现命名空间:为所有名称都加上适当前缀。所选前缀可以是与公司、应用程序或二者皆有关联之名。
使用Cocoa创建应用程序时一定要注意,Apple宣称其保留使用所有“两字母前缀”的权利,所以你自己选用的前缀应该是三个字母的。
不仅是类名,应用程序中的所有名称都应加前缀。如果要为既有类新增“分类”,那么一定要给“分类”及“分类”中的方法加上前缀。开发者可能会忽视另外一个容易引起命名冲突的地方,那就是类的实现文件中所用的纯C函数及全局变量,在编译好的目标文件中,这些名称是要算做“顶级符号”的。
并且每个类中相应的方法也应该有该类相应的前缀,用以分别该类和其他类中的名称相同的方法。这样做还有个好处就是:若此符号出现在栈回溯信息中,那么我们就很容易就能判断问题出现在那个类的哪个方法了。
如果用第三方库编写自己的代码,并准备将其在发布为程序库供他人开发应用程序所用,那么尤其要注意重复符号问题。你的程序库所包含的那个第三方库也许还会为应用程序本身所引入。这时应该给你所用的那一份第三方库代码都加上你自己的前缀。
要点:
所有对象均要初始化。以iOS的UI框架UIKit为例,其中有个类叫做UITableViewCell,初始化该类对象时,需要指明其样式及标识符,标识符能够区分不同类型的单元格。我们把这种可为对象提供必要信息以便其能完成工作的初始化方法叫做“全能初始化方法”。
如果创建类实例的方法不止一种,那么这个类就会有多个初始化方法。这当然很好,不过仍然要在其中选定一个作为全能初始化方法,令其他初始化方法都来调用它。NSDate就是个例子,其初始化方法如下:
- (id)init
- (id)initWithString: (NSString *)string
- (id)initWithTimeIntervalSinceNow: (NSTimeInterval)seconds
- (id)initWithTimeInterval: (NSTimeInterval)seconds sinceDate: (NSDate *)refDate
- (id)initWithTimeIntervalSinceReferenceDate: (NSTimeInterval)seconds
- (id)initWithTimeIntervalSince1970: (NSTimeInterval)seconds
在上面几个初始化方法中,“initWithTimeIntervalSinceReferenceDate:”是全能初始化方法。也就是说,其余的初始化方法都要调用它。于是,只有在全能初始化方法中,才会存储内部数据。而当底层数据存储机制改变时,只需修改此方法的代码就好,就无须改动其他初始化方法。
比如说,我们要编写一个表示矩形的类。其接口可以这样写:
#import <Foundation/Foundation.h>
@interface EOCRectangle : NSObject
@property (nonatomic, assign, readonly) float width;
@property (nonatomic, assign, readonly) float height;
@end
我们把属性声明为只读。不过这样一来,外界就无法设置Rectangle对象的属性了。开发者可能会提供初始化方法以设置这两个属性:
- (id)initWithWidth:(float)width andHeight:(float)height {
if ((self = [super init])) {
_width = width;
_height = height;
}
return self;
}
那如果我们用[[EOCRectangle alloc] init]来创建矩形会如何呢?这么做时合乎规则的,因为EOCRectangle的超类NSObject实现了这个名为init的方法,调用完该方法后,全部实例变量都将设为0。
如果我们想要用该方法初始化之后的矩形是一个默认的宽度与高度值,或是抛出异常,指明本类实例必须用“全能初始化方法”来初始化。我们要重新覆写init方法:
//Using default values
- (id)init {
return [self initWithWidth:5.0 fandHeight:10.0f];
}
//Throwing an exception
- (id)init {
@throw [NSException exceptionWithName:NSInternalInconsistencyException reason:@"Must use initWithWidth:andHeight: instead." userInfo:nil];
}
我们设置默认值的那个init方法调用了全能初始化方法
然后我们现在创建一个EOCSquare类(本类表示正方形),令其成为EOCRectangle的子类。新类的初始化方法应该如下编写:
#import "EOCRectangle.h"
@interface EOCSquare : EOCRectangle
- (id)initWithDimension:(float)dimension;
@end
@implementation EOCSquare
- (id)initWithDimension:(float)dimension {
return [super initWithWidth:dimension andHeight:dimension]
}
@end
上述方法就是EOCSquare类的全能初始化方法,而且它调用了超类的全能初始化方法。回过头看看EOCRectangle类的实现代码,你就会发现,那个类也调用了其超类的全能初始化方法。全能初始化方法的调用链一定要维系。然而,调用者可能会使用init方法或initWithWidth: andHeight:方法来初始化EOCSquare对象,这样子会创建出宽高不一致的正方形。
于是就产生了一个问题:如果子类的全能初始化方法与超类方法的名称不同,那么总应覆写超类的全能初始化方法,并在该方法调用该类的全能初始化方法。
在上方的例子中就应该像下面这样覆写EOCRectangle的全能初始化方法:
- (id) initWithWidth: (float)width andHeight: (float)height {
float dimension = MAX(width, height);
return [self initWithDimension:dimension];
}
覆写了这个方法后,即便使用init来初始化EOCSquare对象,也能照常工作。原因在于,EOCRectangle类覆写了init方法,并以默认值为参数调用了该类的全能初始化方法。
有时候我们不想覆写超类的全能初始化方法,常用的办法是覆写超类的全能初始化方法并于其中抛出异常:
- (id) initWithWidth:(float)width andHeight:(float)height {
@throw [NSException exceptionWithName:NSInternalInconsistancyException reason:@"Must use initWithDimension: instead." userInfo:nil];
}
这时候在EOCRectangle与EOCSquare这个例子中,调用init方法也会抛出异常,因为init方法也得调用“initWithWidth:andHeight:”。此时可以覆写init方法,并在其中以合理的默认值来调用initWithDimension:方法:
- (id) init {
return [self initWithDimension:5.0f];
}
有时候可能需要编写多个全能初始化方法。比如说:如果某对象的实例有两种完全不同的创建方法,必须分开处理。以NSCoding 协议为例,此协议提供了“序列化机制”,对象可依此指明其自身的编码及解码方式。NSCoding协议定义了下面这个初始化方法,遵从该协议者都应实现此方法:
- (id) initWithCoder:(NSCoder *)decoder;
我们在实现此方法时一般不调用平常所使用的那个全能初始化方法,因为该方法要通过“解码器”将对象数据解压缩,所以和普通的初始化方法不同。而且,如果超类也实现了NSCoding,那么还需要调用超类的initWithCoder:方法。于是,子类中有不止一个初始化方法调用了超类的初始化方法,因此,严格的说,在这种情况下出现了两个全能初始化方法。
#import <Foundation/Foundation.h>
@interface EOCRectangle : NSObject<NSCoding>
@property (nonatomic, assign, readonly) float width;
@property (nonatomic, assign, readonly) float height;
- (id)initWithWidth:(float)width andHeight:(float)height;
@end
@implementation EOCRectangle
//Designated initializer
- (id)initWithWidth:(float)width andHeight:(float)height {
if ((self = [super init])) {
_width = width;
_height = height;
}
return self;
}
//Superclass's designated initializer
- (id)init {
return [self initWithWidth:5.0f andHeight:10.0f];
}
//Initializer from NSCoding
- (id) initWithCoder:(NSCoder *)decoder {
//Call through to super's designated initializer
if ((self = [super init])) {
_width = [decoder decodeFloatForKey:@"width"];
_height = [decoder decodeFloatForKey:@"height"];
}
return self;
}
@end
NSCoding协议的初始化方法没有调用本类的全能初始化方法,而是调用了超类的相关方法。然而,若超类也实现了NSCoding,则需改为调用超类的initWithCoder.初始化方法,例如,在此情况下,EOCSquare类就得这么写:
#import "EOCRectangle.h"
@interface EOCSquare : EOCRectangle
- (id)initWithDimension:(float)dimension;
@end
@implementation EOCSquare
//Designated initializer
- (id) initWithDimension:(float)dimension {
return [super initWithWidth:dimension andHeight:dimension];
}
//Superclass designated initializer
- (id) initWithWidth:(float)width andHeight:(float)height {
float dimension = MAX(width, height);
return [self initWithDimension:dimension];
}
//NSCoding designated initialzer
- (id) initWithCoder:(NSCoder *)decoder {
if ((self = [super initWithCoder:decoder])) {
//EOCSquare's specific initalizer
}
return self;
}
@end
每个子类的全能初始化方法都应该调用其超类的对应方法,并逐层向上,实现initWithCoder:时也要这样,应该先调用超类的相关方法,然后在执行与本类有关的任务。这样编写出来的EOCSquare 类就完全遵守NSCoding协议了。
要点:
调试程序时,需要打印并查看对象信息。一种办法是编写代码把对象的全部属性都输出到日志中。不过最常见的做法还是像下面这样:
NSLog(@"object = %@", object);
在构建需要打印到日志的字符串时,object对象会收到description消息,该方法所返回的描述信息将取代“格式字符串”里的%@。比方说,object是个数组,若用下列代码打印其信息:
NSArray *object = @[@"A string", @(123)];
NSLog(@"object = %@", object);
则会输出
object = {
"A string"
123
}
然而,在自定义的类上这么做,那么输出的信息却是下面这样:
object = <EOCPerson: 0x7fd9a1600600>
但是可以看到,这种方法只是打印了类名和对象的内存地址。如果我们想要打印更多的信息。我们只需要覆写description 方法并将描述此对象的字符串返回即可,否则打印信息时就会调用NSObject类所实现的默认方法。例如,有下面这个 代表个人信息的类
#import <Foundation/Foundation.h>
@interface EOCPerson : NSObject
@property (nonatomic, copy, readonly) NSString *firstName;
@property (nonatomic, copy, readonly) NSString *lastName;
- (id)initWithFirstName:(NSString *)firstName lastName:(NSString *)lastName;
@end
@implementation EOCPerson
- (id)initWithFirstName:(NSString *)firstName lastName:(NSString *)lastName {
if ((self = [super init])) {
_firstName = [firstName copy];
_lastName = [lastName copy];
}
return self;
}
@end
该类的description方法通常可以这样实现:
- (NSString *) description {
return [NSString stringWithFormat:@"<%@: %p, \"%@ %@\">", [self class], self, _firstName, _lastName];
}
如果按照上方的代码的话,那么EOCPerson对像的输出结果就会如下:
EOCPerson *person = [[EOCPerson alloc] initWithFirstName:@"Bob" lastName:@"Smith"];
NSLog(@"person = %@", person);
//Output
//person =
有个简单的办法,可以在description中输出很多互不相同的信息,那就是借助NSDictioniary类的description方法。此方法输出的信息的格式如下:
{
key: value;
foo: bar;
}
自定义的description方法中,把待打印的信息放到字典里面,然后将字典对象的description方法所输出的内容包含在字符串里并返回,例如:下面这个类表示某地点的名称和地理坐标(纬度与经度):
#import <Foundation/Foundation.h>
@interface EOCLocation : NSObject
@property (nonatomic, copy, readonly) NSString *title;
@property (nonatomic, assign, readonly) float latitude;
@property (nonatomic, assign, readonly) float longitude;
- (id)initWithTitle:(NSString *)title latitude:(float)latitude longitude:(float)longitude;
@end
@imiplementation EOCLocation
- (id)initWithTitle:(NSString *) title latitude:(float) latitude longitude:(float)longitude {
if ((self = [super init])) {
_title = [title copy];
_latitude = latitude;
_longitude = longitude;
}
return self;
}
@end
如果这个类的的description方法能够打印出地名和经纬度就好了。所以我们就可以像下面这样编写description方法,用NSDictionary来实现此功能:
- (NSString *) description {
return [NSString stringWithFormat:@"<%@: %p, %@>",
[self class],
self,
@{@"latitude":_title,
@"latitude":@(_latitude),
@"longitude":@(_longitude)}
];
}
输出的信息格式为:
location = <EOCLocation: 0x7f98f2e01d20, {
latitude = "51.506"
longitude = 0;
title = London;
}>
用NSDictionary来实现该功能可以令代码更容易维护:如果以后还要向类中新增属性,并且要在description方法中打印,那么只需要修改字典内容即可
debugDescription一种描述方法,和description差不多,就是描述的位置不一样,description是在函数调用类的时候触发方法才输出的,而debugDescription是在控制台中使用命令打印该对象时才调用的。当然加断点查看时也可以看到debugDescription的描述。
如果你在description不想将一些内容输出的话,你就可以将那些数据写在debugDescription中,让程序员自己调试时可以方便的看到这些数据,而description方法就输出你想要让用户看到的信息就行了。
要点:
默认情况下,属性是“既可读又可写的”,这样创建出来的类都是可变的。但是在设计类的时候,我们应充分运用属性来封装数据,在使用属性时,则可将器声明为“只读”。
一般情况下,我们要建模的数据未必都需要改变。比如说,我们从服务器中请求来的数据加载成UI显示在屏幕上,这些数据一般都是不需要去改变的。因此,我们尽量要减少对象中的可变内容。
具体到编程中,则应该尽量把对外公布出来的属性设为只读,而且只在确有必要时才将属性对外公布。
为了将某类做成不可变的类,需要把所有属性都声明为readonly:
例如
#import <Foundation/Foundation.h>
@interface EOCPointOfInterest: NSObject
@property (nonatomic, copy,readonly) NSString *identifier;
@property (nonatomic, copy, readonly) NSString *title;
@property (nonatomic, assign, readonly) float latitude;
@property (nonatomic, assign, readonly) float longitude;
@end
如果有人试着改变属性值,那么编译的时候就会报错。对象汇总给你的属性值可以读出,但是无法写入,开发者在使用对象时就能肯定其底层数据不会改变。
既然这些属性都没有设置方法(setter),那为何还要指定内存管理语义呢,如果不指定,采用默认的语义也可以:
@property (nonatomic, readonly)NSString *identifier;
@property (nonatomic, readonly) NSString *title;
@property (nonatomic, readonly) float latitude;
@property (nonatomic, readonly) float longitude;
我们还是应该在文档里指明实现所用的内存管理语义,这样的话在以后想把它变为可读写的属性时就会简单一些。
有时候肯想修改封装在对象内部的数据,但是却不想令这些数据被外人所改动。通常的做法就是在对象内部将readonly属性重新声明为readwrite。将属性重新声明为readwrite这一操作可于“分类”中完成,在公共接口中声明的属性可于此处重新声明,属性的其他特质必须保持不变就行,而readonly可以扩展为readwrite。
例如上方的例子,在其所声明类的分类中,可以写成下方的样子:
#import"EOCPointOfInterest.h"
@interface EOCPointOfInterest()
@property (nonatomic, copy, readwrite)NSString* identifier;
@property (nonatomic, copy,readwrite) NSString* title;
@property (nonatomic, assign, readwrite) float latitude; eproperty (nonatomic, assign, readwrite)float longitude;
@end
@implementation EOCPointOfInterest
end
现在,只能于其属性所在类的实现代码内部设置这些属性了,其实更准确的说,在对象外部,仍然能通过**“键值编码”(KVC)**技术设置这些属性值,比如说,可以像下面这样修改属性值:
[pointOfInterest setValue:@"abc" forKey:@"identifier"];
这样子可以改动属性值,因为KVC会在类里查找“setIdentifier:”方法,并借此修改此属性。即使没有于公共接口中公布此方法,它也依然包含在类中。
要点:
一开始学习的人通常会觉得OC的语言很繁琐,因为其语法结构使得代码读起来和句子一样。以下方代码为例:
NSString *text = @"The quick brown fox jumped over the lazy dog";
NSString *newText = [text stringByReplacingOccurrencesOfString:@"fox" withString:@"cat"];
这个句子虽然繁长,但是准确描述了开发者想做的事。
下面介绍一种命名方式:
驼峰命名法:
方法和变量名的首个单词的首个字母小写,然后后面的每个单词的首字母大写。类名也用驼峰命名法,另外,类名一般还有三个前缀字母。
方法命名
给方法命名时的注意事项可总结成下面几条规则:
类和协议的命名
其中最重要的一点就是,命名方式应该协调一致。如果要从其他框架中继承子类,那么务必遵循其命名惯例。比方说,要从UIView类中继承自定义的子类,那么类名末尾的词必须是View。同理,若要创建自定义的委托协议,则其名称中应该包含委托发起方的名称,后面再跟上Delegate一词。
要点:
编写类的实现代码时,经常需要写一些只在内部使用的方法。应该为这种方法的名称加上某些前缀,这有助于调试因为据此很容易能把公共方法和私有方法区别开。
一般用p_作为前缀,p表示“private”(私有的),下划线后面的部分按照常用的驼峰命名即可,其首字母要小写。例如,包含私有方法的EOCObject类可以这样写:
- (void) p_privateMethod {
/* ... */
}
与公共方法不同,私有方法不出现在接口定义中。有时可能要在“分类”里声明私有方法,然而最近修订的编译器已经不要求在使用方法前必须先行声明了。所以说,私有方法一般只在实现的时候声明。
苹果公司喜欢单用一个下划线做私有方法的前缀。所以开发者当避免这样使用前缀,因为你有可能会无意间覆写父类的同名方法。
要点:
很多编程语言都有“异常”机制,通过异常机制来处理错误,当然OC中也有。
首先我们要注意的是,“自动引用计数”在默认情况下不是“异常安全的”,就是说,如果抛出异常,那么本应该在作用域末尾释放的对象现在却不会释放了,这样就会造成内存泄漏问题,如果想生成“异常安全”的代码,可以通过设置编译器的标志来实现,不过这将引入一些额外的代码,在不抛出异常时,也照样要执行这部分代码。需要打开的编译器标志叫做-fobjc-arc-exceptions。
OC语言现在所采用的办法是:只在极其罕见的情况下抛出异常,异常抛出之后,无须考虑恢复问题,而且应用程序此时也应该退出。这就是说,不用再编写复杂的“异常安全”代码了。
异常只应该用于极其严重的错误,比如说,你编写了某个抽象基类,它的正确用法是先从中继承一个子类,然后使用这个子类。这种情况下,如果有人直接使用了这个抽象类,那么就可以考虑抛出异常
- (void) mustOverrideMethod {
NSString *reason = [NSString stringWithFormat: @"%@ must be oberridden", NSStringFormSelector(_cmd)];
@throw [NSException exceptionWithName:NSInterNalInconsistencyException reason:reason userInfo:nil];
}
既然异常只用于处理严重错误,那么对其他错误怎么办?在出现“不那么严重的错误”时,OC语言所用的编程范式为:令方法返回nil/0,或是使用NSError,以表明其中有错误发生。
比如说,如果初始化方法无法根据传入的参数来初始化当前实例,那么就可以令其返回nil/0:
- (id)initWithValue:(id)value {
if ((self = [super init])) {
if (/* Value means instance can't bo created */) {
self = nil;
} elsef {
//Initialize instance
}
}
return self;
}
这样一来,如果if语句发现无法用传入的参数值来初始化当前实例,就会把self设置成nil,整个方法的返回值也就是nil了,调用者发现初始化方法并没有把实例创建好,于是便可确定其中发生了错误。
NSError的用法更加灵活,我们可以经由此对象,把导致错误的原因回报给调用者。NSError对象里封装了三条信息:
在设计API时,NSError的第一种常见用法时通过委托协议来传递此错误。有错误发生时,当前对象会把错误信息经由协议中的某个方法传给其委托对象。
NSError的另一种常见的用法是:经由方法的“输出参数”返回给调用者。
就是说用一个方法来判断你传过去的error是否真的有错误,返回Boolean值,之后你就可以根据error是否有内容,或者Boolean值来决定处理的代码和不处理的代码。就像这样:
NSError error =nil;
BOOL ret =[object doSomething:&error];
if (error){
// There was an error
}
doSomething:会处理一些事,并且还会将出错的问题返回给error指针传回给调用者,并且还会返回一个Boolean值给ret。
NSError对象里的“错误范围”、“错误码”、“用户信息”等部分应该按照具体的错误情况填入适当的内容。这样的话,调用者就可以根据错误的类型分别处理各种错误了。错误范围应该定义成NSString型的全局变量,而错误码则定义成枚举类型为佳。
//EOCErrors.h
extern NSString *const EOCErrorDomain;
typedef NS_ENUM(NSUInterger, EOCError) {
EOCErrorUnknown = -1
EOCErrorInternalInconsistency = 100
EOCErrorGeneralFault = 105;
EOCErrorBadInput = 500;
}
//EOCErrors.m
NSString *const EOCErrorDomain = @"EOCErrorDomain";
要点:
我们经常会使用copy函数,但是若是你自定义的类,他自己就不会实现这个函数,此时就需要你自己来实现了,要实现copy函数就的实现NSCopying协议,该协议只有一个方法:
- (id)copyWithZone:(NSZone *)zone;
copy方法由NSObject实现,该方法只是以“默认区”为参数来调用“copyWithZone:”。所以要实现copy函数,他才是关键。
想要重写copy函数,要声明该类遵从NSCopying协议,并实现其中的方法
#import <Foundation/Foundation.h>
@interface EOCPerson : NSObject <NSCopying>
@property (nonatomic, copy, readonly) NSString *firstName;
@property (nonatomic, copy, readonly) NSString *lastName;
- (id) initwithFirstName: (NSString*)firstName andLastName: (NSString*) lastName;
@end
实现协议中规定的方法:
- (id) copyWithZone: (NSZone*)zone {
EOCPerson *copy = [[[self class] allocWithZone: zone] initwithFirstName: firstName andLastName: lastName];
return copy;
}
mutableCopy方法,此方法来自另一个叫做NSMutableCopying的协议。该协议与NSCopying类似,也只定义了一个方法,然而方法名不同:
(id)mutableCopyWithZone:(NSZone*)zone
在编写拷贝方法时,还要决定一个问题,就是应该执行“深拷贝”(deep copy)还是“浅拷贝”(shallow copy)。深拷贝的意思就是:在拷贝对象自身时,将其底层数据也一并复制过去。Foundation框架中的所有collection类在默认情况下都执行浅拷贝,也就是说,只拷贝容器对象本身,而不复制其中数据。这样做的主要原因在于,容器内的对象未必都能拷贝,而且调用者也未必想在拷贝容器时一并拷贝其中的每个对象。
图3-2描述了深拷贝与浅拷贝的区别
一般情况下,在自定义的类中以浅拷贝的方式实“copyWithZone:”方法。但如果有必要的话,也可以增加一个执行深拷贝的方法。以NSSet为例,该类提供了下面这个初始化方法,用以执行深拷贝:
-(id) deepCopy {
EOCPerson *copy =[[[self class] alloc]initWithFirstName:_firstNameandLastName:_lastName];
copy->_friends=[[NSMutableSet alloc] initWithSet:_friendscopyItems:YES];
return copy;
}
-(id) initWithSet:(NSArray*)array copyItems:(BOOL) copyItems
若copyItem参数设为 YES,则该方法会向数组中的每个元素发送copy消息,用拷贝好的元素创建新的set,并将其返回给调用者。
要点: