一提起程序员,首先想到的一定是“码农”,对,我们是高产量的优质“码农”,我们拥有超跃常人的逻辑思维以及不走寻常路的分析、判别能力,当然,我们也有良好的编码规范,毕竟是靠代码来养家糊口,最怕半路接到一个项目或是项目增加新功能,发现之前写的注释非常不全,代码也非常的不整洁,有些地方写的‘’窝七八烂的,看着很不舒服。

代码编码规范的都会起到什么作用?

1、好的编码规范,可以减少一个软件的维护成本,并且几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护;

2、好的编码规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码;

3、好的编码规范可以最大限度的提高团队开发的合作效率;

4、长期的规范性编码还可以让开发人员养成好的编码习惯,甚至锻炼出更加严谨的思维;

高质量的Java代码是怎么练成的?

命名

一个错误的命名会很误导人,不良的命名,对于阅读代码的人来说很纠结。一个良好的命名对自己也有很大的帮助。

建议个人命名的变量长一些,一般用单词作为全称,这样代码读起来易懂,有些缩写根本不知道它代表的单词是什么,除了像id代表identifier,org代表organization这些大家常见的缩写命名。

命名一个方法的时候,最好能让大家见名知意,看到名字就能猜出你的功能,而不需要去看方法的注释,甚至是读源码来了解你的功能。

注释

写一个方法时可以先把这个方法的功能、算法原理交代一下,以后自己或者是其他人维护你的代码时就可以很方便,对于易出错的部分加注释提醒即可。

l  用class类型

写方法的时候的参数,少用基本类型的组合,而用class类型。

例如:

写一个查找用户的方法queryUser(int age)

最开始的业务需求是根据年龄来查找用户,后来业务规则发生了变化,你可能需要根据年龄和性别来查找用户,于是你又改成了这样queryUser(int age, intsex),假设用0代表男,1代表女(其实更好的实现是用枚举来表示男女);

说不定你哪天的业务又有变化了,需要根据年龄、性别、家庭住址来查询,于是乎你又改成了这样queryUser(int age, int sex, String address)。

如果你当时设计的方法是:queryUser(User user)传入的参数是一个User类呢,那该多好啊,你根本不需要改接口。

在实际项目开发中改一个接口的成本还是挺大的,实际项目开发中为了达到层次清晰、解耦的目的,后台分了好多层,action、business、dao其中dao还有分了dao接口和实现,一个接口修改得牵动多少地方。

而当初设计的接口传递的是User对象,那么你的代码可以简单的增加几行就能达到了目的,而不需要修改那么多的接口,一边修改一边纠结。

少复制、粘贴代码

同样的代码不要粘来粘去,当时写的时候确实是快了,可是以后需要修改的时候可就慢多了。

更可怕的是你要修改多处,结果你只修改了一处,而你自己却以为万事大吉了,说不定哪天就蹦出个bug来。应该把这些公共的代码提取成一个class或者是一个方法。

一个方法中不要写太多代码

一个方法中写好多代码,写的时候确实是很方便,很快,更好的办法是把一个大的方法分解成几个小的方法,然后在主方法中调用其他子方法。

如果把所有的逻辑都写在一个方法中,当需求发生变化的时候,再要修改那就慢多了。

一小段逻辑的代码可以提取出一个private方法,然后在一个方法中调用好几个私有的小方法。

这样读代码的人读起来也轻松,日后需求发生变化了,你的这些个小的逻辑代码块儿只要重新组合下,就又能满足新的功能,可以复用。

增加设计文档

增加一个新的功能模块时最好有个设计文档,先把方方面面都考虑周全了,设计好了再编码实现。

如果一开始就有个设计文档,能把方方面面都考虑周全,实现起来就容易多了,实现的代码还能优雅些。

为了达到最终的目的,可能中间要走些弯路,如果增加的功能多了,每次实现都走一些弯路,系统最终会变的臃肿不堪。

如果推倒重来,以前的功夫就都白费了,不光是编码,还有测试部门的测试,有时时间也不允许重构,再说了重构还有风险,这其中的代价还是挺大的。

所以新增功能一定要把需求搞清除,有个良好的设计文档,考虑周全了再编码实现。

最后在向SVN提交代码时先做个功能测试,然后没问题了,再做个codereview。

努力的人,老司机今天的忠告,你记住了吗?

