Android下如何优雅流畅地写代码

原创博客,如有转载,请注明出处,非常感谢。

首先说一下,灵感来自于RxAndroid,自从用上了这个库之后,整个思路都变了,原来异步还可以玩的这么溜,这还不是重点,重点是我学会了如何使写代码更加的流畅!

那么除了Rx的异步之外,我究竟学到了什么呢?对的,就是方法链(Method Chaining,或者叫Named method idiom)和方法参数尽可能少于等于1个,在链条的末端偶尔出现两三个参数还是可以接受的,这两个点让我从此代码风格完全变了,思路也完全变了!先举些例子:

  1. 当你设置全局配置的时候,可能会这样做,并且你一直认为,这样挺好,我也是一直这么认为的:
GlobalConfig.getInstance().setServerInfo("192.168.1.2", 65530, 5 * 60 * 1000, true);

这种风格对我来说,有两个问题,一直困扰我,但是我居然懒惰的没去想过解决这两个困扰我的问题,第一个问题是参数多,哪个对应哪个经常记不清楚,需要翻看方法的定义的位置看看,或者鼠标点在方法上,再按ctrl之类的一堆快捷键看看方法签名:

public void setServerInfo(String ip, int port, long heartBeatTime, boolean reconnectOnNetworkChange) {
        // code comes here
    }

哦,原来第一个参数是ip地址,第二个是端口,第三个是心跳包间隔,第四个是网络改变的时候是否重连,大家看到没?记忆力差那么一丁点的时候,必然在这样的方法调用时卡你一下,而我们的项目里面经常充满这种N个参数的方法,每天写代码就这样卡几次,谁来救救我?
第二个问题是总感觉有点问题,就像长城宽带看高清,总会卡你几帧,宽带你知道是网络问题,这个代码有什么问题还一时说不上来,长期习惯了也就觉得,卡一下是应该的,毕竟本人又不是清华北大的高才生,还不是计算机专业出身的,就像长城宽带看高清,你交的网费还不到电信的五分之一,偶尔卡一下也能接受。对于方法链,或者有人叫链式调用,我是一直知道的,并且也在用,各种Builder模式不就是经典的代表场景么?Hibernate不是这样的么?都习以为常了,要不是RxAndroid给我的震撼感觉,我绝对不会想到,上面的代码应该要重构优化的!!!现在我的调用变成了:

GlobalConfig
                .getInstance()
                .ip("192.168.1.2")
                .port(65530)
                .heartBeatTime(5 * 60 * 1000)
                .reconnectOnNetworkChange(true);

一下子就豁然开朗了,记忆力没有了负担,整个人都精神多了,腰也不酸腿也不疼,妈妈再也不用担心我没有名牌大学毕业了。怎么做到的呢?看重构后的代码(这里为了篇幅去掉了注释,不过方法名本身就已经非常好的注释自己了,可能这也是为什么方法链有人叫Named method idiom的原因吧):

public GlobalConfig ip(String ip) {
        this.ip = ip;
        return this;
    }

    public GlobalConfig port(int port) {
        this.port = port;
        return this;
    }

    public GlobalConfig heartBeatTime(long time) {
        this.heartBeatTime = time;
        return this;
    }

    public GlobalConfig reconnectOnNetworkChange(boolean reconn) {
        this.reconnectOnNetworkChange = reconn;
        return this;
    }

换个思维,生活就是这么幸福。

  1. 以下场景更常见,创建一个POJO对象,为对应的字段一一赋值,没有哪个场景比这个更常见更习以为常了吧?像这样:
User user = new User();
user.setName(name);
user.setAge(age);
user.setGender(gender);
// ... 省略更多
UserDao.getInstance().save(user);

有没有想过可以这样呢?

UserDao.getInstance()
       .save(
           User.newInstance()
               .setName(name)
               .setAge(age)
               .setGender(gender)
               // 省略更多
        );

对应的,在User这个类里,setter的方法变了,变成如下:

  public User setName(String name) {
      this.name = name;
      return this;
  }
  // 其他方法类似,略去,自行脑补

