《编写高质量iOS与OS X代码的52个有效方法》14-21

第14条:理解“类对象”的用意

  1. 方法签名:概念需要弄清楚

  2. Class.png

    super_class指针确立了继承关系,而isa指针描述了实例所属的类。

  3. 描述OC对象所使用的数据结构定义:typedef struct objc_object {Class is;} *id
    Class对象的定义:

    Class对象结构.png
  4. 对象比较.png

三个分支都走进去了,由此可见类对象是“单例”(singleton),在应用程序范围内,每个类的Class仅有一个实例。

要点:

  • 在每个实例都有一个指向Class对象的指针,用以表明其类型,而这些Class对象则构成了类的继承体系(如2)。
  • 如果对象类型无法在编译期确定,那么就应该使用类型信息查询方法来探知。
  • 尽量使用类型信息查询方法来确定对象类型,而不要直接比较类对象,因为某些对象可能实现了消息转发功能,比如“代理”(proxy)。

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

1、Objective-C没有其他语言那种内置的命名空间(namespace)机制,所以就很容易出现重名。
2、Apple 宣称其保留使用所有“两字母前缀”的权利,所以你自己选用的前缀最好是三个字母的。
3、在类的实现文件中所用的纯C函数及全局变量,这个问题必须注意。在编译好的目标文件中(.o),这些名称是要算作“顶级符号”的,顶级符号很容易导致重名,需要加前缀。

要点:

  • 选择与你的公司、应用程序或二者皆有关联之名称作为类名的前缀,并在所有代码中均适用这一前缀。
  • 若自己所开发的程序中用到了第三方库,则应为其中的名称加上前缀。这是为了不和引用自己程序的项目(同时引入同一个第三方)出现第三方库冲突的问题,最好加前缀

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

1、什么是全能初始化方法? 全能初始化方法就是指的在一个类中,可能有很多初始化方法,例如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;

在这些初始化方法里面- (id)initWithTimeinterValSinceReferenceDate:(NSTimeInterval)seconds;就是全能初始化方法,也就是说其他初始化函数都要调用它初始化。只有在全能初始化方法中才能存储内部数据。这样的话,当底层数据存储机制改变时,只需修改此方法的代码就好了,无需改动其他初始化方法。

要点:

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

第17条:实现 description 方法

对于已经熟悉 iOS 开发的程序员来说,这是debug必备的技能。只需要在自定义的类中覆写- (NSString *)description函数即可,这个函数在事在你调用NSLog的时候输出的。与此相似的还有一个函数- (NSString *)debugDescription,这个函数是在调试器中使用命令的方式输出的,其命令格式po +输出对象,例如po person。需要注意的是,要在调试器中使用命令的方式输出需要打断点,使程序停在断点处,然后在调试器中使用命令。

要点:

  • 实现description方法返回一个有意义的字符串,用以描述该实例。
  • 若想在调试时打印出更详尽的对象描述信息,则应实现debugDescription方法。

第18条:尽量使用不可变对象

  1. 只读属性也可以通过“键值变化”(Key-Value Coding,KVC)技术设置这些属性值。
  2. 什么是不可变对象?
    在使用属性时,将其声明为“只读”(read-only)。默认情况下,属性是 “即可读又可写的”(read-write),这样设计出来的类是可变的。
  3. 为什么要使用不可变对象?
    把可变对象(mutable object)放入collection(NSSet,NSArray,NSDictionary以及其子类)之后又修改其内容,那么很容易就会破坏set(集合)的内部数据结构,使其失去固有的语义。
  4. 怎么使用?
    若某属性仅可于对象内部修改,则在“class-continuation分类”中将其由readonly属性扩展为readwrite。不要把可变的collection对象作为属性公开,而应提供相关方法(增删改),以此修改对象中的可变collection。

