美文网首页
OC好坏函数

OC好坏函数

作者: 巴糖 | 来源:发表于2016-09-23 10:40 被阅读11次

    不用文档,或很少文档,就能让业务方上手

    谁特么会去看文档啊,业务方他们已经被产品经理逼得很忙了。

    所以你要尽可能让你的API名字可读性强,对于iOS来说,objc这门语言的特性把这个做到了极致,函数名长就长一点,不要紧。

    // 好的函数名:
    - (NSDictionary *)exifDataOfImage:(UIImage *)image atIndexPath:(NSIndexPath *)indexPath;
    
    // 坏的函数名:
    - (id)exifData:(UIImage *)image position:(id)indexPath callback:(id<ErrorDelegate>)delegate;
    

    为什么坏?

    1. 不要直接返回id或者传入id,实在不行,用id<protocol>也比id好。如果连这个都做不到,你要好好考虑你的架构是不是有问题。
    2. 要告知业务方要传的东西是什么,比如要传Image,那就写上ofImage。如果要传位置,那就要写上IndexPath,而不是用position这么笼统的东西
    3. 没有任何理由要把delegate作为参数传进去,一定不会有任何情况不得不这么做的。而且delegate这个参数根本不是这个函数要解决的问题的充要条件,如果你发现你不得不这么做,那一定是架构有问题!

    相关文章

      网友评论

          本文标题:OC好坏函数

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