美文网首页iOS学习iOS菜鸟级开发
编写高质量的iOS代码(五)

编写高质量的iOS代码(五)

作者: Mustard_Buli | 来源:发表于2016-07-07 13:53 被阅读55次

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

    • 起名时应遵从标准的Objective-C命名规范,这样创建出来的接口更容易为开发者所理解。

    🌰:

    NSString *text = @"The quick brown fox jumped over the lazy dog";
    NSString *newText = [NSString stringByReplacingOccurrencesOfString:@"fox" with String:@"cat"];
    

    虽然只是一个简单的表达式,但是OC中却用一整句话来表达,这样做会让方法更明确、易读。并且方法与变量名使用了“驼峰式大小写命名法”(camel casing)。类名也用驼峰命名法,不过首字母要大写,通常还有两三个前缀字母。
    当然这只是一种习惯,不是硬性要求,也可以按照自己的风格来命名,不过用驼峰命名法更容易被其他Objective-C开发者所接受。

    • 方法名要言简意赅,从左至右读起来要像个日常用语中的句子才好。

    不要吝于使用长方法名,把方法名起得稍微长一点,可以保证能准确的传达出所执行的任务。当然,方法名也不能长的过分。
    NSString这个类就展示了一套良好的命名习惯,列举出几个方法:

    • + string
      工厂方法(factory method),用于创建新的字符串。方法名就清晰的描述了返回值的类型。
    • + stringWithString
      工厂方法,根据某个字符串创建出与之内容相同的新字符串(感觉和copy一样)。方法名第一个单词也指明了返回类型。
    • + localizedStringWithFormat:
      工厂方法,根据特定格式创建出新的“本地化字符串”(locallized string)。返回值类型是第二个单词(string),因为前面还有个修饰语(localized)用来描述其逻辑含义。
    • - lowercaseString
      把字符串的大写字母转为小写。这个方法不会修改字符串本身,而是创建一个新的字符串,返回值类型是第二个单词(string),前面是定语(lowercase)。
    • - intValue
      将字符串解析为int型。返回值是int。通常不会简写返回值的类型,比如string不简写为str,但是由于"Integer"的简写"int"本身就是类型名称,所以这么做就合理了。只有一个词的名字通常用来表示属性,所以后面加上了"Value"。
    • - length
      获取字符串长度。这个方法只有一个词,实际上length也是NSString的一个属性。
    • - lengthOfBytesUsingEncoding:
      若字符串是以给定的编码格式(ASCII、UTF8、UTF16等)来编码的,则返回其字符数组的长度。这个方法和上面的"length"类似,但是这个方法需要一个参数,所以紧跟着描述类型的名词(encoding)。
    • - getCharacters:range:
      获取字符串中给定范围内的字符。其他语言里的获取方法也许会以get开头,但是Objective-C中一般不这么做,但是此处是个例外。原因在于,调用方法时要在其首个参数中传入数组,而该方法所获取的字符正是要放到这个数组里面。
    • - hasPrefix:
      判断本字符串是否以另一个字符串开头。因为返回值是Boolean类型,所以为了读起来像个句子,这种方法的名称中通常包括has(“是否有”)一词。
    • - isEqualToString:
      判断两字符串是否相等。返回值是Boolean,为了便于述说,方法名用is开头。

    给方法命名时的注意事项可以总结成下面几条规则:

    • 如果方法的返回值是新创建的,那么方法名的首个词应该是返回值的类型,除非前面还有修饰语,例如上面的localizedString。需要注意,属性的存取方法不遵循这种命名方式,因为一般认为这些方法不会创建新的对象。

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

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

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

    • Boolean属性应加is前缀。如果某方法返回非属性的Boolean值,那么应该根据其功能,选用has或is当前缀。

    • 将get整个前缀留给那些借由“输出参数”来保存返回值的方法,比如说,把返回值填充到“C语言数组”里的那种方法就可以使用整个次做前缀。

    • 给方法起名时的第一要务就是确保其风格与你自己的代码所要继承的框架相符。

    • 最重要的一点就是,命名方式要协调一致。如果要从其他框架中集成子类,那么务必遵循其命名惯例。

    🌰:从UIView类中继承自定义的子类,那么类名末尾的词必须是View。同理,创建自己定义的delegate protocol,则其名称中应该包含委托发起方的名称,后面再跟上Delegate一词。


    为私有方法名加前缀

    • 这样的做法可以很容易地将其同公共方法区分开。

    编写类的实现代码的时候,经常会写一些只有在内部才使用的方法。在私有方法前加前缀可以更好的调试。还有一个原因就是这么做便于修改方法名或方法签名。不同于私有方法,类的公共API一般是不能够随意改动的。而私有方法有了前缀,就可以很容易的看出哪些可以随意修改,哪些不能。

    • 不要单用一个下划线做私有方法的前缀,因为这种做法是预留给苹果公司用的。

    具体用什么前缀根据自己的喜好来定,但是其中最好包含下划线和字母p(private)。


    理解Objective-C错误模型

    • 只有在发生了可使整个应用程序崩溃的严重错误时,才应使用异常。

    首先要注意,“自动引用计数”(ARC)在默认的情况下不是“异常安全的”(exception safe)。具体点,如果抛出异常,本应该在作用域末尾释放的对象现在却不会自动释放了。
    OC语言现在采用的办法就是:只在极其罕见的情况下抛出异常,异常抛出之后,无需考虑恢复问题,而且app此时也应该退出。

    • 在错误不那么严重的情况下,可以指派“委托方法”(delegate method)来处理错误,也可以把错误信息放在NSError对象里,经由“输出参数”返回给调用者。

    NSError的用法更灵活,因为我们可以通过它来将错误信息报出来,NSError里封装了三条信息:

    • Error domain(错误范围,类型为字符串)
      🌰,“处理URL的子系统”(URL-handling subsystem)在从URL中解析或取得数据时出错,就会只用NSURLErrorDomain来表示错误范围。
    • Error code(错误码,类型为整数)
      通常都是用枚举来定义,常见的就是HTTP请求的错误码。
    • User info(用户信息,类型为字典)
      错误的额外信息,其中有可能包含一段“本地化描述”(localized description),也有可能包含的是另外一个错误,经由此种信息,可以把相关的错误串成一条“错误链”(chain of errors)。

    而NSError一种最常见的用法就是写在delegate method中。

     - (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error;
    

    另一种常见的用法就是最为“输出参数”返回给调用者。

     - (BOOL)doSomething:(NSError **)error;
    

    理解NSCopying协议

    • 若想令自己所写的对象具有拷贝功能,则需要实现NSCopying协议。

    同时要实现NSCopying中唯一的一个方法:

     - (id)copyWithZone:(NSZone *)zone
    

    之所以存在NSZone是因为,在之前的开发中,会将内存分成不同的“区”(zone),但是对象只会创建在这个区里(allocWithZone)。但是现在不用了,每个程序只有一个区:“默认区”(default zone),也就是说,上面方法中的参数可以不用担心。

    • 如果自定义的对象分为可变版本和不可变版本,那么就要同时实现NSCopying与NSMutableCopying协议。
     - [NSMutableArray copy] => NSArray
     - [NSArray mutableCopy] => NSMutableArray
    
    • 复制对象时需决定采用浅拷贝还是深拷贝,一般情况下应该尽量执行浅拷贝。


      浅拷贝与深拷贝对比图。浅拷贝之后的内容与原始内容均指向相同对象。而深拷贝之后的内容所指的对象是原始内容中相关对象的一份拷贝。
    • 如果你所写的对象需要深拷贝,那么可考虑新增一个专门执行深拷贝的方法。

    因为没有专门定义深拷贝的协议,所以具体执行的方式是每个类自己来确定的。在绝大多数的情况下,NSCopying执行的都是浅拷贝,除非该类的文档中说明了它是用深拷贝的,否则就寻找能够执行深拷贝的相关方法,或者自己编写方法来做。

    相关文章

      网友评论

        本文标题:编写高质量的iOS代码(五)

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