老司机写的java代码_老司机告诉你高质量的Java代码是怎么练成的?相关推荐

  1. 高质量的工程代码为什么难写

    之所以想起写这篇文章,是因为最近看到的一个著名的开源项目在内部使用时的各种问题,不得不说,很多的开源的东西思想是不错的,但离真正工程化都有不小的距离,所以没什么商业公司采用的开源产品如果要引入的话一定 ...

  2. html空格代码_编写灵活、稳定、高质量的CSS代码的规范(推荐收藏)

    01 编写灵活.稳定.高质量的HTML代码的规范 一.唯一定律 无论有多少人共同参与同一项目,一定要确保每一行代码都像是唯一个人编写的. 二.HTML 2.1 语法 (1)用两个空格来代替制表符(ta ...

  3. ​如何编写高质量的C#代码(一)

    如何编写高质量的C#代码(一) 从"整洁代码"谈起 一千个读者,就有一千个哈姆雷特,代码质量也同样如此. 想必每一个对于代码有追求的开发者,对于"高质量"这个词 ...

  4. 如何编写高质量的C#代码(一)

    从"整洁代码"谈起 一千个读者,就有一千个哈姆雷特,代码质量也同样如此. 想必每一个对于代码有追求的开发者,对于"高质量"这个词,或多或少都有自己的一丝理解.当 ...

  5. HTML Inspector – 帮助你编写高质量的 HTML 代码

    HTML Inspector 是一款代码质量检测工具,帮助你编写更优秀的 HTML 代码.HTML Inspector 使用 JavaScript 编写,运行在浏览器中,是最好的 HTML 代码检测工 ...

  6. java入职写不出代码_各位程序员是怎么度过看懂代码但写不出来的时期?

    说实话,我自己就没经历过这样的时期. 说看得懂代码的,大概是很少看开源代码,想看懂不仅自己水平要过硬,还要花挺大的精力把前前后后的东西都做充分的研究. 我自己总是会有自己写一个功能很有思路,但是搞懂别 ...

  7. java 编写代码_如果您在2016年编写过Java代码-这是您不容错过的趋势

    java 编写代码 2016年最有趣的Java相关主题 关于代码,有很多热门话题,而要跟上所有事情,这是一项全职的工作. 如果您想知道如何从谷壳中分离出小麦,我们已经为您完成了工作. 在下面的文章中, ...

  8. jtest java 代码_使用Jtest:一款优秀的 Java 代码优化和测试工具

    2.file>new>Project>Jtest>Create Project Specifying Source Folders. 这种方式允许开发测试人员自定义代码层次结构 ...

  9. 如何才能写出一手高质量优美的代码

    怎么判断代码是否是优质量的代码呢?下面来简单对代码质量的问题进行一个介绍. 代码质量所涉及的5个方面,编码标准.代码重复.代码覆盖率.依赖项分析.复杂度分析.我们分别来看一下这5方面: 编码标准:一般 ...

最新文章

  1. LibTorch NMS
  2. SCOI2019AFO记
  3. OSPF身份验证配置实例
  4. 利用HttpClient 获取网页数据java代码模版
  5. 设计模式之静态代理模式实战
  6. 八位图 16位图_了解位图
  7. 3行代码实现ftp 上传、下载、删除操作集合
  8. Zookeeper与Kafka集群搭建
  9. PHP curl传输文件的版本兼容性
  10. java 求高精度幂_POJ 1001 求高精度幂【JAVA】
  11. 【2019百度之星初赛三1002=HDU6714】最短路 2(spfa+思维)
  12. injectcheck php_php简单实现sql防注入的方法
  13. CSS3 3D旋转魔方
  14. pythonqq机器人酷q_NoneBot+酷Q,打造QQ机器人
  15. Stata: 断点回归(RDD)中的近似置换检验和伴随次序统计简介
  16. 入侵检测系统,浅析几个著名的入侵检测系统
  17. HDU 1275 两车追及或相遇问题(相遇和追及公式)
  18. 一行代码显示WiFi密码
  19. php获取这星期几,php如何获取星期几
  20. Android----banner使用详解

热门文章

  1. 冯·诺依曼体系结构是什么
  2. cobalt strike各种beacon的详解(http/https/tcp)
  3. 关于bin目录下各文件的意义及使用方法
  4. 区块链的安全软肋都有什么
  5. 中国储能行业市场“十四五”规划分析与未来战略建议报告2022-2028年版
  6. Oracle 查看 SQL执行计划
  7. “神童”Tom Ding:区块链是下一代云计算和互联网的基础
  8. 星淘惠:做跨境电商为什么要选择亚马逊?
  9. 基于51单片机和OLED屏幕的贪吃蛇游戏
  10. 自己用的感觉很好的C++IDE推荐