一种接地气的编码规则:废弃驼峰式命名,告别手敲基础代码。

一种好的编码规则,能提高工作效率。

在软件编程领域内,“驼峰”式命名规则是首选方式,最早来源于Perl语言编程的畅销书《program Perl》(oRelly出版)的封面图片正是一匹骆驼,故而得名。

但是这种命名规则是最不高效的方式,大小写问题就是因为这种命名规则导致的,有时还被带到沟里去了。所以并不被其他一部分程序员提倡,因为先发原因,所以被大部分公司和开发者使用,习惯的力量太强大了。

下面编码规则,在实践中证明,可以极大的提高效率:

变量名 废弃“驼峰”命名方式,**在能用小写的地方坚决不用大写**,解决大小写的烦扰。

严禁“缩没了”的方式的命名:比如:sgrj: 开工日期,应当命名为:startworkdate 或 kaigongriqi

一、最大可能地避免手敲代码,能极大地提高效率。

二、modle层的变量 完全以数据库表为参考物,提前检查表的字段注释不规范等。

三、在编辑器里对象名后 点号 弹窗里出来的get/set方法名全是小写的,一眼就知道是自己人的业务对象代码

废弃驼峰式的命名方式后,就很容易用某种自动化的脚本来生成基础代码了(见本文最后的用数据查询来实现的脚本)。如下面动图所示,能极大地提高工作效率。

一种是为了注释而注释, 不接地气;不方便代码阅读; 针对 这个弊端,本文建议一种新的编码注释风格。

左边为 不接地气的 代码注释 风格:每个字段类的变量,占据多行,各行间距都一样,没有 “组”的概念阅读代码时,需要鼠标滚屏,才能到达定位的字段上。

右边为 “接地气”的编码注释方式:每个字段类的变量,占据一行,注释用//方式写在最后,相关逻辑的变量字段写在一起,为一 “组”。几乎可以一屏展示所有的业务字段,无需鼠标滚屏;可以一目十行的扫视代码。

左右两种代码注释的编写方式对比

左边为 不接地气的 代码注释 风格每个字段类的变量,占据多行,各行间距都一样,没有 “组”的概念。阅读代码时,需要鼠标滚屏,才能到达定位的字段上。

右边为 “接地气”的编码注释方式每个字段类的变量占据一行,注释用直接复用ApiModelPeroperty里的描述,相关逻辑的变量字段写在一起,为一 “组”。几乎可以一屏展示所有的业务字段,无需鼠标滚屏。尤其在和其他部件联调时,非常方便,相关字段截图时可以在一屏里,发给对方参考。

左边为 不接地气的 方式,右边为接地气的方式

左边为 不接地气的 编写风格:一个条件里,占据几行,阅读时感觉太跳跃

右边为 “接地气”的编码方式:一个条件只占一行,阅读时可以一目十行的扫视,和阅读正常SQL没区别。

附件:(一种使用查询数据库的方式来生成基础代码),使用方式见上面的动图

本文为今日头条独家原创稿件。欢迎大家留言、点赞、分享、转发!

————结束————

一文搞懂蓝绿发布、灰度发布和滚动发布

应用程序升级面临最大挑战是新旧业务切换,将软件从测试的最后阶段带到生产环境,同时要保证系统不间断提供服务。

长期以来,业务升级渐渐形成了几个发布策略:蓝绿发布、灰度发布和滚动发布,目的是尽可能避免因发布导致的流量丢失或服务不可用问题。

一、 蓝绿发布

项目逻辑上分为AB组,在项目系统时,首先把A组从负载均衡中摘除,进行新版本的部署。B组仍然继续提供服务。

当A组升级完毕,负载均衡重新接入A组,再把B组从负载列表中摘除,进行新版本的部署。A组重新提供服务。

最后,B组也升级完成,负载均衡重新接入B组,此时,AB组版本都已经升级完成,并且都对外提供服务。

特点

  • 如果出问题,影响范围较大;
  • 发布策略简单;
  • 用户无感知,平滑过渡;
  • 升级/回滚速度快。

缺点

  • 需要准备正常业务使用资源的两倍以上服务器,防止升级期间单组无法承载业务突发;
  • 短时间内浪费一定资源成本;
  • 基础设施无改动,增大升级稳定性。

蓝绿发布在早期物理服务器时代,还是比较昂贵的,由于云计算普及,成本也大大降低。

二、 灰度发布

灰度发布只升级部分服务,即让一部分用户继续用老版本,一部分用户开始用新版本,如果用户对新版本没什么意见,那么逐步扩大范围,把所有用户都迁移到新版本上面来。

特点

  • 保证整体系统稳定性,在初始灰度的时候就可以发现、调整问题,影响范围可控;
  • 新功能逐步评估性能,稳定性和健康状况,如果出问题影响范围很小,相对用户体验也少;
  • 用户无感知,平滑过渡。

缺点

  • 自动化要求高

部署过程

  • 从LB摘掉灰度服务器,升级成功后再加入LB;
  • 少量用户流量到新版本;
  • 如果灰度服务器测试成功,升级剩余服务器。

灰度发布是通过切换线上并存版本之间的路由权重,逐步从一个版本切换为另一个版本的过程。

三、 滚动发布

滚动发布是指每次只升级一个或多个服务,升级完成后加入生产环境,不断执行这个过程,直到集群中的全部旧版本升级新版本。

  • 红色:正在更新的实例
  • 蓝色:更新完成并加入集群的实例
  • 绿色:正在运行的实例

特点

  • 用户无感知,平滑过渡;
  • 节约资源。

缺点

  • 部署时间慢,取决于每阶段更新时间;
  • 发布策略较复杂;
  • 无法确定OK的环境,不易回滚。

部署过程

  • 先升级1个副本,主要做部署验证;
  • 每次升级副本,自动从LB上摘掉,升级成功后自动加入集群;
  • 事先需要有自动更新策略,分为若干次,每次数量/百分比可配置;
  • 回滚是发布的逆过程,先从LB摘掉新版本,再升级老版本,这个过程一般时间比较长;
  • 自动化要求高。

小结

综上所述,三种方式均可以做到平滑式升级,在升级过程中服务仍然保持服务的连续性,升级对外界是无感知的。那生产上选择哪种部署方法最合适呢?这取决于哪种方法最适合你的业务和技术需求。如果你们运维自动化能力储备不够,肯定是越简单越好,建议蓝绿发布,如果业务对用户依赖很强,建议灰度发布。如果是K8S平台,滚动更新是现成的方案,建议先直接使用。

  • 蓝绿发布:两套环境交替升级,旧版本保留一定时间便于回滚。
  • 灰度发布:根据比例将老版本升级,例如80%用户访问是老版本,20%用户访问是新版本。
  • 滚动发布:按批次停止老版本实例,启动新版本实例。

本文作者及来源:Renderbus瑞云渲染农场https://www.renderbus.com

点赞 0
收藏 0

文章为作者独立观点不代本网立场,未经允许不得转载。