最近重温阿里巴巴Java开发手册这本书,思考了什么样的代码是好代码,给大家分享一下我的想法,有哪里不对,欢迎指出,感激不尽。
什么是好代码?实现了功能的代码只是合格的代码,而真正的好代码具有以下特点:
好的命名,命名易于理解,语义表达清晰。 是酝酿好代码的第一步。以下列举阿里JAVA开发手册的几点,都是在强调好的命名,以便于阅读。
抽象类命名使用 Abstract 或 Base 开头;异常类命名使用 Exception 结尾;测试类 命名以它要测试的类的名称开始,以 Test 结尾。
理由:大家约定俗成这样写,阅读者一看这个类就知道它是抽象类还是异常类,岂不美哉。
推荐指数:五星
理由:AbstractClass“缩写”命名成 AbsClass;condition“缩写”命名成 condi,此类随意缩写严重降低了代码的可阅读性
推荐指数:五星
正例:在 JDK 中,表达原子更新的类名为:AtomicReferenceFieldUpdater。
反例:变量 int a 的随意命名方式
理由:完整的单词,表达意思更清楚。
推荐指数:四星
正例:
public class OrderFactory; public class LoginProxy; public class ResourceObserver; 复制代码
理由:将设计模式体现在名字中,有利于阅读者快速理解架构设计理念。
推荐指数:四星
反例:
String key = "Id#taobao_" + tradeId; cache.put(key, value); 复制代码
理由:魔法值只有开发者自己知道,或者过一段时间他自己也不知道了。。。还谈何维护。。。
推荐指数:五星
正例:枚举名字为 ProcessStatusEnum 的成员名称:SUCCESS / UNKNOWN_REASON。
理由:枚举其实就是特殊的类,域成员均为常量,且构造方法被默认强制是私有。
推荐指数:三星
好的代码,还表现在清晰的结构,分明的层次,明了的逻辑。不仅表现在代码功能层明上,代码块、函数各司其职,符合设计模式设计理念,还表现在项目结构轮廓分明。列举了以下几点:
正例:缓存相关常量放在类 CacheConsts 下,系统配置相关常量放在类 ConfigConsts 下。
理由:大而全的常量类,杂乱无章,使用查找功能才能定位到修改的常量,不利于理解和维护。
推荐指数:四星
一个过于冗长的函数或者一段需要注释才能让人理解用途的代码,可以考虑把它切分成一个功能明确的函数单元,并定义清晰简短的函数名,这样会让代码变得更加优雅。
反例:
private String name; private Vector<Order> orders = new Vector<Order>(); public void printOwing() { //print banner System.out.println("****************"); System.out.println("*****customer Owes *****"); System.out.println("****************"); //calculate totalAmount Enumeration env = orders.elements(); double totalAmount = 0.0; while (env.hasMoreElements()) { Order order = (Order) env.nextElement(); totalAmount += order.getAmout(); } //print details System.out.println("name:" + name); System.out.println("amount:" + totalAmount); } 复制代码
正例:
private String name; private Vector<Order> orders = new Vector<Order>(); public void printOwing() { //print banner printBanner(); //calculate totalAmount double totalAmount = getTotalAmount(); //print details printDetail(totalAmount); } void printBanner(){ System.out.println("****************"); System.out.println("*****customer Owes *****"); System.out.println("****************"); } double getTotalAmount(){ Enumeration env = orders.elements(); double totalAmount = 0.0; while (env.hasMoreElements()) { Order order = (Order) env.nextElement(); totalAmount += order.getAmout(); } return totalAmount; } void printDetail(double totalAmount){ System.out.println("name:" + name); System.out.println("amount:" + totalAmount); } 复制代码
推荐指数:四星
比如:
int getArea() { switch (shape){ case SHAPE.CIRCLE: return 3.14 * _r * _r; break; case SHAPE.RECTANGEL; return width *,heigth; } } 复制代码
使用多态后:
class Shape { int getArea(){}; } class Circle extends Shape { int getArea() { return 3.14 * r * r; } } class Rectangel extends Shape { int getArea() { return width * heigth; } } 复制代码
推荐指数:三星
说明:如下为rocketMq源码项目结构图。
推荐指数:四星
优雅的代码格式,是使代码有个好看的皮囊,所以平时写代码注意用快捷键优化一下格式。
推荐指数:五星
反例:
if (空格 a == b 空格) 复制代码
推荐指数:五星
说明:任何情形,没有必要插入多个空行进行隔开。
推荐指数:四星
单单有好看的皮囊当然还是不够,还要持久实用呢,才能称得上好腰杆代码。阿里开发手册以下几点,都有助于提高代码性能。当然,除了这些,还有日常开发中,哪些代码流程是否可以优化,哪些接口是否调用多了,那些代码是不是没用到。总之,这个要看自己总结与积累。
说明:HashMap 使用 HashMap(int initialCapacity) 初始化。
正例:initialCapacity = (需要存储的元素个数 / 负载因子) + 1。注意负载因子(即loader factor)默认为 0.75,如果暂时无法确定初始值大小,请设置为 16(即默认值)。
反例:HashMap 需要放置 1024 个元素,由于没有设置容量初始大小,随着元素不断增加,容 量 7 次被迫扩大,resize 需要重建 hash 表,严重影响性能。
推荐指数:四星
说明:使用线程池的好处是减少在创建和销毁线程上所消耗的时间以及系统资源的开销,解决 资源不足的问题。如果不使用线程池,有可能造成系统创建大量同类线程而导致消耗完内存或 者“过度切换”的问题。
说明:以上几点,是针对代码块的性能优化。对于接口,跟SQL有关的话,考虑添加索引等手段,如果涉及大量数据,可以考虑分批思想,还可以考虑添加缓存,冷热数据区分等。
安全性对于好代码的判断标准,具有一票否决权。对于这一点,我们平时可以积累,避开以下一些雷区外,有时间可以看一些常用框架,中间件的源码,如rocketMq,sring,jdk源码等,学习里面一些写法,以及避开可能的坑。
正例: "test".equals(object);
反例: object.equals("test");
说明:推荐使用 java.util.Objects#equals
(JDK7 引入的工具类)
推荐指数:五星。
ArrayList的subList结果不可强转成ArrayList,否则会抛出ClassCastException 异常,即 java.util.RandomAccessSubList cannot be cast to java.util.ArrayList
理由:subList 返回的是 ArrayList 的内部类 SubList,并不是 ArrayList 而是 ArrayList 的一个视图,对于 SubList 子列表的所有操作最终会反映到原列表上
推荐指数:五星。
说明:忽略参数校验可能导致:
说明:Java 代码用正则来验证客户端的输入,有些正则写法验证普通用户输入没有问题, 但是如果攻击人员使用的是特殊构造的字符串来验证,有可能导致死循环的结果。
推荐指数:五星。
说明:newFixedThreadPool线程池可能导致的内存飙升问题,是因为它使用了无界队列。所以这些点需要我们积累以及看一下常用类的源码,如线程池,AQS等等。
推荐指数:三星。