要点:

  • 尽量创建不可变的对象。
  • 若某属性仅可于对象内部修改,则在“class-continue 分类”中将其由readonly属性扩展为readwrite。
  • 不要把可变的collection对象作为属性公开,而应提供相关方法(增删改),以此修改对象中的可变collection。

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

  1. 方法命名
  • 如果方法的返回值是新建的,那么方法名的首个词应是返回值的类型,除非前面还有修饰语,例如localizedString。属性的存取方法不遵循这种命名方法,因为一般认为这些方法不会创建新的对象,即便有时返回内部对象的一份拷贝,我们也认为那相当于原有的对象。这些存取方法应该按照其所对应的属性来命名。
  • 应该把表示参数类型的名词放在参数前面。
  • 如果方法要在当前对象上执行操作,那么就应该包含动词;若执行操作时还需要参数,则应该在动词后面加上一个或多个名词。
  • 不要使用str这种简称,应该使用string这样的全称。
  • Boolean属性应该加is前缀。如果某方法返回非属性的Boolean值,那么应该根据其功能,选用has或is当前缀。
  • 将get这个前缀留给那些借由“输出参数”来保存返回值的方法,比如说,把返回值填充到“C语言式数组”里的那种方法就可以使用这个词做前缀。
  1. 类与协议的命名,应该为类与协议的名称加上前缀,以避免命名空间冲突(参加第15条)

要点:

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

第20条:为私有方法名加前缀

苹果只出现在实现文件(.m文件)中的函数可以看成是私有方法,私有方法建议以以下格式命名:

- (void)p_privateMethod()

要点:

  • 给私有方法的名称加上前缀,这样就可以很容易地将其公共方法区分开。
  • 不要单用一个下划线(_)做私有方法的前缀,因为这种做法是预留给苹果公司自己用的。

第21条:理解Objective-C错误类型

  1. 在Objective-C里面我们可以使用NSError来描述错误,NSError对象封装了三条信息:
  • Error domain(错误范围,其类型为字符串,应该定义成NSString型的全局常量)错误发生的范围。也就是产生错误的根源,通常用一个特有的全局变量来定义。比方说,“处理URL的子系统” 在从URL中解析或取得数据时如果出错了,那么就会用NSURLErrorDomain来表示错误范围。
  • Error code(错误码,其类型为整数,应该定义成枚举)独有的错误代码,用以指明在某个范围内具体发生了何种错误。某个特定范围内可能会发生一系列相关错误,这些错误情况通常采用enum来定义。例如,当HTTP请求出错时,可能会把HTTP状态码设为错误码。
  • User info(用户信息,其类型为字典)有关此错误的额外信息,其中或许包含了一段“本地化的描述”(localized description),或许还含有导致该错误发生的另外一个错误,经由此种信息,可将相关错误穿成一条“错误链”。
  1. NSError的常见用法
  • 通过委托协议来传递此错误。例如:
    -(void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error

  • 经由方法的 “输出参数” 返回给调用者。例如:-(BOOL)doSomething:(NSError **)error,传递给方法的参数是一个指针,而该指针本身又指向另一个指针,那个指针指向NSError对象。或者也可以把它当成一个直接指向NSError对象的指针。这样来一来,此方法不仅能有普通的返回值,而且还能经由“输出对象”把NSError对象回传给调用者。其用法如下:

      typedef NS_ENUM(NSUInteger, EOCError) {
          EOCErrorUnknown = -1,
          EOCErrorInteralInconsistency = 100,
          EOCErrorGeneralFault = 105,
          EOCErrorBadInput = 500,
      };
    
      NSString *const EOCErrorDomain = @"EOCErrorDomain";
    
      - (BOOL)doSomething:(NSError **)error {
          // Do something that may cause an error
          if (/* there was an error*/) {
              if (error) {
                  NSDictionary *userInfo = @{};
                  // Pass the 'error' through the out-parameter
                  *error = [NSError errorWithDomain:EOCErrorDomain code:EOCErrorGeneralFault userInfo:userInfo];
              }
              return NO;////< Indicate failure
          } else {
              return YES;////< Indicate success
          }
      }
      NSError *error = nil;
      BOOL ret = [self doSomething:&error];
      if (error) {
         //There was an error
     }
    
  1. 异常@throw [NSException exceptionWithName:@“ExceptionName”reason:@“There was an error”userInfo:nil];
    要点:
  • 只有发生了可使整个应用程序崩溃的严重错误时,才应使用异常。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 211,948评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,371评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,490评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,521评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,627评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,842评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,997评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,741评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,203评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,534评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,673评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,339评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,955评论 3 313
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,770评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,000评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,394评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,562评论 2 349

推荐阅读更多精彩内容