这时候估计你会跳出来说,我setter方法都是自动生成的,你这不是坑我么?生成setter之后,我还需要手工去改所有的setter,WTF!
等等,我有说这些代码是我手工写的么?Android Studio生成getter/setter的时候本身就自带这种实现,你不看怪我咯,看,连AS都觉得有必要提供这样的setter生成方式了,不用是不是有点浪费了呢?过程如下:

  1. 去到你需要生成getter/setter的类,注意了,操作跟以前是一样的,按ALT + Insert键,弹出菜单选择getter/setter
  2. 选择字段,在setter template那个框选择Builder,然后OK,完成了,生成的代码就是上面那种了
    以防说的不清楚,有图有真相:


    setter.png

    default.png

    builder.png

    对了,就是这样。

  1. 对于下面这种activity的跳转方法,大家都一致认为是比较不错的,至少,这是目前公认的做的比较合理的一种方式:
  // 这个方法是静态的,写在XXXActivity里,如果有多种跳转方式的,写多个类似的方法
   public static void startXXXActivity(Activity fromActivity, String articleId, String thumbImgUrl) {
      Intent in = new Intent(fromActivity, XXXActivity.class);
      in.putExtra("articleId", articleId);
      in.putExtra("thumbImgUrl", thumbImgUrl);
      fromActivity.startActivity(in);
  }

然后调用的时候就相对简单了:

  XXXActivity.startXXXActivity(this, "id123456", "http://www.example.com/example.png");

这里的问题跟第一个几乎是一模一样的,但是相对于第一种情况,这里复杂不止一点点,首先,这里有放进Intent的key要管理,如果很多activity用到的key都相同,该抽出来吗?好吧,key的问题不展开了。其次你没法getInstance(),XXXActivity还没创造出来呢,你怎么使用这个实例来创建方法链?即使你有办法做出方法链,那么多activity,你得写的多累啊,有了RxAndroid的启发,我现在是接受不了旧的启动方式了,怎么办?好的,我只好自己写了一个库,并且开源了,托管在github上:SmartKey,大家可以参考一下,如果觉得好请给个星星鼓励一下,如果大家有更好的实现,也请告诉我一声,让我开开眼界,提前谢谢大家。终于现在代码就成了:

SmartTargets.toXXXActivityATarget()
        .params(ParamsIBuilder
            .newBuilder()
            .articleId("id123456")
            .thumbImgUrl("http://www.example.com/example.png"))
        .go(this);

注意,这里SmartTargets类、ParamsIBuilder类都是自动生成的,你要做的就是在你的Application类告诉我,你的manifest文件在哪,然后把XXXActivity需要的所有参数,写一个叫做Params(名字随意,N个组件可以公用,只要是通过Bundle、Intent传递参数的都可以用)的非常简单的连getter/setter都省了的POJO用于描述参数,并且在XXXActivity里可以直接用这个Params类访问到传进来的参数,至于放进Intent的key,忘掉它吧,你放了参数进ParamsIBuilder,在目标Activity就能直接问ParamsIBuilder要回Params对象了,key的事情,还是不用管最好。关于这个库,我会再写两篇博客详细说一下,两篇文章题目都想好了,分别是:《原来Activity跳转还可以这么舒畅》和《如何优雅地管理SharedPreferences》,正在编写中。

好了,先写到这里,总结一下,从RxAndroid我学到的额外东西主要两个:

第一个是方法链,让你可以专心当前的流程,不再为每次从头写变量名等分心了,一直点到目的地,点到天荒地老,别看这么一点点变化,就像高手喜欢终端上做关键的事情一样,减少了例行性的参数名的编写就像使用终端减少了鼠标使用减少双手离开键盘一样,能极大的提高效率。

第二个是一个方法尽可能的接受更少量的参数,链条内尽可能保证少于等于一个参数,末端允许偶尔出现两个三个的参数,再多就要认真想想是不是哪里有问题了,这样可以让你的方法更语义化,方法内的职责也可以更加单一化了,这样可以极大减少记忆力的负担,不再需要以前那样经常翻看方法签名了,相当于家里的电缆换成了光纤,网络一下子流畅了,离准时下班又近一步了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,580评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,392评论 25 707
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,560评论 18 399
  • 从三月份找实习到现在,面了一些公司,挂了不少,但最终还是拿到小米、百度、阿里、京东、新浪、CVTE、乐视家的研发岗...
    时芥蓝阅读 42,169评论 11 349
  • 夜夜夜夜 不知这样多久了 换了工作之后忙碌了起来 这也是我想要的一种状态 忙点好,忙着忙着就会忘了孤独 好让自己不...
    闵大喵阅读 177评论 0 0